Jerarquía de nombres
Los nombres de recursos que se usan en la API de Google Ads son jerárquicos y reflejan la organización de las entidades en Google Ads. Casi todos los recursos son subrecursos del recurso Customer, lo cual 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 raíz de cliente.
| Recurso | Nombre del recurso |
|---|---|
| Cliente | customers/1234567890
|
| Campaña | customers/1234567890/campaigns/8765432109
|
| AdGroup | customers/1234567890/adGroups/54321098765
|
| Anuncio del grupo de anuncios | customers/1234567890/adGroupAds/54321098765~2109876543210
|
ID de recursos
Se hace referencia a las entidades de Google Ads (clientes, campañas, etc.) por sus nombres de recursos en toda la API. Sin embargo, es importante tener en cuenta que los nombres de los recursos pueden tener ID de recursos únicos que identifican a cada objeto en la jerarquía. En estos casos, puede ser útil analizar el nombre del recurso para extraer estos ID de recursos y ensamblar uno nuevo.
Por ejemplo, examina el nombre del recurso AdGroupAd de la tabla anterior:
customers/1234567890/adGroupAds/54321098765~2109876543210
Puedes desglosar sus ID de recursos individuales (separados por ID de colección) de la siguiente manera:
| Componentes del nombre del recurso | |||||||
|---|---|---|---|---|---|---|---|
| ID de recursos |
|
||||||
| ID de colecciones |
|
||||||
Analizar los ID individuales te permite derivar 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).
Identificadores de objetos compartidos
La mayoría de los objetos en la API están asociados con un solo cliente específico de Google Ads. Sin embargo, hay algunos tipos de objetos que se pueden compartir entre varias cuentas. En la práctica, estas son elementos como las listas de palabras clave negativas o las acciones de conversión de múltiples cuentas que suelen crear los administradores y, luego, compartir con muchas cuentas de cliente.
Los nombres de los recursos de objetos como estos variará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
Realizar 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, haría referencia al objeto compartido con el nombre del recurso: customers/9876543210/conversionActions/257733534.
Si haces una llamada a la API a la cuenta de cliente para habilitar el uso de la acción de conversión compartida, harás referencia a ella mediante el nombre del recurso: customers/1234567890/conversionActions/257733534.
Esta es la misma acción de conversión subyacente, pero su nombre de recurso es relativo a la cuenta que se usa para acceder a ella.