Suspensão de uso anunciada

Nesta página, listamos as datas de descontinuação e desativação das versões da API e dos recursos individuais na API Display & Video 360.

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

Descontinuações de versão

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

• Versão: a versão sai de qualquer status Alfa ou Beta e é considerada estável. Ainda é possível lançar novos recursos para a versão.
• Descontinuação: 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. Não serão mais lançadas adições de recursos para a versão.
• Desativação: 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 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
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 para desenvolvedores do Google Ads para receber avisos sobre as próximas descontinuações de recursos importantes.

Esta tabela lista todas as descontinuações de recursos anunciadas que afetam as versões ativas, fornecendo o início da vigência e uma descrição da descontinuação com ações recomendadas e links para a documentação relevante:

Recurso	Início da Vigência Inicial	Descrição
Valores de nome e logo da empresa obrigatórios para anúncios responsivos do YouTube Início da vigência inicial atualizado	Janeiro de 2027	Em janeiro de 2027, os recursos de nome e logo da empresa serão obrigatórios para anúncios responsivos do YouTube se um valor padrão não for definido para o anunciante. Como resultado, as colunas Business Name e Logo Asset IDs nos SDFs de anúncio precisarão ser definidas para anúncios do tipo "Responsivo" se os valores padrão não forem atribuídos ao anunciante principal. Se um valor padrão for atribuído e a coluna for deixada em branco, o anúncio vai herdar os padrões do anunciante ao ser salvo.
Descontinuação da exclusão de categorias sensíveis	1º de outubro de 2026	A partir de 1º de outubro de 2026, não será mais possível excluir a maioria das categorias sensíveis ao atribuir a segmentação do item de linha. Para acomodar essa mudança, as seguintes alterações serão feitas na API Display & Video 360 e nos arquivos de dados estruturados: Os seguintes valores de tipo enumerado SensitiveCategory serão descontinuados e não serão mais aceitos no campo excludedSensitiveCategory do objeto SensitiveCategoryAssignedTargetingOptionDetails ao atribuir segmentação do tipo TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION: SENSITIVE_CATEGORY_ADULT SENSITIVE_CATEGORY_ALCOHOL SENSITIVE_CATEGORY_DEROGATORY SENSITIVE_CATEGORY_DOWNLOADS_SHARING SENSITIVE_CATEGORY_DRUGS SENSITIVE_CATEGORY_GAMBLING SENSITIVE_CATEGORY_POLITICS SENSITIVE_CATEGORY_PROFANITY SENSITIVE_CATEGORY_RELIGION SENSITIVE_CATEGORY_SENSITIVE_SOCIAL_ISSUES SENSITIVE_CATEGORY_SHOCKING SENSITIVE_CATEGORY_SUGGESTIVE SENSITIVE_CATEGORY_TOBACCO SENSITIVE_CATEGORY_TRAGEDY SENSITIVE_CATEGORY_TRANSPORTATION_ACCIDENTS SENSITIVE_CATEGORY_VIOLENCE SENSITIVE_CATEGORY_WEAPONS A coluna Brand Safety Sensitivity Setting nos SDFs de item de linha não vai mais permitir a opção "Usar personalizado". A coluna Brand Safety Custom Settings nos SDFs de item de linha não será mais aceita e será preenchida com um valor vazio no download.
Descontinuação da exclusão de classificação de conteúdo digital	1º de outubro de 2026	A partir de 1º de outubro de 2026, não será mais possível excluir classificações de conteúdo digital específicas usando a segmentação. Para acomodar essa mudança, as seguintes alterações serão feitas na API Display & Video 360 e nos arquivos de dados estruturados: Os seguintes valores de tipo enumerado ContentRatingTier serão descontinuados e não serão mais aceitos no campo excludedContentRatingTier do objeto DigitalContentLabelAssignedTargetingOptionDetails ao atribuir segmentação do tipo TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION: CONTENT_RATING_TIER_FAMILIES CONTENT_RATING_TIER_GENERAL CONTENT_RATING_TIER_MATURE CONTENT_RATING_TIER_PARENTAL_GUIDANCE CONTENT_RATING_TIER_TEENS CONTENT_RATING_TIER_UNSPECIFIED A coluna Digital Content Labels - Exclude nos SDFs de item de linha só permite a atribuição da opção "?". Caso contrário, ela precisa ficar vazia. A tentativa de atribuir qualquer outro valor resultará em um erro no upload.
Nielsen como fornecedor terceirizado que mede o Brand Lift	13 de julho de 2026	A partir de 13 de julho de 2026, a Nielsen não poderá mais ser atribuída como fornecedor terceirizado para medir o Brand Lift. Para acomodar essa mudança, as seguintes alterações serão feitas na API Display & Video 360 e nos arquivos de dados estruturados: O valor de tipo enumerado THIRD_PARTY_VENDOR_NIELSEN de ThirdPartyVendor não será mais aceito no recurso LineItem no campo de objeto brandLiftVendorConfigs.vendor de ThirdPartyMeasurementConfigs. A coluna TrueView Third-Party Brand Lift Vendor nos SDFs de item de linha não vai mais permitir a opção "Nielsen". O uso da Nielsen como fornecedor de Brand Lift será removido. Para evitar uma interrupção do serviço, remova qualquer atribuição da Nielsen como fornecedor de Brand Lift da sua integração.
Herança do nome e do logotipo padrão da empresa	13 de julho de 2026	A partir de 13 de julho de 2026, os anúncios responsivos do YouTube vão aceitar recursos de nome e logo da empresa. Além disso, todos os anúncios responsivos de Geração de Demanda e do YouTube sem esses recursos vão herdar os valores padrão definidos no nível do anunciante. Ao mesmo tempo, essa mudança vai causar as seguintes alterações no comportamento da API Display & Video 360 e dos arquivos de dados estruturados: Os campos businessName, logo e logoImages nos recursos AdGroupAd da Geração de Demanda ad_details não serão mais obrigatórios se os valores padrão forem atribuídos ao anunciante principal. Se não for fornecido, o anúncio vai herdar os padrões do anunciante. As colunas Business Name e Logo Asset IDs nos SDFs de anúncio poderão ser definidas para anúncios com qualquer um dos seguintes tipos: "Responsivo", "Produto da Geração de Demanda", "Vídeo da Geração de Demanda", "Imagem da Geração de Demanda" e "Carrossel da Geração de Demanda". Se essas colunas não forem definidas para uma entrada de anúncio relevante e os valores padrão forem atribuídos ao anunciante principal, o anúncio vai herdar os padrões do anunciante ao ser salvo. As colunas Business Name e Logo Asset IDs nos SDFs de anúncio não são mais obrigatórias para anúncios da Geração de Demanda se o anunciante principal tiver atribuído valores padrão. Se os valores padrão forem definidos no nível do anunciante, todos os anúncios dele terão um nome e um logotipo atribuídos. Se você quiser deixar os valores dos recursos de nome e logo da empresa sem definição para anúncios responsivos do YouTube, não defina valores padrão para seu anunciante.
Gerenciamento de pedidos de inserção e segmentação de campanhas na API Display & Video 360 e nos arquivos de dados estruturados	23 de fevereiro de 2026	Em 23 de fevereiro de 2026, o Display & Video 360 vai desativar a segmentação de pedidos de inserção e campanhas. A API Display & Video 360 e os arquivos de dados estruturados (SDFs, na sigla em inglês) serão modificados para se alinhar a essa mudança. Na API Display & Video 360, um subconjunto de métodos será desativado e retornará um erro se for chamado. No SDF, as colunas de segmentação nos arquivos de pedido de inserção e campanha não serão mais preenchidas no download e precisarão estar vazias no upload. Recomendamos que os usuários atribuam a segmentação diretamente aos itens de linha no momento da criação. Os seguintes métodos da API Display & Video 360 vão retornar um erro 404 se forem chamados: advertisers.campaigns.listAssignedTargetingOptions advertisers.campaigns.targetingTypes.assignedTargetingOptions.get advertisers.campaigns.targetingTypes.assignedTargetingOptions.list advertisers.insertionOrders.listAssignedTargetingOptions advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.create advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.delete advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.get advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list advertisers.lineItems.generateDefault As entradas de SDF de campanha com valores atribuídos às seguintes colunas vão falhar no upload: Demographic Targeting Gender Demographic Targeting Age Demographic Targeting Household Income Demographic Targeting Parental Status Geography Targeting - Include Geography Targeting - Exclude Language Targeting - Include Language Targeting - Exclude Digital Content Labels - Exclude Brand Safety Sensitivity Setting Brand Safety Custom Settings Third Party Verification Services Third Party Verification Labels Viewability Targeting Active View Position Targeting - Display On Screen Position Targeting - Video On Screen Position Targeting - Display Position In Content Position Targeting - Video Position In Content Inventory Source Targeting - Authorized Seller Options Inventory Source Targeting - Include Inventory Source Targeting - Exclude Inventory Source Targeting - Target New Exchanges Environment Targeting As entradas de SDF de pedido de inserção com valores atribuídos às seguintes colunas vão falhar no upload: Geography Targeting - Include Geography Targeting - Exclude Proximity Targeting Proximity Location List Targeting Language Targeting - Include Language Targeting - Exclude Device Targeting - Include Device Targeting - Exclude Browser Targeting - Include Browser Targeting - Exclude Digital Content Labels - Exclude Brand Safety Sensitivity Setting Brand Safety Custom Settings Third Party Verification Services Third Party Verification Labels Channel Targeting - Include Channel Targeting - Exclude Site Targeting - Include Site Targeting - Exclude App Targeting - Include App Targeting - Exclude App Collection Targeting - Include App Collection Targeting - Exclude Category Targeting - Include Category Targeting - Exclude Content Genre Targeting - Include Content Genre Targeting - Exclude Keyword Targeting - Include Keyword Targeting - Exclude Keyword List Targeting - Exclude Audience Targeting - Include Audience Targeting - Exclude Affinity & In Market Targeting - Include Affinity & In Market Targeting - Exclude Custom List Targeting Inventory Source Targeting - Authorized Seller Options Inventory Source Targeting - Include Inventory Source Targeting - Exclude Inventory Source Targeting - Target New Exchanges Daypart Targeting Daypart Targeting Time Zone Environment Targeting Viewability Omid Targeting Enabled Viewability Targeting Active View Position Targeting - Display On Screen Position Targeting - Video On Screen Position Targeting - Display Position In Content Position Targeting - Video Position In Content Position Targeting - Audio Position In Content Video Player Size Targeting Content Duration Targeting Content Stream Type Targeting Audio Content Type Targeting Demographic Targeting Gender Demographic Targeting Age Demographic Targeting Household Income Demographic Targeting Parental Status Connection Speed Targeting Carrier Targeting - Include Carrier Targeting - Exclude
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, você precisará declarar se um item de linha vai veicular anúncios políticos da União Europeia ao criar um novo item de linha usando a API Display & Video 360 ou SDFs. Essas declarações podem ser feitas das seguintes maneiras: Usando o campo containsEuPoliticalAds no recurso LineItem da API Display & Video 360. Também é possível fazer essa declaração usando novos campos nas solicitações advertisers.lineItems.duplicate e advertisers.lineItems.generateDefault. Usando a coluna Contains EU Political Ads no tipo de arquivo Item de linha do SDF v9. Se o anunciante principal não tiver itens de linha que veiculem 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, e todos os itens de linha atuais do anunciante serão atualizados para usar o mesmo valor, se ainda não houver um 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 não for possível fazer a declaração no nível do anunciante ou se você tiver declarado que anúncios políticos da UE podem ser veiculados pelo seu anunciante, atualize a API Display & Video 360 e a integração com SDF antes de 8 de setembro de 2025 para evitar uma interrupção do serviço: Defina o campo containsEuPoliticalAds em um novo recurso LineItem ao fazer uma solicitação advertisers.lineItems.create. Defina o campo containsEuPoliticalAds no corpo da solicitação de qualquer solicitação advertisers.lineItems.duplicate e advertisers.lineItems.generateDefault. Migre para usar os arquivos de dados estruturados v9 e defina a coluna Contains EU Political Ads para todos os novos itens de linha como Yes ou No no upload. Consulte nosso guia de migração da v9 para ver instruções detalhadas. Antes de atualizar a segmentação geográfica de um item de linha usando a API Display & Video 360 ou o SDF, atualize o item de linha para fornecer uma declaração.
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 Display & Video 360 e nos arquivos de dados estruturados: O campo contentCategory em objetos YoutubeAndPartnersSettings de recursos LineItem do YouTube e parceiros não será mais atualizado. Ele será removido por completo em uma data posterior. A coluna TrueView Content Filter nos SDFs de item de linha não será mais gravável. Para evitar interrupções no serviço: Recupere o campo effectiveContentCategory em vez de contentCategory ao analisar itens de linha do YouTube e parceiros na API. Pare de modificar a coluna TrueView Content Filter ao atualizar as entradas de item de linha do SDF. Mantenha a coluna vazia ao criar itens de linha.
Atualizações do orçamento do item de linha com a 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 de itens de linha com pedidos de inserção pai definidos para otimização usando estratégias de lances automáticas. Para evitar interrupções no serviço: Na API: verifique se o InsertionOrder principal de um item de linha tem bidStrategy.maximizeSpendAutoBid ou bidStrategy.performanceGoalAutoBid definido. Se sim, não tente atualizar o campo de orçamento LineItem usando advertisers.lineItems.patch. No SDF: verifique se a entrada do SDF para o pedido de inserção pai do item de linha tem a coluna Insertion Order Optimization definida como TRUE. Se sim, não tente atualizar as colunas Budget Type ou Budget Amount para a entrada do SDF do item de linha.
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 existente para segmentação por URL 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.
Coluna "Multiplicadores de lance" nos arquivos de dados estruturados do item de linha	1° de maio de 2025	Em 1º de maio de 2025, as entradas nos arquivos de dados estruturados de itens de linha que tentarem definir a coluna "Multiplicadores de lance" não vão conseguir criar ou atualizar o recurso no upload do arquivo.
Exigir origem de inventário de parceiros 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á obrigató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 restrição começar, o valor será preenchido para os 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 itens de linha da Geração de Demanda. Atualize sua integração para gerenciar as origens de inventário da Geração de Demanda no nível do grupo de anúncios usando as colunas Demand Gen Inventory Source Strategy e Demand Gen Enabled Inventory Sources do grupo de anúncios do SDF v8.1.
Campanhas de ação em vídeo em arquivos de dados estruturados	22 de abril de 2025	A partir de 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 de "Ação" e um valor de coluna Type de "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.
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 uma duração infinita da associação ao público-alvo. As solicitações firstAndThirdPartyAudiences.create e firstAndThirdPartyAudiences.patch que definirem 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 associação será aplicada retroativamente às associações atuais. Isso vai expirar todas as associações 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 segmentados 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.
Incompatibilidade entre o algoritmo de lances personalizados e as atividades do Floodlight	1º de abril de 2025	Em 1º de abril de 2025: As solicitações advertisers.lineItems.create que tentarem definir o campo floodlightActivityConfigs do objeto ConversionCountingConfig e o campo customBiddingAlgorithmId dos objetos MaximizeSpendBidStrategy ou PerformanceGoalBidStrategy que não usam atividades do Floodlight correspondentes vão retornar um erro 400. As solicitações advertisers.lineItems.patch que tentarem atualizar o campo floodlightActivityConfigs do objeto ConversionCountingConfig enquanto o campo customBiddingAlgorithmId dos objetos MaximizeSpendBidStrategy ou PerformanceGoalBidStrategy estiver definido vão retornar um erro 400. As entradas nos arquivos de dados estruturados de item de linha que tentarem atualizar a coluna "IDs de atividade do Floodlight de conversão" quando a coluna "ID do algoritmo" estiver definida não serão atualizadas no upload do arquivo. As solicitações customBiddingAlgorithms.patch, customBiddingAlgorithms.rules.create e customBiddingAlgorithms.scripts.create para recursos CustomBiddingAlgorithm atribuídos a um item de linha vão retornar um erro. 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 desatribuídos de todos os itens de linha antes de serem atualizados.

Descontinuações de recursos anteriores

Para ler sobre as descontinuações anunciadas que afetam as versões desativadas da API Display & Video 360, consulte nossas descontinuações arquivadas.