Notas da versão

Saiba o que mudou em cada versão da API Data Manager.

2026-03-26

• Adição de EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED ao tipo enumerado ErrorReason.

  Para cumprir a Regulamentação de Anúncios Políticos na União Europeia (PAR da UE), o Google exige que todos os clientes declarem se os anúncios são considerados políticos de acordo com a PAR da UE. Saiba o que é um anúncio político na UE e quais são as restrições do Google para esse tipo de publicidade na região.

  A partir de 1º de abril de 2026, as seguintes operações em contas que não tiverem essa declaração poderão ser restritas ou falhar com o erro EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED.

  • UserListService (create, update, e delete)
  • IngestionService (ingestAudienceMembers)

  Para resolver o erro, os anunciantes precisam fazer a declaração obrigatória na interface do Google Ads. Saiba como confirmar para sua conta.

• Adição de INVALID_MERCHANT_ID ao ErrorReason tipo enumerado.

2026-02-17 v1.5

A API Data Manager agora oferece suporte a todo o fluxo de trabalho para gerenciar públicos-alvo, incluindo a criação, a ingestão e a recuperação.

• Adição do UserList recurso e UserListService para criar, recuperar, atualizar e excluir listas de usuários.
  • Confira os guias do Google Ads ou do Display & Video 360 para um tutorial completo sobre como criar, preencher e verificar públicos-alvo de Segmentação por lista de clientes usando a API Data Manager.
  • Consulte os guias de upgrade do Google Ads ou do Display & Video 360 para conferir as etapas de migração.
• Adição de suporte para o envio do ID de usuário pela ingestão de participantes do público-alvo, permitindo o uso com a Segmentação por lista de clientes no Google Ads.
  • Adição de UserIdData a AudienceMember.
  • Adição de IngestUserIdDataStatus e RemoveUserIdDataStatus aos status retornados pelo método RetrieveRequestStatus. Use esses campos para recuperar informações de diagnóstico sobre a ingestão e remoção de IDs de usuários.
• Adição do PartnerLink recurso e PartnerLinkService para criar e gerenciar links entre contas de anunciantes e parceiros de dados.
  • Confira os guias de links de parceiros para começar.

2026-02-10

O envio de conversões com várias fontes de dados para melhorar a performance e a qualidade dos dados agora está disponível para todas as contas do Google Ads.

Esse recurso ainda está disponível apenas para propriedades do Google Analytics em uma lista de permissões. Preencha o formulário se quiser adicionar sua propriedade do Google Analytics à lista de permissões.

2025-11-05 v1.4

• Adição de suporte para o envio de eventos purchase do Google Analytics como uma fonte de dados extra para as conversões de tags, a fim de maximizar os indicadores de interação com o anúncio e fortalecer seus dados e a performance geral.

  • Adição de GOOGLE_ANALYTICS_PROPERTY ao tipo enumerado AccountType.
  • Adição de vários campos ao Event:
    • event_name
    • client_id
    • user_id
    • additional_event_parameters
  • Adição de additional_user_properties a UserProperties.

  Saiba mais sobre o envio de eventos purchase do Google Analytics e como mapear parâmetros de eventos e propriedades do usuário do Google Analytics para os equivalentes da API Data Manager no guia de eventos.

• Adição de AwsWrappedKeyInfo para oferecer suporte ao uso de chaves de criptografia do Serviço de Gerenciamento de Chaves da AWS.

• Adição dos seguintes valores de tipo enumerado a ErrorReason:

  • EVENT_TIME_INVALID
  • FIELD_VALUE_TOO_LONG
  • INVALID_EVENT_NAME
  • INVALID_PROPERTY_TYPE
  • INVALID_REQUEST_ID
  • INVALID_STREAM_TYPE
  • LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT
  • MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT
  • NOT_ALLOWLISTED
  • OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH
  • RESERVED_NAME_USED
  • TOO_MANY_ELEMENTS
  • UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER
  • UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER

2025-10-06 v1.3

• A API Data Manager agora está disponível para todos os usuários.

  O envio de conversões com várias fontes de dados para melhorar a performance e a qualidade dos dados ainda está disponível apenas para contas em uma lista de permissões. Preencha o formulário se quiser adicionar sua conta.

  Preencha o formulário de interesse do parceiro para demonstrar interesse em se tornar um parceiro de dados.

• Adição do método RetrieveRequestStatus para recuperar informações de diagnóstico de solicitações de ingestão de eventos e públicos-alvo.

• O campo product de ProductAccount e o tipo enumerado Product foram descontinuados. Em vez disso, use o campo account_type e o novo tipo enumerado AccountType.

• Adição de suporte para especificar o destination para cada AudienceMember em um IngestAudienceMembersRequest. Use esse recurso para enviar dados de público-alvo para vários destinos distintos em uma única solicitação.

• Os públicos-alvo ingeridos com a API agora estão qualificados para segmentação quando têm pelo menos 100 participantes. Anteriormente, o limite de membros era de mil membros.

• O transaction_id de um Event agora é opcional ao enviar conversões off-line ou conversões otimizadas para leads. O transaction_id ainda é obrigatório ao enviar conversões off-line como uma fonte de dados extra para melhorar a performance e a qualidade dos dados.

2025-08-06 v1.2

• Adição de suporte para o envio de conversões off-line e conversões otimizadas para leads a destinos do Google Ads usando o método IngestEvents. Consulte o guia de criptografia atualizado para saber como configurar a criptografia dessas conversões.
• Adição dos valores APP, IN_STORE, PHONE, e OTHER ao tipo enumerado EventSource. Um event_source é obrigatório para conversões off-line e conversões otimizadas para leads.
• Adição do campo user_properties ao Event. Defina este campo como um UserProperties objeto para adicionar informações avaliadas pelo anunciante sobre um usuário quando o evento ocorreu.
• Adição de um campo repetido destination_references a CustomVariable. Use esse campo para aplicar um valor de variável personalizada apenas a um subconjunto dos destinos de um Event.
• Adição dos seguintes erros para conversões off-line e conversões otimizadas para leads:
  • DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
  • DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS
  • DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED

2025-06-25 v1.1

• Adição do IngestEvents método ao IngestionService. Use IngestEvents como uma fonte de dados adicional para as conversões de tags, a fim de maximizar os indicadores de interação com o anúncio e fortalecer seus dados e o desempenho geral.

2025-04-02 v1.0

• Primeira versão da API Data Manager, com suporte para o envio de dados de público-alvo ao Google Ads e ao Display & Video 360.
• Adição de suporte para gRPC e REST.
• Adição do IngestionService com IngestAudienceMembers e RemoveAudienceMembers métodos para gerenciar participantes do público-alvo usando os seguintes tipos de dados:
  • Dados de contato
  • IDs de dispositivos móveis
  • IDs de PAIR
• Os públicos-alvo gerenciados usando a API Data Manager só estão qualificados para segmentação se tiverem pelo menos mil participantes.