Suspensão de uso anunciada

Esta página lista as datas de suspensão e desativação das versões da API e dos 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ões 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. Novos recursos ainda podem ser lançados para a versão.
  • Suspensão de uso: a versão está sendo desativada, e uma data de fim do suporte (desativação) é anunciada. Os usuários precisam migrar para uma versão mais recente antes da data de desativação. Nenhuma adição de recursos será lançada para a versão.
  • Desativada: a versão não é mais compatível. As solicitações feitas à versão retornam um erro.

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

Versão da API Data do lançamento Data da descontinuação Data da desativação Guia de migração
v4 27 de março de 2025
v3 31 de outubro de 2023 2 de abril de 2025 7 de outubro de 2025 Migrar da v3 para a v4
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 de desenvolvedores do Google Ads para ficar por dentro dos anúncios de descontinuação de recursos importantes.

A tabela abaixo lista todas as suspensões de uso de recursos anunciadas, fornecendo a data de início inicial e uma descrição da suspensão de uso com ações recomendadas e links para a documentação relevante:

Recurso Data de início da vigência Descrição
Expansão de segmentação 25 de março de 2023 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 na API do Display & Video 360 e no comportamento dos arquivos de dados estruturados, além das ações recomendadas, foram anunciadas em uma postagem no blog.
Gatilhos manuais 17 de maio de 2023

Cronograma:

  • 17 de maio de 2023: os itens de linha que usam acionadores manuais vão parar 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 nas APIs 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 a esses serviços ou campos vão retornar um erro.

Ações recomendadas:

Tipos de GoogleAudience de apps instalados e novos dispositivos móveis 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 retornam 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 toda a segmentação de itens de linha e 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 os públicos-alvo afetados imediatamente ao fazer atualizações futuras na segmentação do item de linha.
  • Remova todos os públicos-alvo afetados da segmentação atual do item de linha e do pedido de inserção. Leia sobre como atualizar a segmentação por público-alvo no nosso guia de públicos-alvo.
Tipos de FirstAndThirdPartyAudience baseados em atividade e limite de frequência 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 retornam 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 toda a segmentação de itens de linha e 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 firstAndThirdPartyAudiences.

Tarefas recomendadas:

  • Recomendamos que você pare de usar os públicos-alvo afetados imediatamente ao fazer atualizações futuras na segmentação do item de linha.
  • Remova todos os públicos-alvo afetados da segmentação atual do item de linha e do pedido de inserção. Leia sobre como atualizar a segmentação por público-alvo no nosso guia de públicos-alvo.
Limites de cota da API atuais 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 faz o seguinte:

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

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

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

21 de junho de 2023

Em 21 de junho de 2023, os parâmetros de solicitação filter do LIST não vão mais permitir o uso de operadores lógicos OR 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 instruções sobre como filtrar solicitações LIST para mais detalhes sobre as restrições de operadores lógicos.

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

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

Data de início da vigência atualizada

21 de junho de 2023

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

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

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

Em 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 usando esses quatro campos antes de 21 de junho de 2023 para evitar uma 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 baseada em resultados, definida 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 de criativos 26 de junho de 2024

A partir de 26 de junho de 2024, o campo publisherReviewStatuses será desativado e 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 para os tipos de segmentação identificados serão desativados para itens de linha do YouTube e parceiros:

As opções de segmentação desativadas serão removidas automaticamente da segmentação de itens de linha atuais. Esses valores ainda estarão 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 descontinuação.

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

Em 30 de setembro de 2024, as fontes de recursos do FirstAndThirdPartyAudience do Oracle serão desativadas. Após a desativação, esses públicos-alvo serão removidos de qualquer segmentação por recurso e público-alvo combinado. Se um item de linha segmenta apenas públicos-alvo desativados ou faz segmentação negativa para eles, essa atualização vai pausar 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 por público-alvo do item de linha e dos públicos-alvo combinados antes da data de descontinuação.

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

Em 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 a segmentação otimizada não está ativada nos seus itens de linha que usam essas estratégias de lances.

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, 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 todas as ordens 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 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 "Período de frequência" da coluna "Vitalício" ou "Meses" e o valor "Quantidade de frequência" da coluna "2" não serão criadas nem atualizadas no upload do arquivo.
  • 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 do 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 "true" vão retornar um erro 400.
  • As entradas nos arquivos de dados estruturados de item de linha com o valor da coluna "Tipo de estratégia de lances" como "Fixa" e o valor da coluna "Segmentação otimizada" como "Verdadeiro" não serão criadas nem atualizadas no upload do arquivo.
  • 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 item 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 item de linha usando a API Display & Video 360 ou arquivos de dados estruturados.
Atualizar para o tamanho de página padrão do firstAndThirdPartyAudiences.list 6 de março de 2025

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

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

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

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

Restrições de itens de linha de alcance do YouTube no SDF 24 de março de 2025

Em 24 de março de 2025, os arquivos de dados estruturados vão exigir o uso de formatos de anúncio mais abrangentes ao criar ou atualizar itens de linha. Isso significa que:

  • O SDF v6 e v7 não permitem mais a criação de novas entradas de arquivo de item de linha com o valor Subtype "Alcance".
  • As novas entradas nos arquivos Item de linha da SDF com o valor Subtype "Alcance" precisam usar um valor "Responsivo" na coluna TrueView Video Ad Formats. As entradas com o valor Subtype "Alcance" não podem atualizar o valor da coluna TrueView Video Ad Formats.
  • As novas entradas nos arquivos Item de linha do SDF com o valor Subtype "Alcance" exigem o preenchimento da coluna TrueView Video Ad Inventory Control.
Algoritmo de lance personalizado 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 sua integração para:

  • Verifique se as atividades relevantes do Floodlight estã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

Em 7 de abril de 2025, os recursos FirstAndThirdPartyAudience não vão mais permitir a duração infinita da associação a um 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 serão atualizados para 540,e a nova duração da assinatura será aplicada retroativamente às assinaturas atuais. Isso vai expirar todas as assinaturas com mais de 540 dias.

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 atuais como 10.000.
  • Atualize as associaçõ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 não diminua sem querer.

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

Campanhas de ação em vídeo em arquivos de dados estruturados 22 de abril de 2025

Em 22 de abril de 2025, não será mais possível criar itens de linha para campanhas de ação em vídeo usando arquivos de dados estruturados, já que eles estão sendo atualizados para a Geração de demanda. As entradas de item de linha que tentarem ser enviadas com um valor de coluna Subtype "Ação" e um valor de coluna Type "TrueView" vão falhar.

Para evitar interrupções no serviço, atualize sua integração para usar a Geração de demanda em vez de campanhas de ação em vídeo.

Exigir origem de inventário de parceiro de vídeo para itens de linha da Geração de demanda em arquivos de dados estruturados 22 de abril de 2025

A partir de 22 de abril de 2025, será necessário incluir o valor "Parceiros de vídeo" na coluna TrueView Inventory Source Targeting das entradas de item de linha que têm um valor de coluna Type de "Geração de demanda". Quando essa aplicação começar, o valor será preenchido para itens de linha atuais e incluído ao fazer o download de novos arquivos de dados estruturados.

Para evitar interrupções no serviço:

  • Atualize sua integração para incluir o valor "Parceiros de vídeo" em todas as entradas de item de linha da Geração de demanda.
  • Atualize sua integração para gerenciar fontes de inventário de Geração de demanda no nível do grupo de anúncios usando as colunas Grupo de anúncios da SDF v8.1 Demand Gen Inventory Source Strategy e Demand Gen Enabled Inventory Sources.
Coluna "Multiplicadores de lances" nos arquivos de dados estruturados de itens de linha 1° de maio de 2025

Em 1º de maio de 2025, as entradas nos arquivos de dados estruturados de item de linha que tentarem definir a coluna "Multiplicadores de lance" não vão criar nem atualizar o recurso no upload do arquivo.

Configurações de categoria de conteúdo para itens de linha do YouTube e parceiros 12 de junho de 2025

Em 12 de junho de 2025, as configurações de categoria de conteúdo para itens de linha individuais do YouTube e parceiros não poderão mais ser modificadas como parte de uma atualização da experiência de adequação da marca. Em vez disso, as configurações de categoria de conteúdo serão controladas apenas no nível do anunciante. Para acomodar essa mudança, as seguintes alterações serão feitas na API do Display & Video 360 e nos arquivos de dados estruturados:

Para evitar interrupções no serviço:
Atualizações de orçamento do item de linha com otimização do pedido de inserção 12 de junho de 2025

A partir de 12 de junho de 2025, não será mais possível atualizar as configurações de orçamento dos itens de linha com pedidos de inserção principais definidos para otimizar usando estratégias de lances automáticos.

Para evitar interrupções no serviço:
Restrições de site para arquivos de dados estruturados 12 de junho de 2025

A partir de 12 de junho de 2025, vamos remover uma restrição para URLs segmentados em entradas de SDF que impedia a inclusão de sites mais recentes. Em vez disso, o SDF vai corresponder ao comportamento da API e da interface e permitir a segmentação de URLs, desde que estejam formatados corretamente.

Isso é relevante para as colunas Site Targeting - Include e Site Targeting - Exclude nos arquivos Pedido de inserção e Item de linha.
Declarar se os itens de linha veiculam anúncios políticos da UE 8 de setembro de 2025

A partir de 8 de setembro de 2025, será necessário declarar se um item de linha vai veicular anúncios políticos da União Europeia ao criar um novo item usando a API do Display & Video 360 ou SDFs. Essas declarações podem ser feitas das seguintes maneiras:

Se o anunciante principal não tiver itens de linha que veiculam anúncios políticos da UE, você poderá fazer a declaração no nível do anunciante usando o campo containsEuPoliticalAds no recurso Advertiser da API Display & Video 360. Se esse campo for definido como DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, todos os novos itens de linha do anunciante vão receber o mesmo valor, a menos que seja especificado de outra forma. Além disso, todos os itens de linha atuais do anunciante serão atualizados para usar o mesmo valor, caso ele ainda não esteja definido. A declaração de um item de linha pode ser atualizada a qualquer momento após a criação usando a interface, a API ou o SDF.

Se você não puder fazer a declaração no nível do anunciante ou tiver declarado que anúncios políticos da UE podem ser veiculados no seu anunciante, atualize a API do Display & Video 360 e a integração do SDF antes de 8 de setembro de 2025 para evitar uma interrupção do serviço: