Suspensão de uso anunciada

Esta página lista as datas de suspensão de uso e desativação da API versões e recursos individuais da Rede de Display e API Video 360.

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

Descontinuações de versões

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

  • Versão: a versão sai de todos os status Alfa ou Beta e é considerada o estábulo. Adições de recursos ainda podem ser lançadas para essa versão.
  • Descontinuação: a versão está sendo desativada e o suporte não será mais oferecido. quando a data for anunciada. Os usuários precisam migrar para uma versão mais recente antes da desativação data. As adições de recursos não serão mais lançadas para essa versão.
  • Desativação: a versão não é mais compatível. Solicitações feitas à versão retornar um erro.

A tabela abaixo lista todos os principais produtos de Display & Versões da API Video 360, o lançamento e as datas de suspensão de uso e desativação, caso sejam 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 o blog do desenvolvedor do Google Ads para ver anúncios de futuras descontinuações de recursos significativos.

A tabela abaixo lista todas as descontinuações de recursos anunciadas, incluindo as o início da vigência e uma descrição da descontinuação, com ações recomendadas e links para documentação relevante:

Recurso Início da vigência 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. Alterações relevantes na Rede de Display e O comportamento dos arquivos de dados estruturados e da API Video 360, bem como as ações recomendadas, foram anunciados em uma postagem do blog.
Gatilhos manuais 17 de maio de 2023

Cronograma:

  • 17 de maio de 2023: os itens de linha que usam acionadores manuais não serão mais veiculados nos anúncios de display e Vídeo em 360°. Se você ativar um acionador manual vinculado a um item de linha ativo após essa data, o item de linha não veiculará anúncios.
  • 1o 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 vão ser desativados. Depois dessa data, as solicitações feitas a esses serviços ou a esses 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 vai ser mais possível atribuir recursos do 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 atribuirem esses públicos à segmentação por público-alvo de um item de linha retornarão um erro. Isso incluirá as solicitações 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 todas as segmentações 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, eles serão pausados. A partir dessa data, também não será mais possível acessar esses públicos-alvo usando o serviço googleAudiences.

Tarefas recomendadas:

  • Recomendamos que você pare imediatamente de usar 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 existente de itens de linha e pedidos de inserção. Leia sobre como atualizar a segmentação por público-alvo no nosso guia de públicos-alvo.
Tipos de FirstAndThirdPartyAudience com base em atividade e limite de frequência 20 de maio de 2023

Cronograma:

  • 20 de maio de 2023: não vai ser mais possível atribuir recursos do 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 atribuirem esses públicos-alvo à segmentação por público-alvo de um item de linha vão retornar um erro. Isso incluirá as solicitações 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 todas as segmentações 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, eles serão pausados. Nessa data, também não será mais possível acessar esses públicos-alvo usando o serviço firstAndThirdPartyAudiences.

Tarefas recomendadas:

  • Recomendamos que você pare imediatamente de usar 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 existente de itens de linha e pedidos de inserção. Leia sobre como atualizar a segmentação por público-alvo no nosso guia de públicos-alvo.
Limites de cota de API existentes 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 com as seguintes ações:

  1. Elimina a cota de solicitações diárias e por projeto.
  2. Institui uma cota de solicitações por minuto, por anunciante e por projeto para métodos de qualificação.

Com os novos limites, é possível ter maior flexibilidade no uso da API e o carregamento em paralelo de solicitações entre os anunciantes. Você encontra mais detalhes sobre essa mudança na documentação sobre o limite de cota atual.

Uso do operador OR entre restrições de campos diferentes nos 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 instruções sobre como filtrar solicitações LIST para mais detalhes sobre as restrições dos operadores lógicos.

Revise os parâmetros de consulta filter de todas as chamadas LIST atuais 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 atualizada

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. Depois dessa 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 que usa esses dois campos antes de 21 de junho de 2023 para evitar a interrupção do serviço.

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

A partir de 21 de junho de 2023, não será mais possível filtrar os seguintes campos no advertisers.lineItems.list:

  • 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

A partir de 1o de agosto de 2023, os pedidos de inserção que usam 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 deles 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 estará vazio durante a recuperação de recursos Creative.

Subconjunto de segmentação de conteúdo para YouTube e Itens de linha de parceiros 30 de setembro de 2024

Em 30 de setembro de 2024, os seguintes valores para os tipos de segmentação serão desativados no YouTube e Itens de linha de parceiros:

A desativação das opções de segmentação será automaticamente removida da segmentação do item de linha existente.

Para evitar a interrupção do serviço, remova essa segmentação de todos os canais existentes do YouTube Itens de linha dos parceiros antes da data de desativação.

Públicos-alvo próprios e de terceiros do 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 a desativação, esses públicos-alvo serão removidos de todas as segmentações por recursos e públicos-alvo combinados existentes. Se um item de linha segmentar somente os públicos-alvo desativados ou segmentar negativamente aqueles relacionados, a atualização pausará automaticamente esse item de linha.

Para evitar interrupção do serviço, identifique e remova 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 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 do 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 do 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 a interrupção do 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

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

Para evitar a interrupção do serviço, atualize o pacing dos pedidos de inserção existentes que usam PACING_TYPE_ASAP e PACING_PERIOD_FLIGHT.