Caution: You are viewing documentation for the API's REST interface. Most of our official client libraries use gRPC. See the REST Introduction for details.

Nombres de recursos

Jerarquía de nombres

Los nombres de recursos que se utilizan en la API de Google Ads son jerárquicos, ya que reflejan la organización de las entidades en 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
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 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 ID de recurso y ensamblar uno nuevo.

Por ejemplo, examina el nombre del recurso AdGroupAd de la tabla anterior:

customers/1234567890/adGroupAds/54321098765~2109876543210

Esta información se puede desglosar en sus ID de recursos individuales (separados por los ID de colección) de la siguiente forma:

Componentes de nombres de recursos
ID de recursos
ID de cliente:
"1234567890"
ID del grupo de anuncios:
"54321098765"
ID del anuncio del grupo de anuncios:
"2109876543210"
ID de colección
"customers"
"adGroupAds"

Analizar los ID individuales te permite obtener nuevos nombres de recursos para hacer referencia al cliente 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 con un solo cliente específico de Google Ads. Sin embargo, existen 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, por lo general, crean los administradores y, luego, se comparten con muchas cuentas de cliente.

Los nombres de recursos de objetos como estos variará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:

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

Hacer 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á referencia al objeto compartido con el nombre del recurso: customers/9876543210/conversionActions/257733534.

Si realiza una llamada a la API en la cuenta de cliente para habilitar el uso de la acción de conversión compartida, se hace 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 es relativo a la cuenta que se usa para acceder a ella.