Jerarquía de nombres
Los nombres de recursos que se utilizan 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 dirigirse a una cuenta de Google Ads específica. Por ejemplo, las campañas, los grupos de anuncios, los anuncios y las palabras clave son todos recursos secundarios de un recurso raíz del cliente.
| 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
En toda la API, se hace referencia a las entidades de Google Ads (clientes, campañas, etc.) por sus nombres de recursos. 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 estos IDs 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 |
|
||||||
| IDs de colección |
|
||||||
El análisis de los IDs 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 de la API están asociados a 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, se trata de elementos como las listas de palabras clave negativas o las acciones de conversión en varias cuentas que suelen crear los administradores y, luego, se comparten con muchas cuentas 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 la cuenta de administrador 987-654-3210 que comparte una acción de conversión en varias cuentas 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 el período de observación de la acción de conversión haría referencia al objeto compartido con el nombre del recurso: customers/9876543210/conversionActions/257733534.
Si se realiza una llamada a la API a la cuenta del 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 su nombre del recurso es relativo a la cuenta que se usa para acceder a ella.