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.
Để gọi dịch vụ này, bạn nên sử dụng thư viện ứng dụng do Google cung cấp. Nếu ứng dụng của bạn cần sử dụng thư viện của riêng bạn để gọi dịch vụ này, hãy sử dụng thông tin sau đây khi đưa ra yêu cầu API.
Tài liệu khám phá
Tài liệu khám phá là thông số kỹ thuật mà máy có thể đọc được để mô tả và sử dụng các API REST. Thư viện này được dùng để xây dựng thư viện ứng dụng, trình bổ trợ IDE và các công cụ khác tương tác với các API của Google. Một dịch vụ có thể cung cấp nhiều tài liệu khám phá. Dịch vụ này cung cấp tài liệu khám phá sau đây:
Điểm cuối dịch vụ là một URL cơ sở chỉ định địa chỉ mạng của một dịch vụ API. Một dịch vụ có thể có nhiều điểm cuối dịch vụ. Dịch vụ này có điểm cuối của dịch vụ sau đây và tất cả URI bên dưới đều liên quan đến điểm cuối của dịch vụ này:
[[["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-07-25 UTC."],[[["\u003cp\u003eThe Search Ads 360 API enables developers to automate report downloads from Search Ads 360.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use Google-provided client libraries or their own libraries to interact with the API.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides access to various resources such as customers, custom columns, and Search Ads 360 data.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve data using methods like \u003ccode\u003elistAccessibleCustomers\u003c/code\u003e, \u003ccode\u003esearch\u003c/code\u003e, and \u003ccode\u003esearchStream\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDetailed information about API resources and methods is available through the provided links and discovery document.\u003c/p\u003e\n"]]],["The Search Ads 360 API enables automated report downloading, utilizing `searchads360.googleapis.com`. Key actions include: retrieving accessible customer resource names via `listAccessibleCustomers`; getting detailed custom columns with `get` and `list`; searching for rows matching queries through `search` and `searchStream`; and fetching field details via `get` and `search`. It is recommended that developers use Google-provided client libraries, or utilize the specified discovery document and service endpoint for custom libraries.\n"],null,["# Search Ads 360 Reporting API\n\nThe Search Ads 360 API allows developers to automate downloading reports from Search Ads 360.\n\n- [REST Resource: v0.customers](#v0.customers)\n- [REST Resource: v0.customers.customColumns](#v0.customers.customColumns)\n- [REST Resource: v0.customers.searchAds360](#v0.customers.searchAds360)\n- [REST Resource: v0.searchAds360Fields](#v0.searchAds360Fields)\n\nService: searchads360.googleapis.com\n------------------------------------\n\nTo call this service, we recommend that you use the Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to use your own libraries to call this service, use the following information when you make the API requests.\n\n### Discovery document\n\nA [Discovery Document](https://developers.google.com/discovery/v1/reference/apis) is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:\n\n- \u003chttps://searchads360.googleapis.com/$discovery/rest?version=v0\u003e\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:\n\n- `https://searchads360.googleapis.com`\n\nREST Resource: [v0.customers](/search-ads/reporting/api/reference/rest/v0/customers)\n------------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|\n| [listAccessibleCustomers](/search-ads/reporting/api/reference/rest/v0/customers/listAccessibleCustomers) | `GET /v0/customers:listAccessibleCustomers` Returns resource names of customers directly accessible by the user authenticating the call. |\n\nREST Resource: [v0.customers.customColumns](/search-ads/reporting/api/reference/rest/v0/customers.customColumns)\n----------------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------|\n| [get](/search-ads/reporting/api/reference/rest/v0/customers.customColumns/get) | `GET /v0/{resourceName=customers/*/customColumns/*}` Returns the requested custom column in full detail. |\n| [list](/search-ads/reporting/api/reference/rest/v0/customers.customColumns/list) | `GET /v0/customers/{customerId}/customColumns` Returns all the custom columns associated with the customer in full detail. |\n\nREST Resource: [v0.customers.searchAds360](/search-ads/reporting/api/reference/rest/v0/customers.searchAds360)\n--------------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|-------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------|\n| [search](/search-ads/reporting/api/reference/rest/v0/customers.searchAds360/search) | `POST /v0/customers/{customerId}/searchAds360:search` Returns all rows that match the search query. |\n| [searchStream](/search-ads/reporting/api/reference/rest/v0/customers.searchAds360/searchStream) | `POST /v0/customers/{customerId}/searchAds360:searchStream` Returns all rows that match the search stream query. |\n\nREST Resource: [v0.searchAds360Fields](/search-ads/reporting/api/reference/rest/v0/searchAds360Fields)\n------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|---------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [get](/search-ads/reporting/api/reference/rest/v0/searchAds360Fields/get) | `GET /v0/{resourceName=searchAds360Fields/*}` Returns just the requested field. |\n| [search](/search-ads/reporting/api/reference/rest/v0/searchAds360Fields/search) | `POST /v0/searchAds360Fields:search` Returns all fields that match the search [query](/search-ads/reporting/concepts/field-service#use_a_query_to_get_field_details). |"]]
