The new Search Ads 360 Reporting API is now available. Join the searchads-api-announcements Google group to stay up to date on upcoming enhancements and releases.
To call this service, we recommend that you use the Google-provided client libraries. If your application needs to use your own libraries to call this service, use the following information when you make the API requests.
Discovery document
A Discovery Document 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:
A 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:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-04-02 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). |"]]
