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 segmentarse para 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 raíz del cliente.
| Recurso | Nombre del recurso |
|---|---|
| Cliente | customers/1234567890
|
| Campaña | customers/1234567890/campaigns/8765432109
|
| Grupo de anuncios | customers/1234567890/adGroups/54321098765
|
| AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
IDs de recursos
En la API de informes de Search Ads 360, se hace referencia a las entidades (clientes, campañas, etcétera) por sus nombres de recursos. Sin embargo, es importante tener en cuenta que los nombres de los recursos pueden tener IDs de recursos numéricos únicos que identifican a cada objeto en la jerarquía. En estos casos, puede ser útil analizar el nombre del recurso para extraer estos 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 sus IDs de recursos individuales (separados por IDs de colección) de la siguiente manera:
| Componentes del nombre del recurso | |||||||
|---|---|---|---|---|---|---|---|
| ID de recursos |
|
||||||
| IDs de colección |
|
||||||
El análisis de los IDs individuales te permite obtener nombres de recursos nuevos para hacer referencia al cliente (customers/1234567890) o al grupo de anuncios (customers/1234567890/adGroupAds/54321098765) del anuncio del grupo de anuncios.