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.
Formatos na API Search Ads 360 Reporting
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O formato da solicitação depende do tipo de solicitação.
Pesquisar
É possível personalizar a saída da pesquisa definindo uma consulta de pesquisa
de acordo com suas necessidades. A linguagem de consulta do Search Ads 360 permite pesquisar todos os recursos para encontrar uma lista de entidades que correspondem a um conjunto específico de critérios. Todas as solicitações, independente do tipo de entidade, são feitas com base no SearchAds360Service. Consulte Criar relatórios de pesquisa e Linguagem de consulta do Search Ads 360 para saber mais.
Os campos preenchidos na resposta dependem do serviço que você usa:
SearchAds360Service- A resposta inclui um objeto
SearchAds360Row para cada entidade que
corresponde aos parâmetros de pesquisa. Cada linha contém um objeto, por exemplo, uma campanha, e inclui somente os campos que você solicita na consulta.
- Serviços específicos
- Só é possível solicitar uma entidade por vez pelo nome do recurso. A resposta
inclui todos os campos dessa entidade.
Na nova API, é necessário especificar o ID do cliente como um número de 10 dígitos
(XXXXXXXXXX) sem traços.
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-08-29 UTC.
[null,null,["Última atualização 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."]]
