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.
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Esta página pressupõe que você já conhece os guias para desenvolvedores Design orientado a recursos e Nomes de recursos e os complementa com detalhes específicos de implementação da API Search Ads 360 Reporting.
Design voltado a recursos
Geralmente, a API Search Ads 360 Reporting segue um design orientado a recursos, modelado como coleções de recursos endereçáveis individualmente (os substantivos da API).
Os recursos são referenciados pelos respectivos nomes e manipulados usando um pequeno
conjunto de métodos (também conhecidos como verbos ou operações).
Esses nomes de recursos e métodos, combinados com um prefixo de versão da API específico, formam os URLs da interface REST.
Por exemplo, o URL abaixo pode ser dividido nesses componentes individuais
de acordo com a tabela a seguir:
Todos os URLs REST de uma versão específica da API (por exemplo, v0)
compartilham um prefixo de versão da API comum. O nome e o método do recurso juntos
identificam qual serviço da API está sendo chamado.
A API Search Ads 360 Reporting usa muitos métodos personalizados, ao contrário da maioria
das APIs REST tradicionais, que usam métodos REST padrão, como list e get. A API Search Ads 360 Reporting inclui dois métodos personalizados: search e searchStream.
[[["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-05-08 UTC."],[[["The Search Ads 360 Reporting API uses a resource-oriented design, where data is organized into collections of resources that can be accessed and manipulated."],["The API primarily uses custom methods like `search` and `searchStream` instead of traditional REST methods."],["API endpoints are constructed using an API version prefix, resource name, and method, which are detailed further in linked documentation."],["The guide's examples demonstrate API calls using HTTP, with further instructions available for using the `curl` command-line utility."],["Developers should be familiar with Resource Oriented Design and Resource Names before using this API."]]],["The Search Ads 360 Reporting API uses a resource-oriented design with collections of resources accessed via resource names. API calls use HTTP protocol and are structured with a version prefix, resource name, and method. This API primarily employs custom methods, specifically `search` and `searchStream`, instead of standard REST methods. URLs are constructed using the version prefix (e.g., `v0`), a resource name, and a method, defining the specific API service. Further details are available on resource names, service methods, and JSON conventions.\n"]]