Nombres de recursos

Jerarquía de nombres

Los nombres de recursos usados en la API de Google Ads son jerárquicos, lo cual refleja la organización de entidades dentro de Google Ads. 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 Google Ads. 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 Google Ads (clientes, campañas, etc.) se denominan por sus nombres de recurso 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 a cada objeto de 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 los ID de recursos individuales (separados por ID 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 colecciones
"customers"
"adGroupAds"

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

Identificadores de objetos compartidos

La mayoría de los objetos en la API están asociados con un único cliente de Google Ads específico. Sin embargo, existen algunos tipos de objetos que se pueden compartir entre varias cuentas. En la práctica, son listas de palabras clave negativas o acciones de conversión de múltiples cuentas que suelen crear los administradores y, luego, compartirlas con muchas cuentas de cliente.

Los nombres de recursos de objetos como estos diferirán según la cuenta a la que envíes una llamada a la API.

Ejemplo: Acciones de conversión de múltiples cuentas

Supongamos que tenemos una cuenta de administrador 987-654-3210 que comparte una acción de conversión de múltiples cuentas con una de sus cuentas de cliente 123-456-7890:

Diagrama en el que se muestra la relación de los nombres de recursos con las jerarquías de cuentas.

Si se realiza una llamada a la API a la cuenta de administrador para, por ejemplo, actualizar la ventana de visualización de la acción de conversión, se haría referencia al objeto compartido mediante el nombre del recurso customers/9876543210/conversionActions/257733534.

Si realizas una llamada a la API a la cuenta de cliente para habilitar el uso de la acción de conversión compartida, se haría referencia a ella con el nombre de recurso: customers/1234567890/conversionActions/257733534.

Esta es la misma acción de conversión subyacente, pero su nombre de recurso está relacionado con la cuenta que se usa para acceder a ella.