Guia de atualização do Google Ads

O serviço de transferência de dados do BigQuery para Google Ads é atualizado periodicamente para oferecer suporte a novas colunas e se adaptar às mudanças introduzidas pelas novas versões da API Google Ads. O conector do serviço de transferência de dados do BigQuery para Google Ads usa a versão compatível da API no conector do Google Ads. Este documento descreve as alterações ao atualizar para uma nova versão da API Google Ads.

Para mais informações sobre a programação de lançamentos da API Google Ads, consulte os Horários.

API Google Ads v16

O conector do serviço de transferência de dados do BigQuery para Google Ads está sendo atualizado para oferecer suporte à API Google Ads v16, que substitui a API Google Ads v14. Essa atualização inclui as seguintes alterações:

Tabelas afetadas	Colunas suspensas	Novas colunas
`ShoppingProductStats` `ShoppingProductConversionStats`	`segments_product_bidding_category_level1`	`segments_product_category_level1`
	`segments_product_bidding_category_level2`	`segments_product_category_level2`
	`segments_product_bidding_category_level3`	`segments_product_category_level3`
	`segments_product_bidding_category_level4`	`segments_product_category_level4`
	`segments_product_bidding_category_level5`	`segments_product_category_level5`
`ProductGroupStats`	`ad_group_criterion_listing_group_case_value_product_bidding_category_id`	`ad_group_criterion_listing_group_case_value_product_category_category_id`
	`ad_group_criterion_listing_group_case_value_product_bidding_category_level`	`ad_group_criterion_listing_group_case_value_product_category_level`
	`AssetGroupListingFilter`	`asset_group_listing_group_filter_case_value_product_bidding_category_id`	`asset_group_listing_group_filter_case_value_product_category_category_id`
		`asset_group_listing_group_filter_case_value_product_bidding_category_level`	`asset_group_listing_group_filter_case_value_product_category_level`
		`asset_group_listing_group_filter_vertical`	`asset_group_listing_group_filter_listing_source`

Com a API Google Ads v14, novas colunas, como segments_product_category_level1 e segments_product_category_level2, foram adicionadas ao esquema da tabela do BigQuery, mas foram preenchidas com null. Com a atualização para a API Google Ads v16, essas novas colunas serão preenchidas com novos valores. As colunas descontinuadas, como segments_product_bidding_category_level1 e segments_product_bidding_category_level2, vão ser preenchidas com null, mas vão continuar no esquema da tabela.

Em cada par de colunas, apenas uma coluna é preenchida com valores da API Google Ads, enquanto a outra é preenchida com null. Para garantir que suas consultas atuais continuem funcionando após a atualização, atualize-as para escolher uma das duas colunas. Por exemplo, se você tiver a seguinte instrução na sua consulta SQL:

segments_product_bidding_category_level1

Substitua pela seguinte instrução que especifica a coluna correta:

IFNULL(segments_product_category_level1, segments_product_bidding_category_level1)

As configurações de transferência criadas após 3 de junho de 2024 sempre usarão as novas colunas. As colunas descontinuadas vão permanecer no esquema da tabela, mas preenchidas com null.