Jerarquía de nombres
Los nombres de recursos que se usan en la API de Google Ads son jerárquicos, es decir, reflejan el
organización de entidades en Google Ads. Casi todos los recursos son subrecursos
de Customer
recurso, lo que refleja el hecho de que casi todas las llamadas a la API deben orientarse a un
cuenta de Google Ads específica. Por ejemplo, campañas, grupos de anuncios, anuncios y palabras clave
son todos subrecursos de un recurso de cliente raíz.
| 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
Las entidades de Google Ads (clientes, campañas, etc.) se refieren a las entidades de Google Ads por su recurso. en toda la API. Sin embargo, es importante mencionar que el recurso los mismos nombres pueden tener recursos numéricos únicos IDs que identifican cada objeto de la jerarquía. En estos casos, puede ser útil analizar los el nombre del recurso para extraer estos IDs del recurso 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 de los nombres de recursos | |||||||
|---|---|---|---|---|---|---|---|
| ID de recursos |
|
||||||
| IDs de colecciones |
|
||||||
Analizar los IDs individuales te permite derivar nuevos nombres de recursos para hacer referencia
el cliente (customers/1234567890) del anuncio del grupo de anuncios o su grupo de anuncios
(customers/1234567890/adGroupAds/54321098765)
Identificadores de objetos compartidos
La mayoría de los objetos de la API están asociados a un único producto de Google Ads cliente. Sin embargo, hay algunos tipos de objetos que se pueden compartir múltiples cuentas. En la práctica, estos son elementos como palabras clave negativas listas o en múltiples cuentas acciones de conversión que suelen crear los administradores y, luego, se comparten con muchas cuentas de cliente.
Los nombres de los recursos de objetos como estos diferirán según el cuenta a la que envías 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 varias cuentas
acción de conversión con una de sus cuentas de cliente 123-456-7890:
Realizar una llamada a la API a la cuenta de administrador para, por ejemplo, actualizar la conversión
la ventana de visualización de la acción haría referencia al objeto compartido usando el nombre del recurso:
customers/9876543210/conversionActions/257733534
Realizar una llamada a la API a la cuenta de cliente para habilitar el uso de la
la acción de conversión la haría referencia con el nombre del recurso:
customers/1234567890/conversionActions/257733534
Esta es la misma acción de conversión subyacente, pero el nombre del recurso es relativo a la cuenta utilizada para acceder a él.