Nombres de recursos

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 dentro de Google Ads. Casi todos los recursos son subrecursos del Customer recurso, lo que refleja el hecho de que casi todas las llamadas a la API deben segmentarse 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

Punto clave: La API de Google Ads usa nombres de recursos relativos (y no nombres de recursos completos como algunas otras APIs de Google).

IDs de recursos

Las entidades de Google Ads (clientes, campañas, etc.) se mencionan por sus nombres de recursos en toda la API. Sin embargo, es importante tener en cuenta que los nombres de 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 de recursos 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	ID de cliente: "1234567890" ID del grupo de anuncios: "54321098765" ID del anuncio del grupo de anuncios: "2109876543210"
IDs de colección	"customers" "adGroupAds"

El análisis de los IDs individuales te permite obtener 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).

Punto clave: Los nombres de recursos en los cuerpos de solicitud y respuesta de JSON se mencionan en el campo resourceName, no en el name campo como en algunas otras APIs de Google Cloud. Muchas entidades de Google Ads tienen atributos de nombre (campaign.Name, adGroup.Name, etc.), por lo que se usa resourceName para evitar conflictos con los nombres de objetos existentes.

Identificadores de objetos compartidos

La mayoría de los objetos de la API están asociados con un cliente de Google Ads específico. Sin embargo, existen 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 de múltiples cuentas que suelen crear los administradores y, luego, se comparten con muchas cuentas de 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 de múltiples cuentas con una de sus cuentas de cliente final del intermediario 123-456-7890:

Si realizas una llamada a la API a la cuenta de administrador para, por ejemplo, actualizar la ventana de visualización de la acción de conversión, se hará referencia al objeto compartido con el nombre del 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 su nombre de recurso es relativo a la cuenta que se usa para acceder a ella.