Mengupgrade ke versi terbaru

Secara berkala, Anda dapat mengupgrade dari versi utama Google Ads API yang lebih lama ke versi utama yang lebih baru. Bisa jadi karena suatu versi dihentikan, atau mungkin karena Anda ingin menggunakan fitur baru. Sebaiknya selalu upgrade ke versi terbaru.

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

Berikut checklist untuk membantu Anda memulai proses upgrade:

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

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

v15 hingga v16

Perubahan pada layanan dan komponennya
AccountLink Link data_partner dan google_ads di linked_account telah dihapus. Sebagai gantinya, gunakan ProductLinkService dan ProductLinkInvitationService.
CampaignLifecycleGoal Saat memperbarui CampaignLifecycleGoal yang ada sebelumnya, Anda akan menerbitkan operasi create dengan persyaratan tertentu. Kini Anda dapat mengeluarkan operasi update seperti jenis resource lainnya.
Pelaporan error Dua kasus dengan error ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT generik yang ditampilkan kini menghasilkan pesan error yang lebih spesifik:
  • CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
  • CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
AudienceInsightsAttributeMetadata Kolom score telah dihapus.
KeywordMatchTypeRecommendation Jika jenis pencocokan kata kunci tidak ditetapkan, API kini akan menampilkan UNSPECIFIED, bukan UNKNOWN, untuk kolom recommended_match_type.

v14 hingga v15

Perubahan pada layanan dan komponennya
AssetGroupListingGroupFilter Nama kolom enum vertical telah diganti menjadi feed_type.
MediaFileService Layanan telah dihapus karena tidak lagi dibutuhkan. Lihat perubahan ImageAdInfo di bawah.
ImageAdInfo Kolom media_file telah diganti dengan image_asset.
MerchantCenterLinkService Layanan telah diganti dengan ProductLinkInvitationService dan ProductLinkService.
Campaign.ShoppingSetting Kolom sales_country telah dihapus. Informasi kini ditampilkan di kolom feed_label.
ProductBiddingCategoryConstant Diganti dengan ProductCategoryConstant. Beberapa bidang telah berganti nama sebagaimana mestinya, lihat tiga perubahan berikutnya di bawah.
ListingDimensionInfo Mengganti kolom product_bidding_category dengan product_category.
ListingGroupFilterDimension Mengganti kolom product_bidding_category dengan product_category.
Laporan shopping_performance_view Kolom segmen berikut:
  • product_bidding_category_level1
  • product_bidding_category_level2
  • product_bidding_category_level3
  • product_bidding_category_level4
  • product_bidding_category_level5
telah diganti dengan:
  • product_category_level1
  • product_category_level2
  • product_category_level3
  • product_category_level4
  • product_category_level5
Campaign.shopping_setting Menghapus dukungan untuk membuat kampanye Penelusuran dengan kolom ini.
CampaignCriterion.listing_scope Menghapus dukungan untuk membuat kampanye Penelusuran dengan kolom ini.
Laporan sk_ad_network_conversions metrics.sk_ad_network_conversions telah diganti dengan metrics.sk_ad_network_installs.
OfflineConversionClientSummary Memindahkan kolom offline_conversion_client_summaries dari Customer ke resource level teratas yang dapat Anda buat kuerinya secara terpisah.

Ubah kueri Anda dari:

SELECT customer.offline_conversion_client_summaries
FROM customer
menjadi: 
SELECT
  offline_conversion_upload_client_summary.client,
  offline_conversion_upload_client_summary.status,
  offline_conversion_upload_client_summary.total_event_count,
  offline_conversion_upload_client_summary.successful_event_count,
  offline_conversion_upload_client_summary.last_upload_date_time,
  ...
FROM offline_conversion_upload_client_summary

Gunakan builder kueri untuk menjelajahi daftar kolom yang tersedia untuk pemilihan dan pemfilteran.
OfflineConversionUploadAlert Diganti namanya menjadi OfflineConversionAlert.
OfflineConversionUploadError Diganti namanya menjadi OfflineConversionError.
AdNetworkType Enum YOUTUBE_SEARCH dan YOUTUBE_WATCH telah digabungkan menjadi satu enum: YOUTUBE.