Jerarquía de nombres
Los nombres de los recursos que se usan en la API de Search Ads 360 Reporting son jerárquicos y reflejan la organización de las entidades en Search Ads 360. Casi todos los recursos son subrecursos del recurso Customer, lo que refleja el hecho de que casi todas las llamadas a la API deben orientarse a una cuenta específica de Search Ads 360. Por ejemplo, las campañas, los grupos de anuncios, los anuncios y las palabras clave son subrecursos de un recurso de cliente raíz.
| Recurso | Nombre del recurso |
|---|---|
| Cliente | customers/1234567890
|
| Campaña | customers/1234567890/campaigns/8765432109
|
| AdGroup | customers/1234567890/adGroups/54321098765
|
| AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
IDs de recursos
Las entidades de la API de Search Ads 360 Reporting (clientes, campañas, etc.) se denominan por sus nombres de recursos en toda la API. Sin embargo, es importante tener en cuenta que los nombres de los recursos pueden tener IDs de recursos numéricos únicos que identifican cada objeto en la jerarquía. En estos casos, puede ser útil analizar el nombre del recurso para extraer los IDs de recursos y crear uno nuevo.
Por ejemplo, examina el nombre del recurso AdGroupAd de la tabla anterior:
customers/1234567890/adGroupAds/54321098765~2109876543210
Esto se puede desglosar en los IDs de recursos individuales (separados por ID de colección) de la siguiente manera:
| Componentes de los nombres de recursos | |||||||
|---|---|---|---|---|---|---|---|
| ID de recursos |
|
||||||
| IDs de colecciones |
|
||||||
Analizar los ID individuales te permite derivar nuevos nombres de recursos para hacer referencia al cliente del anuncio (customers/1234567890) o a su grupo de anuncios (customers/1234567890/adGroupAds/54321098765) del grupo de anuncios.