REST Resource: customers.adsDataLinks

• Recurso: AdsDataLink
  • Representação JSON
• Entidade
  • Representação JSON
• EntityType
• Plataforma
• Métrica
• GmpExportScope (link em inglês)
• Métodos

Recurso: AdsDataLink

Representa um link de dados de publicidade.

Representação 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 Nome que identifica exclusivamente um recurso AdsDataLink. Ele tem o formato customer/[customerId]/adsDataLinks/[resource_id]. O ID do recurso é gerado pelo servidor.
linkedEntity	object (Entity) Entidade vinculada pelo AdsDataLink.
parentEntity	object (Entity) Entidade pai relacionada, se houver. Se a entidade vinculada for uma campanha do Google Ads, este campo conterá um cliente correspondente do Google Ads a que a campanha pertence.
childEntities[]	object (Entity) Entidades filhas relacionadas, se houver. Se a entidade vinculada for um cliente do Google Ads que corresponde a uma vinculação entre cliente e administrador, ela vai incluir um conjunto totalmente expandido de clientes do Google Ads com dados importados para o Ads Data Hub por esse link.
platform	enum (Platform) Plataforma de publicidade associada à entidade vinculada.
customerLink	object (CustomerLink) Link do cliente pelo qual os dados vinculados podem ser acessados. Apenas o nome, o ID de cliente e a displayName são preenchidos.
status	enum (LinkStatus) Status do link de dados.
createTime	string (Timestamp format) Hora em que o link foi criado. Timestamp no formato RFC3339 UTC "Zulu" com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime	string (Timestamp format) Hora em que o status do link foi atualizado pela última vez. Timestamp no formato RFC3339 UTC "Zulu" com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
vendorClientId	string ID do cliente do fornecedor, se houver.
metrics[]	enum (Metric) Métricas que podem ser acessadas por este link de dados. Se estiver vazio, nenhuma restrição de métrica será aplicada. No momento, este campo é apenas exclusivo e só é compatível quando o tipo de entidade do link é GOOGLE_ADS_CAMPAIGN ou YT_RESERVE_LINE_ITEM.
gmpExportScopes[]	enum (GmpExportScope) Tipos de dados que serão exportados para vinculações do Display &amp 360. Preenchido apenas quando a plataforma é GOOGLE_MARKETING_PLATFORM. Se estiver vazio, não especificado, e qualquer combinação desses valores poderá estar disponível.

Entidade

Representa uma entidade de publicidade que pode ser vinculada a um cliente do Ads Data Hub.

Representação JSON
{ "entityId": string, "displayName": string, "type": enum (EntityType) }

Campos
entityId	string (int64 format) ID da entidade. O valor listado aqui depende do tipo de entidade.
displayName	string Nome de exibição da entidade.
type	enum (EntityType) Tipo de entidade vinculada.

EntityType

Entidades de publicidade compatíveis.

Enums
ENTITY_TYPE_UNSPECIFIED	Tipo de entidade não especificado.
GOOGLE_ADS_CUSTOMER	Cliente do Google Ads O entityId corresponde a Customer.id na API Google Ads.
GOOGLE_ADS_CAMPAIGN	Uma campanha do Google Ads. O entityId corresponde a Campaign.id na API Google Ads.
GMP_CM_ACCOUNT	É uma conta do Campaign Manager 360. O entityId corresponde a Accounts.id na API Campaign Manager 360.
GMP_CM_FLOODLIGHT	É uma conta do Floodlight do Campaign Manager 360. O entityId corresponde a FloodlightConfigurations.accountId na API Campaign Manager 360.
GMP_DV360_PARTNER	Um código do parceiro do Display &amp 360. O entityId é um código do parceiro do Display &amp 360.
GMP_DV360_ADVERTISER	Um código do anunciante do Display &Video 360. O entityId é um código do anunciante do Display &amp 360.
GMP_DV360_ORDER	É um código do pedido do Display &amp 360. O entityId é um código do pedido do Display &amp 360.
GMP_DV360_LINE_ITEM	É um código do item de linha do Display &amp 360. O entityId é um código do item de linha do Display &amp 360.
YT_RESERVE_ORDER	Um código do pedido do YouTube Reserve. O entityId corresponde a Order.id na API Google Ad Manager.
YT_RESERVE_LINE_ITEM	Um item de linha do YouTube Reserve. O entityId corresponde a LineItem.id na API Google Ad Manager.
VENDOR_CLIENT_ID_REGISTRATION	É um ID do cliente de fornecedores registrado manualmente por um fornecedor de tecnologia de anúncios de terceiros para fornecer medições de terceiros.
GOOGLE_AD_MANAGER_ORDER	É um código do pedido do Google Ad Manager. O entityId corresponde a Order.id na API Google Ad Manager.
GOOGLE_AD_MANAGER_LINE_ITEM	a um item de linha do Google Ad Manager. O entityId corresponde a LineItem.id na API Google Ad Manager.

Plataforma

Plataformas de publicidade compatíveis.

Enums
PLATFORM_UNSPECIFIED	Plataforma não especificada.
GOOGLE_ADS	A entidade está associada ao Google Ads.
GOOGLE_MARKETING_PLATFORM	A entidade está associada ao Google Marketing Platform.
YOUTUBE_RESERVE	A entidade está associada ao YouTube Reserve.
GOOGLE_AD_MANAGER	A entidade está associada ao Google Ad Manager.
FREEWHEEL	A entidade está associada à FreeWheel.

Métrica

Métricas que podem ser expostas pelos links de dados do anúncio.

Enums
METRIC_UNSPECIFIED	Métrica não especificada.
BRAND_LIFT	Métrica correspondente ao Brand Lift.
BRAND_SAFETY	Métrica correspondente ao brand safety.
REACH	Métrica correspondente ao alcance, em que o cliente é o anunciante.
VIEWABILITY	Métrica correspondente à visibilidade, em que o cliente é o anunciante.
PUBLISHER_REACH	Métrica correspondente ao alcance, em que o cliente é o editor/provedor de conteúdo.
PUBLISHER_VIEWABILITY	Métrica correspondente à visibilidade, em que o cliente é o editor/provedor de conteúdo.

Escopo do GmpExport

Diferentes tipos de dados que podem ser exportados para links do GMP.

Enums
GMP_EXPORT_SCOPE_UNSPECIFIED	Escopo não especificado.
GMP_EXPORT_SCOPE_YT_TRUEVIEW	Deve exportar os dados TrueView do Display & Video 360 do YouTube.
GMP_EXPORT_SCOPE_DT	Deve exportar dados da Transferência de dados.

Métodos
batchApprove	Aprove uma lista de links de dados dos anúncios pendentes.
batchReject	Rejeitar uma lista de links de dados dos anúncios pendentes
list	Lista vinculações entre o cliente especificado e outras entidades de publicidade do Google.