Secara berkala, Anda mungkin ingin melakukan upgrade dari versi utama Google Ads API yang lebih lama ke versi utama yang lebih baru. Mungkin karena ada versi yang 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 adalah checklist untuk membantu Anda memulai proses upgrade:
- Endpoint Anda akan berubah saat Anda mengubah versi utama. Update library klien untuk menggunakan endpoint terbaru.
- Buka catatan rilis untuk melihat perubahan yang diperkenalkan dalam setiap rilis.
- Lihat tabel di bawah ini untuk mengetahui area spesifik yang perlu diperhatikan pada versi yang akan Anda upgrade.
Untuk ringkasan komprehensif tentang perubahan berdasarkan perbedaan antara proto dari kedua versi, lihat tabel perbedaan.
v16 hingga v17
Perubahan pada layanan dan komponennya | |
---|---|
GoogleAdsService
Permintaan Search dan SearchStream |
Error saat permintaan Anda dibatasi karena terlalu mahal akan menjadi
|
GoogleAdsService
Permintaan Search . |
Meneruskan |
Campaign dan Ad |
Kampanye dengan Selain itu, beberapa iklan akan mengubah jenis dan nama kolom untuk pelaporan:
|
AdService |
Endpoint GetAd akan dihapus. Hal ini menjadikan AdService sejalan dengan layanan lain di Google Ads API. Lihat
panduan kami tentang mengambil
objek guna mengetahui cara yang direkomendasikan untuk mengambil iklan dan jenis resource lainnya. |
CustomerLifecycleGoal
dan CampaignLifecycleGoal |
Cara Anda mengelola segmen untuk sasaran siklus proses dibuat ulang. Lihat bagian menyegmentasikan audiens Anda dalam dokumentasi sasaran siklus proses untuk melihat ringkasan lengkap. |
ProductLink |
Saat menjalankan penelusuran GoogleAdsService atau permintaan aliran data penelusuran
untuk product_link , kini Anda hanya dapat memilih kolom yang terkait
dengan satu produk tertaut. Memilih beberapa kolom dari berbagai produk tertaut akan menghasilkan error QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE . |
Pelaporan | Mengganti nama kolom metrics.sk_ad_network_conversion_value menjadi
metrics.sk_ad_network_fine_conversion_value . |
v15 hingga v16
Perubahan pada layanan dan komponennya | |
---|---|
AccountLink |
Penautan data_partner dan google_ads di linked_account telah dihapus. Sebagai gantinya, gunakan ProductLinkService dan
ProductLinkInvitationService . |
CampaignLifecycleGoal |
Saat mengupdate CampaignLifecycleGoal yang ada sebelumnya,
Anda akan mengeluarkan operasi create dengan persyaratan tertentu.
Sekarang, Anda dapat mengeluarkan operasi update seperti jenis resource
lainnya. |
Error Reporting | Dua kasus saat error
ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT generik
ditampilkan kini menghasilkan pesan error yang lebih spesifik:
|
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
|
Kolom enum vertical telah diganti namanya menjadi feed_type .
|
MediaFileService
|
Layanan telah dihapus karena tidak diperlukan lagi.
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 ini
kini ditampilkan di kolom feed_label .
|
ProductBiddingCategoryConstant
|
Diganti dengan
ProductCategoryConstant .
Beberapa kolom telah diganti namanya, 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:
|
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 kueri secara terpisah.
Ubah kueri Anda dari: SELECT customer.offline_conversion_client_summaries FROM customerke: 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 mempelajari 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 .
|