A nova API Search Ads 360 Reporting já está disponível. Participe do grupo do Google
searchads-api-announcements para ficar por dentro das próximas melhorias e versões.
Search Ads 360 Reporting API
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Com a API Search Ads 360, os desenvolvedores podem automatizar o download de relatórios do Search Ads 360.
Serviço: searchads360.googleapis.com
Para chamar esse serviço, recomendamos que você use as bibliotecas de cliente fornecidas pelo Google. Caso seu aplicativo precise usar suas próprias bibliotecas para chamar esse serviço, use as informações a seguir quando fizer as solicitações da API.
Documento de descoberta
Um Documento de descoberta é uma especificação legível por máquina para descrever e consumir APIs REST. Ele é usado para criar bibliotecas de cliente, plug-ins IDE e outras ferramentas que interagem com as APIs do Google. Um serviço pode fornecer vários documentos de descoberta. O serviço fornece o seguinte documento de detecção:
Endpoint de serviço
Um endpoint de serviço é um URL base que especifica o endereço de rede de um serviço de API. Um serviço pode ter vários endpoints de serviço. Este serviço tem o endpoint a seguir e todos os URIs abaixo são relativos a ele:
https://searchads360.googleapis.com
| Métodos |
listAccessibleCustomers |
GET /v0/customers:listAccessibleCustomers
Retorna nomes de recursos de clientes diretamente acessíveis pelo usuário que autentica a chamada. |
| Métodos |
get |
GET /v0/{resourceName=customers/*/customColumns/*}
Retorna a coluna personalizada solicitada com todos os detalhes. |
list |
GET /v0/customers/{customerId}/customColumns
Retorna todas as colunas personalizadas associadas ao cliente com todos os detalhes. |
| Métodos |
search |
POST /v0/customers/{customerId}/searchAds360:search
Retorna todas as linhas que correspondem à consulta de pesquisa. |
searchStream |
POST /v0/customers/{customerId}/searchAds360:searchStream
Retorna todas as linhas que correspondem à consulta do fluxo de pesquisa. |
| Métodos |
get |
GET /v0/{resourceName=searchAds360Fields/*}
Retorna apenas o campo solicitado. |
search |
POST /v0/searchAds360Fields:search
Retorna todos os campos que correspondem à consulta de pesquisa. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 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). |"]]
