REST Resource: customers.adsDataLinks

• Recurso: AdsDataLink
  • Representación JSON
• Entidad
  • Representación JSON
• EntityType
• Platform
• Métrica
• GmpExportScope
• Métodos

Recurso: AdsDataLink

Representa un vínculo de datos publicitarios.

Representación JSON
{ "name": string, "linkedEntity": { object (Entity) }, "parentEntity": { object (Entity) }, "childEntities": [ { object (Entity) } ], "platform": enum (Platform), "customerLink": { object (CustomerLink) }, "status": enum (LinkStatus), "createTime": string, "updateTime": string, "vendorClientId": string, "metrics": [ enum (Metric) ], "gmpExportScopes": [ enum (GmpExportScope) ] }

Campos
name	string Nombre que identifica de forma única un recurso AdsDataLink. Tiene el formato customers/[customerId]/adsDataLinks/[resource_id]. El servidor genera el ID de recurso.
linkedEntity	object (Entity) Entidad vinculada a través de este AdsDataLink.
parentEntity	object (Entity) Entidad principal relacionada, si corresponde. Si la entidad vinculada es una campaña de Google Ads, este campo contendrá un cliente de Google Ads correspondiente al que pertenece la campaña.
childEntities[]	object (Entity) Entidades secundarias relacionadas, si las hubiera. Si la entidad vinculada es un cliente de Google Ads que corresponde a un vínculo de cliente y administrador, entonces las entidades secundarias incluirán un conjunto completamente expandido de clientes de Google Ads con datos importados al Centro de Datos de Anuncios a través de este vínculo.
platform	enum (Platform) Plataforma publicitaria asociada a la entidad vinculada.
customerLink	object (CustomerLink) Es el vínculo del cliente mediante el cual se puede acceder a los datos vinculados. Solo se propagan el nombre, el ID de cliente y displayName.
status	enum (LinkStatus) Estado del vínculo de datos.
createTime	string (Timestamp format) Hora en la que se creó el vínculo. Una marca de tiempo en formato RFC3339 UTC (Zulú) con resolución en nanosegundos y hasta nueve dígitos decimales. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
updateTime	string (Timestamp format) Hora en que se actualizó por última vez el estado del vínculo. Una marca de tiempo en formato RFC3339 UTC (Zulú) con resolución en nanosegundos y hasta nueve dígitos decimales. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
vendorClientId	string ID de cliente proveedor, si corresponde.
metrics[]	enum (Metric) Métricas accesibles a través de este vínculo de datos. Si está vacío, no se aplican restricciones de métricas. Por el momento, este campo es solo de singular y solo se admite cuando el tipo de entidad de vínculo es GOOGLE_ADS_CAMPAIGN o YT_RESERVE_LINE_ITEM.
gmpExportScopes[]	enum (GmpExportScope) Tipos de datos que se exportarán para vínculos de Display &Video 360. Solo se propaga cuando la plataforma es GOOGLE_MARKETING_PLATFORM. Si está vacío, no se especifica y cualquier combinación de estos puede estar disponible.

Entidad

Representa una entidad publicitaria que se puede vincular a un cliente del Centro de Datos de Anuncios.

Representación JSON
{ "entityId": string, "displayName": string, "type": enum (EntityType) }

Campos
entityId	string (int64 format) ID de entidad. El valor que se muestra aquí depende del tipo de entidad.
displayName	string Nombre visible de la entidad.
type	enum (EntityType) Tipo de entidad vinculada.

EntityType

Entidades publicitarias compatibles.

Enumeradores
ENTITY_TYPE_UNSPECIFIED	Tipo de entidad no especificado.
GOOGLE_ADS_CUSTOMER	Un cliente de Google Ads El entityId corresponde a Customer.id en la API de Google Ads.
GOOGLE_ADS_CAMPAIGN	Una campaña de Google Ads El entityId corresponde a Campaign.id en la API de Google Ads.
GMP_CM_ACCOUNT	Una cuenta de Campaign Manager 360 El entityId corresponde a Accounts.id en la API de Campaign Manager 360.
GMP_CM_FLOODLIGHT	Una cuenta de Floodlight de Campaign Manager 360 El entityId corresponde a FloodlightConfigurations.accountId en la API de Campaign Manager 360.
GMP_DV360_PARTNER	Un ID de socio de Display &Video 360. entityId es un ID de socio de Display &Video 360.
GMP_DV360_ADVERTISER	Un ID de anunciante de Display &Video 360 entityId es un ID de anunciante de Display &Video 360.
GMP_DV360_ORDER	Un ID de pedido de Display &Video 360. entityId es un ID de pedido de Display &Video 360.
GMP_DV360_LINE_ITEM	Un ID de línea de pedido de Display &Video 360. entityId es un ID de línea de pedido de Display &Video 360.
YT_RESERVE_ORDER	Un ID de pedido de YouTube Reserve. entityId corresponde a Order.id en la API de Google Ad Manager.
YT_RESERVE_LINE_ITEM	Una línea de pedido de YouTube Reserve. entityId corresponde a LineItem.id en la API de Google Ad Manager.
VENDOR_CLIENT_ID_REGISTRATION	Es un ID de cliente proveedor que está registrado manualmente por un proveedor de tecnología publicitaria de terceros para proporcionar mediciones de terceros.
GOOGLE_AD_MANAGER_ORDER	Un ID de pedido de Google Ad Manager. entityId corresponde a Order.id en la API de Google Ad Manager.
GOOGLE_AD_MANAGER_LINE_ITEM	Una línea de pedido de Google Ad Manager. entityId corresponde a LineItem.id en la API de Google Ad Manager.

Plataforma

Plataformas publicitarias compatibles.

Enumeradores
PLATFORM_UNSPECIFIED	Plataforma no especificada.
GOOGLE_ADS	La entidad está asociada con Google Ads.
GOOGLE_MARKETING_PLATFORM	La entidad está asociada con Google Marketing Platform.
YOUTUBE_RESERVE	La entidad está asociada con YouTube Reserve.
GOOGLE_AD_MANAGER	La entidad está asociada con Google Ad Manager.
FREEWHEEL	La entidad está asociada con FreeWheel.

Métrica

Son métricas que se pueden exponer a través de vínculos de datos de anuncios.

Enumeradores
METRIC_UNSPECIFIED	Métrica no especificada
BRAND_LIFT	Es una métrica que corresponde al Reconocimiento de marca.
BRAND_SAFETY	Métrica que corresponde a la seguridad de la marca.
REACH	Es una métrica que corresponde al alcance, en la que el cliente es el anunciante.
VIEWABILITY	Métrica que corresponde a la visibilidad, en la que el cliente es el anunciante.
PUBLISHER_REACH	Es una métrica que corresponde al alcance, en la que el cliente es el publicador o el proveedor de contenido.
PUBLISHER_VIEWABILITY	Métrica que corresponde a la visibilidad, en la que el cliente es el publicador o el proveedor de contenido.

Alcance de la exportación de Gmp

Diferentes tipos de datos que se pueden exportar para vínculos de GMP.

Enumeradores
GMP_EXPORT_SCOPE_UNSPECIFIED	Alcance sin especificar.
GMP_EXPORT_SCOPE_YT_TRUEVIEW	Debe exportar los datos de TrueView de Display &Video 360.
GMP_EXPORT_SCOPE_DT	Debe exportar datos de Transferencia de datos.

Métodos
batchApprove	Apruebe una lista de vínculos de datos de anuncios pendientes.
batchReject	Rechazar una lista de vínculos de datos de anuncios pendientes
list	Enumera los vínculos entre el cliente especificado y otras entidades publicitarias de Google.