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. As adições de recursos ainda podem ser lançadas para a versão.
Descontinuação: a versão está sendo desativada, e uma data de término do suporte (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 é mais compatível. As solicitações feitas para a versão retornam um erro.
A tabela abaixo lista todas as versões principais da API Display & Video 360, as datas de lançamento, as datas de descontinuação e de desativação, se anunciadas.
A tabela abaixo lista todas as descontinuações de recursos anunciadas, fornecendo o início da vigência e uma descrição da suspensão de uso com ações recomendadas e links para a documentação relevante:
Engenharia 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 no comportamento da API Display & Video 360 e dos arquivos de dados estruturados, assim como as ações recomendadas, foram anunciadas em uma postagem do blog.
Gatilhos manuais
17 de maio de 2023
Linha do tempo:
17 de maio de 2023: os itens de linha que usam acionadores manuais não serão mais 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 veiculará anúncios.
App instalado e dispositivos móveis novos GoogleAudience Tipos
20 de maio de 2023
Linha do tempo:
20 de maio de 2023: não será mais possível atribuir recursos do GoogleAudience com GoogleAudienceType de GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS ou GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES à segmentação por público-alvo de item de linha ou pedido de inserção. As solicitações de atribuição desses públicos-alvo à segmentação por público-alvo de um item de linha vão retornar um erro. Isso inclui 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, ele será pausado. A partir dessa 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 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 do item de linha e do pedido de inserção. Saiba como atualizar a segmentação por público-alvo no guia "Públicos-alvo".
20 de maio de 2023: não será mais possível atribuir recursos do FirstAndThirdPartyAudience com AudienceType de ACTIVITY_BASED ou FREQUENCY_CAP à segmentação por público-alvo de item de linha ou pedido de inserção. As solicitações de atribuição desses públicos-alvo à segmentação por público-alvo de um item de linha vão retornar um erro. Isso inclui 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, ele será pausado. A partir dessa 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 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 do item de linha e do pedido de inserção. Saiba como atualizar a segmentação por público-alvo no guia "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 cotas híbrida que:
Elimina a cota de solicitações por dia e por projeto.
Cria uma cota de solicitações por minuto, por anunciante e por projeto para métodos de qualificação.
Esses novos limites permitirão maior flexibilidade no uso da API e permitirão o carregamento de solicitações em paralelo entre os anunciantes. Os detalhes dessa mudança estão na documentação atual sobre limite de cota.
Uso do operador OR entre restrições de campos diferentes em filtros LIST
June 21, 2023
A partir de 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, 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 1o de agosto de 2023, os pedidos de inserção que usam a compra com base em resultados, definidos por um valor de campo de 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:
A tentativa de usar advertisers.insertionOrders.create para criar um pedido de inserção usando a compra com base em resultados retornará um erro 400.
