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.
O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.
Design da interface REST
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-08-29 UTC."],[],["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"]]
