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.
Hierarquia de nomes
Os nomes de recursos usados na API Search Ads 360 Reporting são hierárquicos, refletindo a organização de entidades no Search Ads 360. Quase todos os recursos são subrecursos
do recurso Customer, o que reflete o fato de que quase todas as chamadas de API precisam segmentar uma
conta específica do Search Ads 360. Por exemplo, campanhas, grupos de anúncios, anúncios e palavras-chave
são subrecursos de um recurso raiz do cliente.
As entidades da API Search Ads 360 Reporting (clientes, campanhas etc.) são referidas pelos nomes de recursos em toda a API. No entanto, é importante observar que os nomes
dos recursos podem ter IDs de
recurso numéricos exclusivos que identificam
cada objeto na hierarquia. Nesses casos, pode ser útil analisar o
nome do recurso para extrair esses IDs e montar um novo.
Por exemplo, examine o nome do recurso AdGroupAd da tabela anterior:
Isso pode ser dividido em IDs de recursos individuais (separados por
IDs de coleção)
da seguinte maneira:
Componentes do nome do recurso
IDs de recursos
ID do cliente:
"1234567890"
ID do grupo de anúncios:
"54321098765"
ID do anúncio do grupo de anúncios:
"2109876543210"
IDs da coleção
"customers"
"adGroupAds"
A análise dos IDs individuais permite derivar novos nomes de recursos para referenciar o cliente do grupo de anúncios (customers/1234567890) ou o grupo de anúncios (customers/1234567890/adGroupAds/54321098765).
[[["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-09-26 UTC."],[],["The Search Ads 360 Reporting API uses a hierarchical structure for resource names, with most resources being sub-resources of the `Customer`. Each resource has a unique numerical ID within its resource name. Resource names are relative and can be parsed to extract these IDs. These IDs allow for the derivation of new resource names, referencing parent entities, like the customer or ad group. The `resourceName` field, not `name`, is used in JSON bodies.\n"]]
