Suspensão de uso anunciada

Esta página lista as datas de descontinuação e desativação de versões de API e recursos individuais na API Display & Video 360.

As descontinuações e datas de desativação da API também serão anunciadas no blog para desenvolvedores do Google Ads.

Suspensão de uso de versões

As versões da API Display & Video 360 são lançadas, descontinuadas e desativadas regularmente. Essas etapas são definidas da seguinte maneira:

  • Lançamento: a versão sai de qualquer status Alfa ou Beta e é considerada estável. As adições de recursos ainda podem ser lançadas para a versão.
  • Suspensão de uso: a versão está sendo desativada e uma data de desativação foi anunciada. Os usuários precisam migrar para uma versão mais recente antes da data de desativação. As adições de recursos não serão mais lançadas para a versão.
  • Desativação: a versão não tem mais suporte. As solicitações feitas à versão retornam um erro.

A tabela abaixo lista todas as versões principais da API do Display & Video 360, as datas de lançamento, descontinuação e desativação, se anunciadas.

Versão da API Data do lançamento Data da descontinuação Data da desativação Guia de migração
v3 31 de outubro de 2023
v2 6 de dezembro de 2022 15 de fevereiro de 2024 3 de setembro de 2024 Migrar da v2 para a v3
v1 9 de março de 2020 13 de março de 2023 14 de setembro de 2023 Migrar da v1 para a v2

Suspensões de uso de recursos

Siga nosso blog para desenvolvedores do Google Ads e fique por dentro das descontinuações de recursos importantes.

A tabela abaixo lista todas as suspensões de uso de atributos anunciadas, fornecendo a data inicial de vigência e uma descrição da suspensão com ações recomendadas e links para a documentação relevante:

Recurso Início da vigência inicial Descrição
Expansão de segmentação 25 de março de 2023 A substituição do recurso de expansão de segmentação pela segmentação otimizada, lançada gradualmente de 25 de março de 2023 até o início de maio de 2023. As mudanças relevantes no comportamento da API Display & Video 360 e dos arquivos de dados estruturados, bem como as ações recomendadas, foram anunciadas em uma postagem do blog.
Gatilhos manuais 17 de maio de 2023

Cronograma:

  • 17 de maio de 2023: os itens de linha que usam gatilhos manuais vão deixar de ser veiculados no Display & Video 360. Se você ativar um acionador manual vinculado a um item de linha ativo após essa data, o item de linha não vai veicular anúncios.
  • 1º de agosto de 2023: o serviço advertisers.manualTriggers na API DV360 v1 e v2, o valor de enumeração LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER na API DV360 v1 e o campo LineItemFlight.triggerId na API DV360 v1 serão desativados. Após essa data, as solicitações feitas para esses serviços ou campos vão retornar um erro.

Ações recomendadas:

Tipos de app instalado e novos dispositivos móveis GoogleAudience 20 de maio de 2023

Cronograma:

  • 20 de maio de 2023: não será mais possível atribuir recursos GoogleAudience com um GoogleAudienceType de GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS ou GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES à segmentação por público-alvo de itens de linha ou pedidos de inserção. As solicitações que atribuem esses públicos-alvo à segmentação por público-alvo de um item de linha vão retornar um erro. Isso inclui solicitações de advertisers.lineItems.duplicate e advertisers.lineItems.generateDefault, se o item de linha criado incluir públicos-alvo descontinuados na segmentação por público-alvo.
  • 8 de junho de 2023: os públicos-alvo afetados serão removidos de todos os itens de linha e segmentações de pedidos de inserção e de todos os públicos-alvo combinados. Se um item de linha não puder veicular anúncios quando esses públicos-alvo forem removidos, ele será pausado. Nessa data, esses públicos-alvo também não poderão mais ser recuperados usando o serviço googleAudiences.

Tarefas recomendadas:

  • Recomendamos que você pare de usar imediatamente os públicos-alvo afetados ao fazer atualizações futuras na segmentação do item de linha.
  • Remova todos os públicos-alvo afetados da segmentação de itens de linha e pedidos de inserção. Leia sobre como atualizar a segmentação por público-alvo no nosso guia sobre públicos-alvo.
Tipos de público-alvo baseado em atividades e limite de frequência FirstAndThirdPartyAudience 20 de maio de 2023

Cronograma:

  • 20 de maio de 2023: não será mais possível atribuir recursos FirstAndThirdPartyAudience com um AudienceType de ACTIVITY_BASED ou FREQUENCY_CAP à segmentação por público-alvo de itens de linha ou pedidos de inserção. As solicitações que atribuem esses públicos-alvo à segmentação por público-alvo de um item de linha vão retornar um erro. Isso inclui solicitações de advertisers.lineItems.duplicate e advertisers.lineItems.generateDefault, se o item de linha criado incluir públicos-alvo descontinuados na segmentação por público-alvo.
  • 8 de junho de 2023: os públicos-alvo afetados serão removidos de todos os itens de linha e segmentações de ordens de inserção e de todos os públicos-alvo combinados. Se um item de linha não puder veicular anúncios quando esses públicos-alvo forem removidos, ele será pausado. Nessa data, esses públicos-alvo também não poderão mais ser recuperados usando o serviço firstAndThirdPartyAudiences.

Tarefas recomendadas:

  • Recomendamos que você pare de usar imediatamente os públicos-alvo afetados ao fazer atualizações futuras na segmentação do item de linha.
  • Remova todos os públicos-alvo afetados da segmentação de itens de linha e pedidos de inserção. Leia sobre como atualizar a segmentação por público-alvo no nosso guia sobre públicos-alvo.
Limites de cota da API 30 de maio de 2023

Em 30 de maio de 2023, os limites de uso atuais serão substituídos por uma estrutura de cota híbrida que:

  1. Elimina as solicitações por dia por cota de projeto.
  2. Estabelece uma cota de solicitações por minuto por anunciante por projeto para métodos qualificados.

Esses novos limites vão permitir maior flexibilidade no uso da API e permitir a paralelização de solicitações entre anunciantes. Os detalhes dessa mudança estão na nossa documentação sobre o limite de cota.

Uso do operador OR entre restrições de campos diferentes em filtros LIST

21 de junho de 2023

Em 21 de junho de 2023, os parâmetros filter da solicitação LIST não vão mais permitir que operadores lógicos OR sejam usados entre restrições de campos diferentes.

Por exemplo, os recursos identificados com a string de filtro lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" precisam ser recuperados usando duas solicitações LIST com as seguintes strings de filtro:

  • lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
  • insertionOrderId="123"

Consulte nosso guia de como filtrar solicitações LIST para mais detalhes sobre as restrições de operadores lógicos.

Revise os parâmetros de consulta filter de todas as chamadas LIST e verifique se elas estão usando o operador lógico OR corretamente antes de 21 de junho de 2023 para evitar a interrupção do serviço.

Capacidade de filtrar ou ordenar solicitações de lista por campos budget.budget_segments.date_range.end_date e flight.dateRange.endDate

Início da vigência inicial atualizado

21 de junho de 2023

A partir de 21 de junho de 2023, os campos budget.budget_segments.date_range.end_date e flight.dateRange.endDate não serão mais aceitos nos parâmetros de consulta advertisers.insertionOrders.list e advertisers.lineItems.list filter e orderBy, respectivamente. Após essa data, as solicitações que usam esses campos nos parâmetros de consulta filter e orderBy vão retornar um erro.

Remova toda a lógica de ordenação e filtro usando esses dois campos antes de 21 de junho de 2023 para evitar a interrupção do serviço.

Possibilidade de filtrar solicitações de advertisers.lineItems.list por quatro campos adicionais 21 de junho de 2023

A partir de 21 de junho de 2023, o advertisers.lineItems.list não vai mais oferecer suporte à filtragem pelos seguintes campos:

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

Remova toda a lógica de filtro que usa esses quatro campos antes de 21 de junho de 2023 para evitar a interrupção do serviço.

Compra com base em resultados 1º de agosto de 2023

Em 1º de agosto de 2023, os pedidos de inserção que usam a compra com base em resultados, definidos por um valor de campo billableOutcome de BILLABLE_OUTCOME_PAY_PER_CLICK ou BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION, e os itens de linha filhos serão arquivados.

Essa mudança vai afetar as seguintes solicitações:

Campo publisherReviewStatuses nos recursos do criativo 26 de junho de 2024

A partir de 26 de junho de 2024, o campo publisherReviewStatuses será desativado e vai ficar vazio ao recuperar recursos Creative.

Segmentação por conteúdo para itens de linha do YouTube e parceiros 30 de setembro de 2024

Em 30 de setembro de 2024, os seguintes valores dos tipos de segmentação identificados serão desativados para os itens de linha do YouTube e parceiros:

As opções de segmentação descontinuadas serão removidas automaticamente da segmentação de itens de linha. Esses valores ainda vão estar disponíveis para uso na segmentação no nível do anunciante.

Para evitar interrupções no serviço, remova essa segmentação de todos os itens de linha do YouTube e parceiros antes da data de desativação.

Públicos-alvo próprios e de terceiros da Oracle 30 de setembro de 2024

Em 30 de setembro de 2024, as origens de recursos do FirstAndThirdPartyAudience do Oracle serão desativadas. Após o desativamento, esses públicos-alvo serão removidos de qualquer segmentação de público-alvo combinada e segmentação de recursos. Se um item de linha segmenta apenas públicos-alvo descontinuados ou segmenta negativamente qualquer público-alvo descontinuado, essa atualização pausa automaticamente o item de linha.

Para evitar interrupções no serviço, identifique e remova todos os públicos-alvo da Oracle da segmentação de público-alvo de linhas e dos públicos-alvo combinados antes da data de desativação.

Segmentação otimizada do item de linha para um subconjunto de estratégias de lances 30 de setembro de 2024

A partir de 30 de setembro de 2024, os recursos LineItem que usam um subconjunto de estratégias de lances não serão mais compatíveis com a segmentação otimizada. Com essa mudança, os recursos LineItem com targetingExpansion.enableOptimizedTargeting definido como True e bidStrategy.maximizeSpendAutoBid.performanceGoalType definido como BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN ou BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED ou bidStrategy.performanceGoalAutoBid.performanceGoalType definido como BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM serão atualizados para definir targetingExpansion.enableOptimizedTargeting como False.

Para evitar interrupções no serviço, atualize e verifique se os itens de linha que usam essas estratégias de lances não têm a segmentação otimizada ativada.

Período de veiculação "Assim que possível" Pacing para pedidos de inserção 5 de novembro de 2024

Em 5 de novembro de 2024, o PACING_TYPE_ASAP não será mais compatível com PACING_PERIOD_FLIGHT ao definir o campo pacing do pedido de inserção. O pacingType de todos os pedidos de inserção com essa configuração será atualizado para PACING_TYPE_AHEAD.

Para evitar interrupções no serviço, atualize o pacing de todos os pedidos de inserção usando PACING_TYPE_ASAP e PACING_PERIOD_FLIGHT.

Período do limite de frequência superior a 30 dias 28 de fevereiro de 2025

Em 28 de fevereiro de 2025:

  • As solicitações que criam ou atualizam os recursos LineItem, InsertionOrder e Campaign para usar um objeto FrequencyCap com um campo timeUnit definido como TIME_UNIT_LIFETIME ou um campo timeUnit definido como TIME_UNIT_MONTH e um campo timeUnitCount definido como 2 vão retornar um erro 400.
  • As entradas nos arquivos de dados estruturados Item de linha, Pedido de inserção e Campanha com o valor da coluna "Período de frequência" como "Vida útil" ou "Meses" e o valor da coluna "Quantidade de frequência" como "2" não podem ser criadas ou atualizadas no upload de arquivos.
  • As campanhas, os pedidos de inserção e os itens de linha atuais serão atualizados para usar um período de limite de frequência de 30 dias ou menos.

Para evitar interrupções no serviço:

  • Atualize os recursos de campanha, pedido de inserção e item de linha que usam um período de limite de frequência superior a 30 dias para 30 dias ou menos.
  • Verifique se a integração não está definindo um período de limite de frequência superior a 30 dias ao criar ou atualizar recursos de campanha, pedido de inserção ou item de linha usando a API Display & Video 360 ou arquivos de dados estruturados.
Segmentação otimizada para itens de linha que usam lances fixos 6 de março de 2025

Em 6 de março de 2025:

  • As solicitações que criam ou atualizam recursos LineItem para definir o campo BiddingStrategy fixedBid e o campo TargetingExpansionConfig enableOptimizedTargeting como verdadeiro vão retornar um erro 400.
  • As entradas nos arquivos de dados estruturados do Item de linha com o valor da coluna "Tipo de estratégia de lances" como "Fixo" e o valor da coluna "Alcance otimizado" como "Verdadeiro" não podem ser criadas ou atualizadas no upload de arquivos.
  • Os itens de linha que usam lances fixos serão atualizados para desativar a segmentação otimizada.

Para evitar interrupções no serviço:

  • Atualize os recursos de itens de linha que usam lances fixos e segmentação otimizada.
  • Verifique se a integração não está definindo uma estratégia de lances fixa e segmentação otimizada ao criar ou atualizar recursos de itens de linha usando a API Display & Video 360 ou arquivos de dados estruturados.
Atualizar para o tamanho de página padrão firstAndThirdPartyAudiences.list 6 de março de 2025

Em 6 de março de 2025, o tamanho de página padrão das solicitações firstAndThirdPartyAudiences.list vai ser atualizado de 100 para 5.000.

Para evitar a interrupção do serviço, atualize a integração para definir o parâmetro de consulta pageSize das solicitações firstAndThirdPartyAudiences.list para o tamanho de página desejado.

Novo erro de incompatibilidade de parceiro/anunciante sdfdownloadtasks.create 6 de março de 2025

A partir de 6 de março de 2025, as solicitações sdfdownloadtasks.create que usam um filtro de entidade pai para filtrar por anunciantes que não são filhos do conjunto partnerId vão começar a retornar um erro 400.

Algoritmo de lances personalizados e atividades do Floodlight incompatíveis 1º de abril de 2025

Em 1º de abril de 2025:

Para evitar interrupções no serviço, atualize a integração para:

  • Verifique se as atividades do Floodlight relevantes são atribuídas a um item de linha antes ou ao mesmo tempo que a atribuição de um algoritmo de lances personalizados.
  • Os algoritmos de lances personalizados atuais são removidos de todos os itens de linha antes de serem atualizados.

Duração da associação infinita para públicos-alvo próprios 7 de abril de 2025

A partir de 7 de abril de 2025, os recursos FirstAndThirdPartyAudience não vão mais permitir a duração infinita de associação ao público-alvo. As solicitações firstAndThirdPartyAudiences.create e firstAndThirdPartyAudiences.patch que definem o valor do campo membershipDurationDays como 10.000 vão retornar um erro 400. Os públicos-alvo atuais com um valor de campo membershipDurationDays de 10.000 vão ser atualizados para 540,e a nova duração da assinatura será aplicada retroativamente às assinaturas atuais. Isso vai fazer com que todas as associações com mais de 540 dias expirem.

Para evitar interrupções no serviço:

  • Verifique se a integração não está definindo o valor do campo membershipDurationDays de públicos-alvo novos ou existentes como 10.000.
  • Atualize as adesões dos seus públicos-alvo de Segmentação por lista de clientes usando firstAndThirdPartyAudiences.editCustomerMatchMembers.
  • Atualize regularmente as associações de público-alvo segmentado por lista de clientes para garantir que o tamanho da lista dos seus públicos-alvo não diminua acidentalmente.

Na v4, essa mudança é refletida nos recursos FirstPartyAndPartnerAudience.

Coluna "Bid Multipliers" nos arquivos de dados estruturados de itens de linha 1° de maio de 2025

A partir de 1º de maio de 2025, as entradas em arquivos de dados estruturados de item de linha que tentarem definir a coluna "Multiplicadores de lances" não vão conseguir criar ou atualizar o recurso no upload de arquivos.