Mengupgrade ke versi terbaru

Secara berkala, Anda mungkin ingin meningkatkan dari versi utama yang lebih lama dari Google Ads API ke versi utama yang lebih baru. Hal ini mungkin karena versi tidak digunakan lagi, atau mungkin karena Anda ingin menggunakan fitur baru. Sebaiknya Anda selalu meningkatkan ke versi terbaru.

Lihat jadwal penghentian kami untuk merencanakan upgrade. Lihat panduan pembuatan versi untuk mempelajari cara kerja pembuatan versi.

Berikut adalah checklist untuk membantu Anda memulai proses upgrade:

  1. Endpoint Anda akan berubah saat Anda mengubah versi utama. Perbarui library klien untuk menggunakan endpoint terbaru.
  2. Lihat catatan rilis untuk melihat perubahan yang diperkenalkan dalam setiap rilis.
  3. Lihat tabel di bawah untuk mengetahui area tertentu yang harus difokuskan untuk versi yang akan Anda upgrade.

Untuk ringkasan komprehensif tentang perubahan berdasarkan perbedaan antara proto dari kedua versi, lihat tabel perbedaan.

v17 hingga v18

Perubahan pada layanan dan komponennya
GoogleAdsService permintaan Search dan SearchStream

Kesalahan saat permintaan Anda dibatasi karena terlalu mahal akan menjadi QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION atau QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION saja dari QuotaError.RESOURCE_EXHAUSTED. Lihat postingan blog untuk mengetahui detail selengkapnya.
GoogleAdsService summary_row_setting dan return_total_results_count kolom di SearchGoogleAdsRequest sekarang menjadi bagian dari objek SearchSettings baru.
AssetType Nilai enum DISCOVERY_CAROUSEL_CARD telah diganti namanya menjadi DEMAND_GEN_CAROUSEL_CARD. Hal ini sejalan dengan perubahan sebelumnya untuk mengganti nama kampanye Discovery menjadi kampanye Peningkat Permintaan.
AudienceInsightsService.GenerateSuggestedTargetingInsights Kolom audience, baseline_audience, dan data_month telah dipindahkan dalam kolom audience_definition.
DemandGenCampaignSettings Nilai default untuk kolom upgraded_targeting sekarang adalah true, bukan false.
LocalServicesLeadConversation Kolom phone_call_details.call_recording_url tidak akan diisi lagi untuk panggilan statis.

v16 hingga v17

Perubahan pada layanan dan komponennya
GoogleAdsService permintaan Search dan SearchStream

Permintaan Anda mungkin dibatasi jika kueri terlalu mahal. Jika ya, Anda akan mendapatkan error QuotaError.RESOURCE_EXHAUSTED. Lihat blog postingan Anda untuk mengetahui detail selengkapnya.
GoogleAdsService Search permintaan.

Meneruskan page_size ke GoogleAdsService.Search akan menghasilkan error RequestError.PAGE_SIZE_NOT_SUPPORTED.
Campaign dan Ad

Kampanye dengan AdvertisingChannelType DISCOVERY sekarang akan memiliki AdvertisingChannelType DEMAND_GEN saja.

Selain itu, beberapa iklan akan mengubah nama jenis dan kolom untuk pelaporan:

  • DISCOVERY_MULTI_ASSET_ADD akan menjadi DEMAND_GEN_MULTI_ASSET_ADD dan kolom pelaporan yang sesuai ad_group_ad.ad.discovery_multi_asset_ad akan menjadi ad_group_ad.ad.demand_gen_multi_asset_ad
  • DISCOVERY_CAROUSEL_AD akan menjadi DEMAND_GEN_CAROUSEL_AD dan kolom pelaporan yang sesuai ad_group_ad.ad.discovery_carousel_ad akan menjadi ad_group_ad.ad.demand_gen_carousel_ad
  • DISCOVERY_VIDEO_RESPONSIVE_AD akan menjadi DEMAND_GEN_VIDEO_RESPONSIVE_AD dan kolom pelaporan yang sesuai ad_group_ad.ad.discovery_video_responsive_ad akan menjadi ad_group_ad.ad.demand_gen_video_responsive_ad
AdService Endpoint GetAd akan dihapus. Hal ini menjadikan AdService sesuai dengan layanan lain di Google Ads API. Baca panduan tentang mengambil objek untuk mengetahui cara yang disarankan untuk mengambil iklan dan jenis resource lainnya.
CustomerLifecycleGoal dan CampaignLifecycleGoal Cara Anda mengelola segmen untuk sasaran siklus proses diubah. Lihat bagian membuat segmen audiens dalam dokumentasi sasaran siklus proses untuk mengetahui ringkasan lengkap.
ProductLink Saat menjalankan penelusuran atau aliran data penelusuran GoogleAdsService meminta product_link, Anda kini hanya dapat memilih kolom yang terkait ke satu produk tertaut. Memilih beberapa kolom dari berbagai produk tertaut akan menghasilkan QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE {i>error<i}.
Pelaporan Mengganti nama kolom metrics.sk_ad_network_conversion_value menjadi metrics.sk_ad_network_fine_conversion_value.