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.
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:
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:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Ú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). |"]]
