A partir de
8 de setembro de 2025, todos os novos itens de linha precisarão declarar se vão veicular anúncios políticos da União Europeia (UE). As APIs do Display & Video 360 e os uploads de SDF que não fornecem declarações vão falhar. Consulte nossa
página de suspensões de uso para mais detalhes sobre como atualizar sua integração e fazer essa declaração.
Anexo: mapeamento de campos de IU para campos de API por tipo de criativo
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A tabela abaixo mapeia os campos da interface aos campos correspondentes da API, separados por
tipo de criativo. Alguns campos da API exigem mais especificações usando
uma função ou tipo atribuído para o recurso fornecido.
Criativo de imagem padrão
| Tipo de criativo:CREATIVE_TYPE_STANDARD |
| Origem da hospedagem:HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API:displayName
|
|
|
Recurso do criativo
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_MAIN
|
|
|
URL da página de destino
|
|
Obrigatório
|
|
Nome do campo da API:exitEvents[].url
|
|
Tipo de evento de saída:EXIT_EVENT_TYPE_DEFAULT
|
|
|
Status
|
|
Obrigatório
|
|
Nome do campo da API: entityStatus
|
|
|
Tag de rastreamento HTML anexada
|
|
Opcional
|
|
Nome do campo da API:appendedTag
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API:notas
|
|
|
Status da auditoria
|
|
Somente leitura
|
|
Nome do campo da API:reviewStatus
|
|
Criativo HTML5
| Tipo de criativo:CREATIVE_TYPE_STANDARD |
| Origem da hospedagem:HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API:displayName
|
|
|
Recurso do criativo
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_MAIN
|
|
|
Status
|
|
Obrigatório
|
|
Nome do campo da API: entityStatus
|
|
|
Imagens de backup
|
|
Opcional
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_BACKUP
|
|
|
URL da página de destino de backup
|
|
Opcional
|
|
Nome do campo da API:exitEvents[].url
|
|
Tipo de evento de saída:EXIT_EVENT_TYPE_BACKUP
|
|
|
Rótulo de relatório de saída de backup
|
|
Opcional
|
|
Nome do campo da API:exitEvents[].reportingName
|
|
Tipo de evento de saída:EXIT_EVENT_TYPE_BACKUP
|
|
|
Imagens de carregamento discreto
|
|
Opcional
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_POLITE_LOAD
|
|
|
Saídas
|
|
Obrigatório
|
|
Nome do campo da API:exitEvents[]
|
|
Tipo de evento de saída:EXIT_EVENT_TYPE_DEFAULT
|
|
|
Contadores
|
|
Opcional
|
|
Nome do campo da API:counterEvents[]
|
|
|
Temporizadores
|
|
Opcional
|
|
Nome do campo da API:timerEvents[]
|
|
|
Tag de rastreamento HTML anexada
|
|
Opcional
|
|
Nome do campo da API:appendedTag
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API:notas
|
|
|
Status da auditoria
|
|
Opcional
|
|
Nome do campo da API:reviewStatus
|
|
Criativo de display de terceiros
| Tipo de criativo:CREATIVE_TYPE_STANDARD |
| Origem da hospedagem:HOSTING_SOURCE_THIRD_PARTY |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API:displayName
|
|
|
Status
|
|
Obrigatório
|
|
Nome do campo da API: entityStatus
|
|
|
Dimensões
|
|
Obrigatório
|
|
Nome do campo da API:dimensões
|
|
|
URL da página de destino
|
|
Obrigatório
|
|
Nome do campo da API:exitEvents[].url
|
|
Tipo de evento de saída:EXIT_EVENT_TYPE_DEFAULT
|
|
|
MRAID obrigatório
|
|
Opcional
|
|
Nome do campo da API:requireMraid
|
|
|
HTML5 obrigatório
|
|
Opcional
|
|
Nome do campo da API:requireHtml5
|
|
|
Tag de terceiros
|
|
Obrigatório
|
|
Nome do campo da API:thirdPartyTag
|
|
|
Requer ping para atribuição
|
|
Opcional
|
|
Nome do campo da API:requirePingForAttribution
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API:notas
|
|
|
Status da auditoria
|
|
Somente leitura
|
|
Nome do campo da API:reviewStatus
|
|
Criativo expansível de terceiros
| Tipo de criativo:CREATIVE_TYPE_EXPANDABLE |
| Origem da hospedagem:HOSTING_SOURCE_THIRD_PARTY |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API:displayName
|
|
|
Status
|
|
Obrigatório
|
|
Nome do campo da API: entityStatus
|
|
|
Dimensões
|
|
Obrigatório
|
|
Nome do campo da API:dimensões
|
|
|
URL da página de destino
|
|
Obrigatório
|
|
Nome do campo da API:exitEvents[].url
|
|
Tipo de evento de saída:EXIT_EVENT_TYPE_DEFAULT
|
|
|
MRAID obrigatório
|
|
Opcional
|
|
Nome do campo da API:requireMraid
|
|
|
HTML5 obrigatório
|
|
Opcional
|
|
Nome do campo da API:requireHtml5
|
|
|
Direção da expansão
|
|
Obrigatório
|
|
Nome do campo da API:expandingDirection
|
|
|
Expandir ao passar o cursor
|
|
Opcional
|
|
Nome do campo da API:expandOnHover
|
|
|
Terceiros
|
|
Obrigatório
|
|
Nome do campo da API:thirdPartyTag
|
|
|
Requer ping para atribuição
|
|
Opcional
|
|
Nome do campo da API:requirePingForAttribution
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API:notas
|
|
|
Status da auditoria
|
|
Somente leitura
|
|
Nome do campo da API:reviewStatus
|
|
Criativo de vídeo de terceiros
| Tipo de criativo:CREATIVE_TYPE_VIDEO |
| Origem da hospedagem:HOSTING_SOURCE_THIRD_PARTY |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API:displayName
|
|
|
Status
|
|
Obrigatório
|
|
Nome do campo da API: entityStatus
|
|
|
URL da tag VAST
|
|
Obrigatório
|
|
Nome do campo da API: vastTagUrl
|
|
|
VPAID
|
|
Somente leitura
|
|
Nome do campo da API:vpaid
|
|
|
Vídeo HTML5
|
|
Somente leitura
|
|
Nome do campo da API:html5Video
|
|
|
Requer ping para atribuição
|
|
Opcional
|
|
Nome do campo da API:requirePingForAttribution
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API:notas
|
|
|
Status da auditoria
|
|
Somente leitura
|
|
Nome do campo da API:reviewStatus
|
|
Criativo em áudio de terceiros
| Tipo de criativo:CREATIVE_TYPE_AUDIO |
| Origem da hospedagem:HOSTING_SOURCE_THIRD_PARTY |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API:displayName
|
|
|
Status
|
|
Obrigatório
|
|
Nome do campo da API: entityStatus
|
|
|
URL da tag VAST
|
|
Obrigatório
|
|
Nome do campo da API: vastTagUrl
|
|
|
Requer ping para atribuição
|
|
Opcional
|
|
Nome do campo da API:requirePingForAttribution
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API:notas
|
|
|
Status da auditoria
|
|
Somente leitura
|
|
Nome do campo da API:reviewStatus
|
|
Criativo de vídeo
| Tipo de criativo:CREATIVE_TYPE_VIDEO |
| Origem da hospedagem:HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API:displayName
|
|
|
Status
|
|
Obrigatório
|
|
Nome do campo da API: entityStatus
|
|
|
Arquivo de origem
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_MAIN
|
|
|
URL da página de destino
|
|
Obrigatório
|
|
Nome do campo da API:exitEvents[].url
|
|
Tipo de evento de saída:EXIT_EVENT_TYPE_DEFAULT
|
|
|
Incluir o botão "Pular"
|
|
Opcional
|
|
Nome do campo da API:skippable
|
|
|
Tempo até a opção pular
|
|
Opcional
|
|
Nome do campo da API:skipOffset
|
|
|
Tempo sem cobrança
|
|
Opcional
|
|
Nome do campo da API:progressOffset
|
|
|
ID universal do anúncio
|
|
Opcional
|
|
Nome do campo da API:universalAdId
|
|
|
OBA
|
|
Opcional
|
|
Nome do campo da API:obaIcon
|
|
|
Criativos complementares
|
|
Opcional
|
|
Nome do campo da API:companionCreativeIds
|
|
|
Arquivo de veiculação
|
|
Somente leitura
|
|
Nome do campo da API:transcodificações
|
|
|
URLs de terceiros
|
|
Opcional
|
|
Nome do campo da API:thirdPartyUrls
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API:notas
|
|
|
Status da auditoria
|
|
Somente leitura
|
|
Nome do campo da API:reviewStatus
|
|
Criativo em áudio
| Tipo de criativo:CREATIVE_TYPE_AUDIO |
| Origem da hospedagem:HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API:displayName
|
|
|
Status
|
|
Obrigatório
|
|
Nome do campo da API: entityStatus
|
|
|
Arquivo de origem
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_MAIN
|
|
|
URL da página de destino
|
|
Obrigatório
|
|
Nome do campo da API:exitEvents[].url
|
|
Tipo de evento de saída:EXIT_EVENT_TYPE_DEFAULT
|
|
|
Recurso complementar (enviar ou atribuir)
|
|
Obrigatório
|
|
Nome do campo da API:companionCreativeIds
|
|
|
Nome do arquivo de veiculação
|
|
Somente leitura
|
|
Nome do campo da API:transcodes[].name
|
|
|
Tipo de arquivo de veiculação
|
|
Somente leitura
|
|
Nome do campo da API:transcodes[].mimeType
|
|
|
Como exibir a taxa de bits do áudio do arquivo
|
|
Somente leitura
|
|
Nome do campo da API:transcodes[].audioBitRateKbps
|
|
|
Como exibir a taxa de amostragem do áudio do arquivo
|
|
Somente leitura
|
|
Nome do campo da API:transcodes[].audioSampleRateHz
|
|
|
URLs de terceiros
|
|
Opcional
|
|
Nome do campo da API:thirdPartyUrls
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API:notas
|
|
|
Status da auditoria
|
|
Somente leitura
|
|
Nome do campo da API:reviewStatus
|
|
Criativo de display nativo
| Tipo de criativo:CREATIVE_TYPE_NATIVE, CREATIVE_TYPE_NATIVE_SITE_SQUARE |
| Origem da hospedagem:HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API:displayName
|
|
|
status
|
|
Obrigatório
|
|
Nome do campo da API: entityStatus
|
|
|
Logotipo
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_ICON
|
|
|
Imagem / Imagem quadrada
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_MAIN
|
|
|
Título
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_HEADLINE
|
|
|
Título longo
|
|
Opcional
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_LONG_HEADLINE
|
|
|
Corpo do texto
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_BODY
|
|
|
Corpo do texto longo
|
|
Opcional
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_LONG_BODY
|
|
|
URL da página de destino
|
|
Obrigatório
|
|
Nome do campo da API:exitEvents[].url
|
|
Tipo de evento de saída:EXIT_EVENT_TYPE_DEFAULT
|
|
|
URL da legenda
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_CAPTION_URL
|
|
|
Call-to-action
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_CALL_TO_ACTION
|
|
|
Anúncio de rastreamento do Campaign Manager 360
|
|
Opcional
|
|
Nome do campo da API:cmTrackingAd
|
|
|
URL 1 de rastreamento de impressões
|
|
Opcional
|
|
Nome do campo da API:trackingUrls[]
|
|
|
URL 2 de rastreamento de impressões
|
|
Opcional
|
|
Nome do campo da API:trackingUrls[]
|
|
|
URL de rastreamento JavaScript
|
|
Opcional
|
|
Nome do campo da API:jsTrackerUrl
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API:notas
|
|
|
Status da auditoria
|
|
Somente leitura
|
|
Nome do campo da API:reviewStatus
|
|
Criativo de vídeo nativo
| Tipo de criativo:CREATIVE_TYPE_NATIVE_VIDEO |
| Origem da hospedagem:HOSTING_SOURCE_HOSTED |
|
Nome
|
|
Obrigatório
|
|
Nome do campo da API:displayName
|
|
|
Status
|
|
Obrigatório
|
|
Nome do campo da API: entityStatus
|
|
|
Logotipo
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso: ASSET_ROLE_ICON
|
|
|
Vídeo
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_MAIN
|
|
|
Imagem da capa
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_COVER_IMAGE
|
|
|
Nome do anunciante
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_ADVERTISER_NAME
|
|
|
Título
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_HEADLINE
|
|
|
Título longo
|
|
Opcional
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_LONG_HEADLINE
|
|
|
Corpo do texto
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_BODY
|
|
|
Corpo do texto longo
|
|
Opcional
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_LONG_BODY
|
|
|
URL da página de destino
|
|
Obrigatório
|
|
Nome do campo da API:exitEvents[].url
|
|
Tipo de evento de saída:EXIT_EVENT_TYPE_DEFAULT
|
|
|
URL da legenda
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_CAPTION_URL
|
|
|
Call-to-action
|
|
Obrigatório
|
|
Nome do campo da API:recursos
|
|
Função do recurso:ASSET_ROLE_CALL_TO_ACTION
|
|
|
URL 1 de rastreamento de impressões
|
|
Opcional
|
|
Nome do campo da API:trackingUrls[]
|
|
|
URL 2 de rastreamento de impressões
|
|
Opcional
|
|
Nome do campo da API:trackingUrls[]
|
|
|
URL de rastreamento JavaScript
|
|
Opcional
|
|
Nome do campo da API:jsTrackerUrl
|
|
|
Código de integração
|
|
Opcional
|
|
Nome do campo da API:integrationCode
|
|
|
Observações
|
|
Opcional
|
|
Nome do campo da API:notas
|
|
|
Status da auditoria
|
|
Somente leitura
|
|
Nome do campo da API:reviewStatus
|
|
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 2025-07-25 UTC."],[[["\u003cp\u003eThis document provides a comprehensive mapping of UI fields to their corresponding API fields for various creative types, including Standard Image, HTML5, Third-Party Display, Third-Party Expandable, Third-Party Video, Third-Party Audio, Video, Audio, Native Display, and Native Video.\u003c/p\u003e\n"],["\u003cp\u003eEach creative type has a specific set of required and optional fields, along with their API field names and any further specifications for asset roles or exit event types.\u003c/p\u003e\n"],["\u003cp\u003eCreative asset specifications, such as required and optional assets, are outlined for Native Video creatives, including details about their roles and corresponding API field names.\u003c/p\u003e\n"],["\u003cp\u003eCampaign Manager 360 tracking ad can optionally be included using the \u003ccode\u003ecmTrackingAd\u003c/code\u003e API field.\u003c/p\u003e\n"],["\u003cp\u003eThis mapping enables developers to understand how UI inputs translate into API data for seamless creative management and integration within the system.\u003c/p\u003e\n"]]],[],null,[]]
