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.
| Recurso | Nome do recurso |
|---|---|
| Cliente | customers/1234567890
|
| Campaign | customers/1234567890/campaigns/8765432109
|
| Grupo de anúncios | customers/1234567890/adGroups/54321098765
|
| AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
IDs de recursos
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 recursos 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:
customers/1234567890/adGroupAds/54321098765~2109876543210
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 |
|
||||||
| IDs de coleções |
|
||||||
Analisar os IDs individuais permite derivar novos nomes de recursos para fazer referência ao cliente (customers/1234567890) ou ao grupo de anúncios (customers/1234567890/adGroupAds/54321098765) do anúncio do grupo de anúncios.