Rede de Display e A API Video 360 v2 foi descontinuada. Use o Display & Video 360 API v3. Para ver as instruções de migração da v2 para a v3, consulte nosso guia de migraçã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:
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.
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.
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.
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:
Elimina as solicitações por dia por cota de projeto.
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:
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.
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:
Tentar usar advertisers.insertionOrders.create para criar um pedido de inserção usando a compra com base em resultados vai retornar um erro 400
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
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
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
As entradas em arquivos de dados estruturados de item de linha que tentam atualizar a coluna "IDs de atividade do Floodlight de conversão" quando a coluna "ID do algoritmo" está definida não vão ser atualizadas no upload do arquivo.
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.
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 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.
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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-02-28 UTC."],[[["This page provides a schedule of deprecation and sunset dates for Display & Video 360 API versions and features."],["Display & Video 360 API versions are regularly released, deprecated, and eventually sunset; users should migrate to newer versions before the sunset date to avoid service disruptions."],["The page includes tables outlining version and feature deprecations, with details on timelines, descriptions, and recommended actions for each."],["Users should regularly consult this page and the Google Ads developer blog for announcements and updates to stay informed about upcoming changes and ensure a smooth transition."]]],[]]