Esta página mostra as notas da versão da API Google Bid Manager.
Versão mais recente da API: v2
1º de março de 2025
Novos recursos
Problemas conhecidos
O relatório de disponibilidade de inventário do YouTube TrueView e as dimensões relacionadas foram desativadas, conforme anunciado anteriormente no centro de ajuda do Display & Video 360.
v2
Os seguintes valores de enumeração foram descontinuados:
Enumeração Valores ReportTypeINVENTORY_AVAILABILITYOs seguintes filtros foram descontinuados:
Filtrar valores 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 é iniciado. Isso permite a inclusão
de dados de confiança mais baixos 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.
Na inicialização, as consultas que não incluem esse filtro vão adotar o comportamento padrão anterior de incluir apenas dados de alta confiança. A partir de 4 de fevereiro de 2025, as consultas que não incluem 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: incluir dados de confiança mais baixa. (Padrão depois de 4 de fevereiro de 2025)1: incluir 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
Desativação da dimensão de relatórios do modelo de inventário anônimo (AIM)
A dimensão FILTER_ANONYMOUS_INVENTORY_MODELING é "pôr do sol".
A criação ou a execução de recursos Query
usando valores de desativaçã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 YOUTUBE.
Os seguintes valores de métrica não podem mais ser usados nos 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
A criação ou execução de 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
Desativação dos relatórios de caminho completo e de atribuição de caminho
Os relatórios de caminho completo e de atribuição de caminho foram descontinuados. A recuperação ou criação desses
tipos de recursos Query e
Report
resulta em um erro.
Os valores de
ReportType a seguir são
desativados:
FULL_PATHPATH_ATTRIBUTION
O campo
pathQueryOptions
do objeto
Options também foi
desativado.
28 de fevereiro de 2024
Novos recursos
Nenhum.
Problemas conhecidos
v2
Descontinuação dos valores da métrica de conversão em dispositivos diferentes
As métricas de conversão em dispositivos diferentes foram descontinuadas. Os seguintes valores de métrica 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.
Fiz mudanças estruturais na API, incluindo a atualização do endpoint do serviço e a renomeação de serviços e métodos.
Atualizamos significativamente os recursos de consulta e relatório, removendo campos desnecessários, reorganizando campos existentes e mudando os tipos de campo. Isso inclui a mudança de 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.
O parâmetro de consulta asynchronous queries.run foi substituído por
synchronous.
A extração de relatórios foi simplificada com as seguintes mudanças:
- Adição de um método
queries.reports.get. - 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.
As mensagens de erro atualizadas retornadas pela API são mais específicas e oferecem 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 consultas 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 de resposta queries.run Relatório Os seguintes campos foram removidos:
Recurso Campo(s) queries.listCorpo da respostakind
queries.reports.listCorpo da respostakind
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 Relatório 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íncrona 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 de versão arquivadas.