Nombres de recursos

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

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

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	ID de cliente: "1234567890" ID del grupo de anuncios: "54321098765" ID de anuncio del grupo de anuncios: "2109876543210"
IDs de colecciones	"customers" "adGroupAds"

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)

Punto clave: A los nombres de recursos en solicitudes JSON y cuerpos de respuesta se hace referencia a través de el campo resourceName, no el name como en otras APIs de Google Cloud. Muchas entidades de Google Ads tienen nombre se atributos a sí mismos (campaign.Name, adGroup.Name, etc.), por lo que resourceName se usa para evitar colisiones con nombres de objetos existentes.

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.