Jerarquía de nombres
Los nombres de los recursos que se usan en la API de Google Ads son jerárquicos y reflejan la organización de las 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 de Google Ads específica. 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 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.
Identificadores de objetos compartidos
La mayoría de los objetos de la API están asociados con un único cliente específico de Google Ads. Sin embargo, hay algunos tipos de objetos que pueden compartirse entre varias cuentas. En la práctica, son listas de palabras clave negativas o acciones de conversión de múltiples cuentas que, por lo general, los administradores crean y, luego, comparten con muchas cuentas de cliente.
Los nombres de los recursos de objetos como estos diferirán según la cuenta a la que envíes la 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
:
Si se hace una llamada a la API a la cuenta de administrador, por ejemplo, para actualizar la ventana de visualización de la acción de conversión, se haría referencia al objeto compartido con el nombre de 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á referencia a ella con el nombre del recurso: customers/1234567890/conversionActions/257733534
.
Esta es la misma acción de conversión subyacente, pero el nombre de su recurso es relativo a la cuenta que se usó para acceder a ella.