Daftar sekarang untuk mengikuti workshop Performa Maksimal dan Google Ads API yang akan diselenggarakan pada 17 Juli.

Halaman ini diterjemahkan oleh Cloud Translation API.

Mengupgrade ke versi terbaru

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 `QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION` atau `QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION`, bukan `QuotaError.RESOURCE_EXHAUSTED`. Lihat postingan blog untuk detail selengkapnya.
`GoogleAdsService` Permintaan `Search`.	Meneruskan `page_size` ke `GoogleAdsService.Search` akan menghasilkan error `RequestError.PAGE_SIZE_NOT_SUPPORTED`.
`Campaign` dan `Ad`	Kampanye dengan `AdvertisingChannelType` `DISCOVERY` kini akan memiliki `AdvertisingChannelType` `DEMAND_GEN`. Selain itu, beberapa iklan akan mengubah jenis dan nama 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` 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: `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`	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: `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 kueri secara terpisah. Ubah kueri Anda dari: SELECT customer.offline_conversion_client_summaries FROM customer ke: 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`.