Esta página apresenta notas da versão para a API Google Bid Manager.
Versão mais recente da API: v2
22 de setembro de 2025
Problemas conhecidos
Desativação de três valores de enumeração Filter devido ao baixo uso, conforme anunciado anteriormente na Central de Ajuda do Display & Video 360.
v2
Os seguintes
Filtersforam descontinuados:Valor(es) de FilterFILTER_DFP_ORDER_IDFILTER_INSERTION_ORDERFILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED_PARTNER
1º de março de 2025
Problemas conhecidos
Desativação do relatório de disponibilidade de inventário do YouTube TrueView e das dimensões relacionadas, conforme anunciado anteriormente na Central de Ajuda do Display & Video 360.
v2
Os seguintes valores de enumeração foram descontinuados:
Enumeração Valores ReportTypeINVENTORY_AVAILABILITYOs seguintes filtros foram descontinuados:
Valores do filtro FILTER_DETAILED_DEMOGRAPHICSFILTER_DETAILED_DEMOGRAPHICS_IDFILTER_HOUSEHOLD_INCOMEFILTER_LIFE_EVENTFILTER_REMARKETING_LISTFILTER_TRUEVIEW_IAR_AGEFILTER_TRUEVIEW_IAR_CATEGORYFILTER_TRUEVIEW_IAR_CITYFILTER_TRUEVIEW_IAR_COUNTRYFILTER_TRUEVIEW_IAR_COUNTRY_NAMEFILTER_TRUEVIEW_IAR_GENDERFILTER_TRUEVIEW_IAR_INTERESTFILTER_TRUEVIEW_IAR_LANGUAGEFILTER_TRUEVIEW_IAR_PARENTAL_STATUSFILTER_TRUEVIEW_IAR_REGION_NAMEFILTER_TRUEVIEW_IAR_REMARKETING_LISTFILTER_TRUEVIEW_IAR_TIME_OF_DAYFILTER_TRUEVIEW_IAR_YOUTUBE_CHANNELFILTER_TRUEVIEW_IAR_YOUTUBE_VIDEOFILTER_TRUEVIEW_IAR_ZIPCODEFILTER_YOUTUBE_CHANNELFILTER_YOUTUBE_VIDEOAs seguintes métricas foram descontinuadas:
Valores de métricas METRIC_POTENTIAL_VIEWSMETRIC_TEA_TRUEVIEW_IMPRESSIONSMETRIC_TEA_TRUEVIEW_UNIQUE_COOKIES
20 de novembro de 2024
Novos recursos
O FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID é lançado. Isso permite a inclusão de dados de menor confiança para métricas com os seguintes prefixos:
METRIC_UNIQUE_REACH_METRIC_VIRTUAL_PEOPLE_DUPLICATE_METRIC_VIRTUAL_PEOPLE_EXCLUSIVE_METRIC_VIRTUAL_PEOPLE_OVERLAP_
Uma das métricas relevantes precisa ser incluída ao usar esse filtro.
No lançamento, as consultas que não incluírem esse filtro vão usar o comportamento padrão anterior, que incluía apenas dados de alta confiança. A partir de 4 de fevereiro de 2025, as consultas que não incluírem esse filtro vão incluir dados de menor confiança por padrão.
v2
Os seguintes filtros foram adicionados:
Tipo de filtro Valores disponíveis FILTER_UNIQUE_REACH_SAMPLE_SIZE_ID0: inclua dados de confiança mais baixa. (Padrão após 4 de fevereiro de 2025)1: inclui apenas dados de alta confiança. (Padrão antes de 4 de fevereiro de 2025)
1° de outubro de 2024
Novos recursos
Nenhum.
Problemas conhecidos
v2
Descontinuação da dimensão de relatórios de modelagem de inventário anônimo (AIM)
A dimensão FILTER_ANONYMOUS_INVENTORY_MODELING foi desativada.
A criação ou execução de recursos Query
usando valores de descontinuação em
params.groupBy
retorna um erro 400.
As métricas de DST/ROC (custos operacionais regulatórios) e de custo de mídia total não são compatíveis com os relatórios do YOUTUBE.
Os seguintes valores de métricas não podem mais ser usados em relatórios YOUTUBE:
METRIC_TOTAL_MEDIACOST_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPC_PARTNERMETRIC_TOTAL_MEDIACOST_ECPAPC_USDMETRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPAPV_PARTNERMETRIC_TOTAL_MEDIACOST_ECPAPV_USDMETRIC_TOTAL_MEDIACOST_ECPA_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPA_PARTNERMETRIC_TOTAL_MEDIACOST_ECPA_USDMETRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPCV_PARTNERMETRIC_TOTAL_MEDIACOST_ECPCV_USDMETRIC_TOTAL_MEDIACOST_ECPC_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPC_PARTNERMETRIC_TOTAL_MEDIACOST_ECPC_USDMETRIC_TOTAL_MEDIACOST_ECPM_ADVERTISERMETRIC_TOTAL_MEDIACOST_ECPM_PARTNERMETRIC_TOTAL_MEDIACOST_ECPM_USDMETRIC_TOTAL_MEDIACOST_PARTNERMETRIC_TOTAL_MEDIACOST_USDMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISERMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNERMETRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USDMETRIC_FEE32_ADVERTISERMETRIC_FEE32_PARTNERMETRIC_FEE32_USD
Criar ou executar recursos Query com um params.type de YOUTUBE e um valor de métrica relevante em params.metrics retorna um erro 400.
1º de maio de 2024
Novos recursos
Nenhum.
Problemas conhecidos
v2
Descontinuação dos relatórios de caminho completo e atribuição de caminho
Os relatórios de caminho completo e de atribuição de caminho foram desativados. A recuperação ou criação desses tipos de recursos Query e Report resulta em um erro.
Os seguintes valores de ReportType estão em descontinuação:
FULL_PATHPATH_ATTRIBUTION
O campo
pathQueryOptions
do objeto
Options também está
em descontinuação.
28 de fevereiro de 2024
Novos recursos
Nenhum.
Problemas conhecidos
v2
Descontinuação dos valores de métricas de conversão em dispositivos diferentes
As métricas de conversão em dispositivos diferentes foram desativadas. Os seguintes valores de métricas da API Bid Manager estão incluídos:
METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENTMETRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENTMETRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENTMETRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENTMETRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT
6 de julho de 2022
Novos recursos
Lançamos a API Bid Manager v2.
Fizemos mudanças estruturais na API, incluindo a atualização do endpoint de serviço e a renomeação de serviços e métodos.
Atualização significativa dos recursos Query e Report com a remoção de campos desnecessários, a reorganização dos campos atuais e a mudança dos tipos de campo. Isso inclui mudar os tipos de campo para usar objetos nomeados em vez de uma definição geral de "objeto aninhado".
É necessário executar consultas ad hoc usando o método queries.run
em vez de executá-las automaticamente após a criação.
Substituímos o parâmetro de consulta queries.run asynchronous por
synchronous.
Recuperação simplificada de relatórios com as seguintes mudanças:
- A adição de um método
queries.reports.get. - A adição de um parâmetro de consulta
orderByaqueries.reports.list. - A atualização do corpo da resposta
queries.runde um objeto vazio para uma instância do recursoReportgerado.
Atualizamos as mensagens de erro retornadas pela API para serem mais específicas e oferecer soluções mais prescritivas.
Siga as instruções apresentadas no Guia de migração da v2 para migrar da v1.1 para a v2.
v2
O endpoint do serviço foi alterado:
Endpoint de serviço v1 Endpoint de serviço v2 https://www.googleapis.com/doubleclickbidmanagerhttps://doubleclickbidmanager.googleapis.comOs serviços foram renomeados da seguinte forma:
Serviço v1 Serviço v2 Consultas queries Relatórios queries.reports Os métodos foram renomeados da seguinte forma:
Os seguintes métodos foram adicionados:
Serviço Métodos queries.reports get Os seguintes métodos têm um novo corpo de resposta:
Método Novo objeto de corpo da resposta queries.run Denuncie Os seguintes campos foram removidos:
Recurso Campo(s) Corpo da resposta queries.listkind
Corpo da resposta queries.reports.listkind
Consulta kind
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
O tipo de objeto dos seguintes campos foi alterado para:
Recurso Campo(s) Tipo de objeto Consulta Denuncie RunQueryRequest Os seguintes parâmetros de consulta de método foram adicionados:
Método Parâmetros de consulta queries.list orderBy queries.reports.list orderBy queries.run síncrono Os seguintes parâmetros de consulta de método foram removidos:
Método Parâmetros de consulta queries.create assíncrono queries.run assíncrono Os seguintes valores de filtro foram adicionados:
Valor do filtro FILTER_INVENTORY_MEDIA_COST_TYPE FILTER_TARGETING_EXPANSION Os seguintes valores de filtro foram removidos:
Valor do filtro FILTER_TRUEVIEW_IAR_REGION Os seguintes valores de métrica foram adicionados:
Valor métrico METRIC_STORE_VISIT_VIEW_THROUGH_CONVERSIONS METRIC_UNIQUE_REACH_AVERAGE_VIEWABLE_IMPRESSION_FREQUENCY METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_CROSS_STACK_FCAP METRIC_UNIQUE_REACH_IMPRESSION_REACH_ADDED_WITH_PG_FMGMT METRIC_UNIQUE_REACH_INCREMENTAL_CLICK_REACH METRIC_UNIQUE_REACH_INCREMENTAL_IMPRESSION_REACH METRIC_UNIQUE_REACH_INCREMENTAL_TOTAL_REACH METRIC_UNIQUE_REACH_INCREMENTAL_VIEWABLE_IMPRESSION_REACH METRIC_UNIQUE_REACH_VIEWABLE_IMPRESSION_REACH
Problemas conhecidos
Nenhum.
Versões anteriores
Para ler sobre versões anteriores da API Bid Manager para versões desativadas, consulte nossas notas da versão arquivadas.