Esta página fornece notas da versão da API Google Bid Manager.
Versão mais recente da API: v2
1o de outubro de 2024
Novos recursos
Nenhum.
Problemas conhecidos
v2
Desativação da dimensão de relatório do modelo de inventário anônimo (AIM, na sigla em inglês)
A dimensão FILTER_ANONYMOUS_INVENTORY_MODELING
será desativada.
Criar ou executar Query
usando valores de desativação
params.groupBy
retorna um erro 400
.
As métricas de DST/ROC (custo operacional regulatório) e de custo de mídia total são incompatíveis com os relatórios do YOUTUBE
.
Os seguintes valores de métrica não podem mais ser usados em relatórios de YOUTUBE
:
METRIC_TOTAL_MEDIACOST_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPAPC_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPAPC_PARTNER
METRIC_TOTAL_MEDIACOST_ECPAPC_USD
METRIC_TOTAL_MEDIACOST_ECPAPV_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPAPV_PARTNER
METRIC_TOTAL_MEDIACOST_ECPAPV_USD
METRIC_TOTAL_MEDIACOST_ECPA_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPA_PARTNER
METRIC_TOTAL_MEDIACOST_ECPA_USD
METRIC_TOTAL_MEDIACOST_ECPCV_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPCV_PARTNER
METRIC_TOTAL_MEDIACOST_ECPCV_USD
METRIC_TOTAL_MEDIACOST_ECPC_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPC_PARTNER
METRIC_TOTAL_MEDIACOST_ECPC_USD
METRIC_TOTAL_MEDIACOST_ECPM_ADVERTISER
METRIC_TOTAL_MEDIACOST_ECPM_PARTNER
METRIC_TOTAL_MEDIACOST_ECPM_USD
METRIC_TOTAL_MEDIACOST_PARTNER
METRIC_TOTAL_MEDIACOST_USD
METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_ADVERTISER
METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_PARTNER
METRIC_TOTAL_MEDIACOST_VIEWABLE_ECPM_USD
METRIC_FEE32_ADVERTISER
METRIC_FEE32_PARTNER
METRIC_FEE32_USD
Criar ou executar Query
os recursos com um
params.type
de
YOUTUBE
e um valor de métrica relevante em
params.metrics
retorna um erro 400
.
1o de maio de 2024
Novos recursos
Nenhum.
Problemas conhecidos
v2
Desativação dos relatórios de caminho completo e atribuição de caminho
Os Relatórios de caminho completo e de atribuição de caminho serão desativados. Recuperar ou criar esses
tipos de Query
e
Report
recursos
resulta em erro.
O seguinte
Valores ReportType
são
pôr do sol:
FULL_PATH
PATH_ATTRIBUTION
A
pathQueryOptions
da tag
O objeto Options
também está
pôr do sol.
28 de fevereiro de 2024
Novos recursos
Nenhum.
Problemas conhecidos
v2
Desativação dos valores da métrica de conversão em dispositivos diferentes
Conversão em dispositivos diferentes . A seguinte métrica da API Bid Manager valores estão incluídos:
METRIC_CM360_POST_CLICK_REVENUE_CROSS_ENVIRONMENT
METRIC_CM360_POST_VIEW_REVENUE_CROSS_ENVIRONMENT
METRIC_POST_CLICK_CONVERSIONS_CROSS_ENVIRONMENT
METRIC_POST_VIEW_CONVERSIONS_CROSS_ENVIRONMENT
METRIC_TOTAL_CONVERSIONS_CROSS_ENVIRONMENT
6 de julho de 2022
Novos recursos
Lançamento da API Bid Manager v2.
Foram feitas mudanças estruturais na API, incluindo atualização do serviço e renomeando serviços e métodos.
Foram atualizados significativamente os recursos de Consulta e Relatório Remoção de campos desnecessários, reorganização dos campos existentes e alteração de campos tipos Isso inclui alterar os tipos de campo para usar objetos nomeados em vez de um "objeto aninhado" geral definição.
Exigência da execução de consultas ad hoc usando o método queries.run
em vez de serem executadas automaticamente após a criação.
O parâmetro de consulta queries.run
asynchronous
foi substituído por
synchronous
A recuperação de relatórios foi simplificada com as seguintes mudanças:
- Adição de um método
queries.reports.get
. - A adição de um parâmetro de consulta
orderBy
àqueries.reports.list
- A atualização do corpo da resposta
queries.run
de um objeto vazio para uma instância do recursoReport
gerado.
Atualizadas mensagens de erro retornadas pela API para serem mais específicas e fornecerem mais prescritivas.
Siga as instruções apresentadas no Guia de migração 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/doubleclickbidmanager
https://doubleclickbidmanager.googleapis.com
Os serviços foram renomeados da seguinte maneira:
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 métodos abaixo têm um novo corpo de resposta:
Método Novo objeto do corpo da resposta queries.run Relatório Os seguintes campos foram removidos:
Recurso Campo(s) Corpo da resposta queries.list
kind
Corpo da resposta queries.reports.list
kind
Consulta kind
reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
RunQueryRequest reportDataEndTimeMs
reportDataStartTimeMs
timezoneCode
O tipo de objeto dos campos a seguir foi alterado para o seguinte:
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 do 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 em versões desativadas, consulte nossa notas da versão arquivadas.