API Báo cáo Search Ads 360 mới hiện đã ra mắt. Tham gia nhóm Google searchads-api-announcements để luôn được cập nhật về những cải tiến và bản phát hành sắp tới.
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Định dạng yêu cầu
Định dạng yêu cầu phụ thuộc vào loại yêu cầu mà bạn đưa ra.
Tìm kiếm
Bạn có thể tuỳ chỉnh kết quả tìm kiếm bằng cách xác định cụm từ tìm kiếm phù hợp với nhu cầu của mình. Ngôn ngữ truy vấn Search Ads 360 cho phép bạn tìm kiếm tất cả tài nguyên để tìm danh sách các thực thể khớp với một bộ tiêu chí cụ thể. Tất cả các yêu cầu, bất kể loại thực thể, đều được thực hiện đối với SearchAds360Service. Hãy xem bài viết Tạo báo cáo tìm kiếm và Ngôn ngữ truy vấn Search Ads 360 để tìm hiểu thêm.
Định dạng phản hồi
Các trường được điền trong phản hồi tuỳ thuộc vào dịch vụ bạn sử dụng:
Phản hồi bao gồm một đối tượng SearchAds360Row cho mỗi thực thể khớp với các thông số tìm kiếm của bạn. Mỗi hàng chứa một đối tượng, chẳng hạn như một chiến dịch và chỉ bao gồm các trường mà bạn yêu cầu trong truy vấn.
Dịch vụ cụ thể
Mỗi lần, bạn chỉ có thể yêu cầu một thực thể theo tên tài nguyên. Phản hồi bao gồm tất cả trường cho thực thể đó.
Định dạng mã khách hàng
Trong API mới, bạn phải chỉ định Mã khách hàng dưới dạng số gồm 10 chữ số (XXXXXXXXXX) không có dấu gạch ngang.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-08-29 UTC."],[[["\u003cp\u003eSearch Ads 360 API request formats vary depending on whether you're searching or requesting specific entities.\u003c/p\u003e\n"],["\u003cp\u003eSearches utilize the Search Ads 360 Query Language and the \u003ccode\u003eSearchAds360Service\u003c/code\u003e for customized results.\u003c/p\u003e\n"],["\u003cp\u003eResponses from \u003ccode\u003eSearchAds360Service\u003c/code\u003e include a \u003ccode\u003eSearchAds360Row\u003c/code\u003e for each matching entity, containing only the requested fields.\u003c/p\u003e\n"],["\u003cp\u003eRequests for specific entities return all fields for that entity, and customer IDs must be provided as 10-digit numbers without dashes.\u003c/p\u003e\n"]]],["Search requests utilize the Search Ads 360 Query Language against the `SearchAds360Service` to retrieve entities matching specific criteria. Responses from `SearchAds360Service` return `SearchAds360Row` objects, including only requested fields. Specific service requests retrieve one entity by resource name, returning all its fields. The Customer ID in the API must be a 10-digit number without dashes. The user can use the \"Create search reports\" or \"Search Ads 360 Query Language\" to learn more.\n"],null,["# Formats in the Search Ads 360 Reporting API\n\nRequest format\n--------------\n\nThe request format depends on the type of request you make.\n\n### Search\n\nYou can customize your search output by defining a search query\nto suit your needs. The Search Ads 360 Query Language allows you to search all\nresources for a list of entities that match a specific set of criteria. All\nrequests, regardless of the entity type, are made against the\n[`SearchAds360Service`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.services#searchads360service). See [Create search reports](/search-ads/reporting/concepts/search-reports) and\n[Search Ads 360 Query Language](/search-ads/reporting/query/query-language)\nto learn more.\n\nResponse format\n---------------\n\nThe fields populated in the response depend on the service you use:\n\n[`SearchAds360Service`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.services#searchads360service)\n: The response includes one [`SearchAds360Row`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.services#searchads360row) object for each entity that\n matches your search parameters. Each row contains one object, for example, a\n campaign, and includes *only* the fields you request in your query.\n\nSpecific services\n: You can only request one entity at a time by resource name. The response\n includes *all* fields for that entity.\n\nCustomer ID format\n------------------\n\nIn the new API, you must specify your Customer ID as a 10-digit number\n(`XXXXXXXXXX`) without dashes."]]
