Nombres de recursos

Jerarquía de nombres

Los nombres de recursos que se usan en la API de Search Ads 360 Reporting son jerárquicos y reflejan la organización de las entidades dentro de Search Ads 360. Casi todos los recursos son subrecursos del Customer recurso, lo que refleja el hecho de que casi todas las llamadas a la API deben segmentarse 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 mencionan por sus nombres de recursos en toda la API. Sin embargo, es importante tener en cuenta que los nombres de 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 estos IDs de recursos y ensamblar uno nuevo.

Por ejemplo, examina el nombre del recurso AdGroupAd de la tabla anterior:

customers/1234567890/adGroupAds/54321098765~2109876543210

Esto se puede dividir en sus IDs de recursos individuales (separados por IDs de colección) de la siguiente manera:

Componentes del nombre del recurso
IDs de recursos
ID de cliente:
"1234567890"
ID del grupo de anuncios:
"54321098765"
ID del anuncio del grupo de anuncios:
"2109876543210"
IDs de colección
"customers"
"adGroupAds"

El análisis de los IDs individuales te permite obtener nombres de recursos nuevos para hacer referencia al cliente del anuncio del grupo de anuncios (customers/1234567890) o a su grupo de anuncios (customers/1234567890/adGroupAds/54321098765).