Catatan rilis

Lihat Penghentian penggunaan fitur untuk mengetahui daftar terbaru penghentian penggunaan fitur saat ini dan yang direncanakan.

Versi utama dan minor v24

Google Ads API v24 mencakup fitur, pembaruan, dan perubahan yang menyebabkan gangguan berikut.

v24.2 (24-06-2026)

Fitur dan update baru berikut ditambahkan di Google Ads API v24.2. Versi kecil seperti v24.2 tidak berisi perubahan yang dapat menyebabkan gangguan.

Fitur dan update	Jenis	Deskripsi
Iklan
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT	Nilai enum baru	Membuat informasi teks dari halaman landing untuk ditampilkan di panel engagement untuk instance DemandGenVideoResponsiveAd (yang diikutsertakan secara default mulai dari versi API ini).
Aset
AssetGroup.google_local_services_info	Kolom baru	Ditambahkan untuk mendukung informasi Iklan Jasa dan Servis (ID kategori dan info tambahan) di kampanye Performa Maksimal.
AssetGroupSignal.local_services_id	Kolom baru	Ditambahkan untuk mendukung sinyal ID layanan Iklan Local Services di kampanye Performa Maksimal.
AssetGroupSignal.vertical_ads_item_group_rule_list	Kolom baru	Ditambahkan untuk mendukung aturan grup item iklan vertikal dalam memilih item dari feed vertikal terlampir di kampanye Performa Maksimal. Fitur ini hanya tersedia untuk akun yang masuk daftar yang diizinkan.
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN	Nilai enum baru / error	Ditampilkan saat mencoba menghapus semua grup aset dari kampanye.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS	Nilai enum baru / error	Ditampilkan saat mencoba menghapus semua sinyal dari grup aset.
Kampanye
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings Campaign.PmaxCampaignSettings.local_services_enabled	Kolom baru	Mendukung identifikasi kampanye Performa Maksimal Local Services.
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps	Kolom baru	Menyertakan Google Maps dalam channel yang dapat dipilih untuk grup iklan Peningkat Permintaan.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN	Nilai enum baru / error	Ditampilkan saat mencoba menghapus semua lokasi dari kampanye Performa Maksimal layanan lokal.
SmartCampaignErrorEnum.CREATION_FAILED	Nilai enum baru / error	Ditampilkan saat mencoba membuat Kampanye Pintar baru.
Konversi
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS	Nilai enum baru	Mewakili konversi yang terjadi saat pengguna mengklik iklan jasa dan servis lokal serta menelepon, mengirim pesan, atau memesan layanan pengiklan.
Eksperimen
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION	Nilai enum baru	Menambahkan dukungan untuk jenis ExperimentType baru: COMPARE_CAMPAIGNS: Untuk eksperimen kombinasi kampanye dan eksperimen Performa Maksimal kustom yang membandingkan beberapa kampanye dengan jenis yang sama atau berbeda dalam satu eksperimen. PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION: Untuk eksperimen pengoptimalan Performa Maksimal untuk penyesuaian teks dan perluasan URL Final.
Umum
Asset.synthetic_content_info Ad.synthetic_content_info	Kolom baru	Berisi pengesahan untuk konten sintetis/buatan AI, yang dibagi menjadi advertiser_input (pernyataan yang diberikan langsung oleh pengiklan) dan system_input (pengesahan yang otomatis terdeteksi atau diberikan oleh sistem). Fitur ini telah di-backport ke v23 dan v22. Untuk membantu Anda merencanakan pekerjaan integrasi mendatang untuk v25, antarmuka untuk mengubah kolom pengesahan pengiklan diperkenalkan lebih awal untuk v22 dan yang lebih tinggi. Antarmuka terlihat di versi ini, tetapi synthetic_content_info.advertiser_attestation.status dan synthetic_content_info.advertiser_attestation.source akan tetap tidak dapat diubah untuk versi ini. Jika Anda mencoba permintaan perubahan pada salah satu kolom ini, salah satu error berikut akan ditampilkan: "Kolom yang akan diubah tidak dapat diubah" atau "Kolom tidak dapat ditetapkan". Kolom ini akan dapat diubah sepenuhnya mulai v25. Sebaiknya gunakan antarmuka ini sekarang untuk membuat dan menguji logika internal Anda sehingga sistem Anda siap untuk kemampuan penulisan penuh saat v25 diluncurkan.
Otorisasi Banyak Pihak	Fitur baru	Beta: Fitur ini masih dalam versi beta dan dapat berubah dalam rilis mendatang. Menambahkan dukungan untuk ulasan Otorisasi Multi-Pihak (MPA): Menambahkan resource MultiPartyAuthReview dan MultiPartyAuthReviewService yang sesuai. Menambahkan enum MultiPartyAuthReviewStatus untuk melacak status ulasan. Menambahkan CustomerUserAccess.pending_multi_party_auth_review untuk menautkan ke ulasan tertunda. Menambahkan MutateCustomerUserAccessResult.multi_party_auth_review dan MutateCustomerUserAccessInvitationResult.multi_party_auth_review untuk menampilkan nama resource ulasan terkait. Menambahkan MultiPartyAuthReviewError untuk error validasi. Fitur ini telah di-backport ke v23.3, v22.2, dan v21.2.
IncentiveService.FetchIncentive	Perubahan perilaku	Jika alamat email yang tidak valid diberikan dalam permintaan, metode kini akan melakukan penggantian yang lancar untuk menampilkan penawaran insentif default, bukan menampilkan error AuthenticationError.INVALID_EMAIL_ADDRESS.
Perencanaan
GenerateCreatorInsightsRequest.search_topics	Kolom baru	Ditambahkan ke layanan ContentCreatorInsightsService.GenerateCreatorInsights. Opsi ini menelusuri kreator yang membahas topik di negara yang ditentukan dalam country_locations (hanya mendukung penelusuran untuk satu negara).
CREATOR_TOPIC_INSIGHTS	Nilai enum baru	Ditambahkan ke InsightsKnowledgeGraphEntityCapabilities untuk menandakan entity guna menelusuri kreator yang membahas suatu topik. Entitas ini harus digunakan di kolom search_topics. Diambil menggunakan AudienceInsightsService.ListAudienceInsightsAttributes.
KnowledgeGraphEntitySearchOptions	Jenis / opsi baru	Berisi opsi penelusuran tambahan untuk topik di ListAudienceInsightsAttributes, termasuk opsi untuk mengambil semua topik yang didukung sebagai atribut kreator, dan pemfilteran menurut kemampuan.
GenerateCreatorInsightsRequest.supplemental_data GenerateTrendingInsightsRequest.supplemental_data	Kolom baru	Input opsional ke metode ContentCreatorInsightsService. Mengisi kolom ini akan mengisi lokasi tambahan atau atribut kreator dalam respons.
local_creator_insights related_local_creators	Kolom baru	Diisi saat supplemental_data berisi enum LOCAL_CREATOR_DATA. Mengekspos kreator lokal yang dilihat di atau berbasis di negara yang dipilih yang menyetujui untuk membagikan data lokasi.
GenerateTrendingInsightsRequest.sub_country_locations	Kolom baru	Ditambahkan ke ContentCreatorInsightsService.GenerateTrendingInsights, sehingga memungkinkan penelusuran insight trending menggunakan lokasi negara dan sub-lokasi negara.
Laporan
PerformanceMaxPlacementView	Ekstensi segmen	Dapat disegmentasikan oleh ad_network_type.
Belanja
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads	Kolom baru	Jika benar (true), pengecualian merek akan diabaikan untuk iklan Shopping. Hanya didukung untuk kampanye Shopping.
Penargetan
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE	Nilai enum baru / error	Ditampilkan saat mencoba menargetkan bahasa yang tidak diizinkan.
Video
DataLink.youtube_link_metadata	Kolom baru	Berisi brand_channel_id untuk menentukan ID channel merek YouTube tertaut.

v24.1 (13-05-2026)

Fitur dan update baru berikut ditambahkan di Google Ads API v24.1. Versi kecil seperti v24.1 tidak berisi perubahan yang dapat menyebabkan gangguan.

Fitur dan update	Jenis	Deskripsi
Iklan
DemandGenMultiAssetAdInfo.classic_display_images	Kolom baru	Gambar display yang diupload kustom ditayangkan tanpa memerlukan aset responsif tambahan.
Eksperimen
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING	Nilai enum baru	Menambahkan dukungan untuk jenis ExperimentType baru: ADOPT_AI_MAX: Untuk eksperimen yang menguji cara AI Maksimal dapat membantu Anda menjangkau lebih banyak pelanggan dengan AI Google dan kata kunci pencocokan luas. ADOPT_BROAD_MATCH_KEYWORDS: Untuk eksperimen yang menguji pengaruh kata kunci pencocokan luas terhadap jumlah penelusuran tempat iklan Anda ditampilkan. OPTIMIZE_ASSETS: Untuk eksperimen kustom guna mengoptimalkan aset. PMAX_REPLACEMENT_SHOPPING: Untuk eksperimen yang menguji performa kampanye Shopping Anda dibandingkan dengan Performa Maksimal.
Experiment.video_experiment	Kolom baru	Dukungan konfigurasi untuk eksperimen YOUTUBE_CUSTOM yang ada yang terdiri dari kampanye Video.
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info	Kolom baru	Mengekspos kolom untuk mendukung pengujian aset, grup aset, dan setelan Performa Maksimal di grup eksperimen: asset_testing_info: Detail aset yang terkait dengan salinan iklan eksperimental. asset_groups: Daftar grup aset dalam cabang eksperimen untuk eksperimen Optimalkan Aset. performance_max_experiment_arm_info: Setelan untuk kampanye Performa Maksimal dalam eksperimen PMAX_REPLACEMENT_SHOPPING.
Umum
CustomerUserAccess.passkey_enabled	Kolom baru	Kolom hanya baca yang menunjukkan apakah pengguna telah mengaktifkan kunci sandi.
Laporan
mobile_device_platform	Segmen baru	Memungkinkan segmentasi laporan menurut platform perangkat pengguna (seperti iOS atau Android).
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED	Nilai enum baru / error	Ditampilkan jika perincian waktu harian, per jam, atau mingguan yang diminta tidak didukung untuk rentang tanggal kueri (hanya tersedia untuk 37 bulan terakhir).
vertical_ads_listing_user_rating vertical_ads_listing_venue	Segmen baru	Segmen baru yang akan digunakan untuk iklan vertikal.
user_rating, venue, event_participant_display_name	Kriteria filter baru	Pemfilteran yang didukung di VerticalAdsItemGroupRuleInfo untuk resource SharedCriterion.
Metrik eksperimen kontrol/perlakuan	Kolom baru	Menambahkan nilai kontrol (control_clicks, dll.), nilai perlakuan (clicks, dll.), estimasi titik (clicks_point_estimate, dll.), margin error (clicks_margin_of_error, dll.), dan nilai p (clicks_p_value, dll.) di tujuh kelompok metrik inti (Klik, Tayangan Iklan, Biaya, Konversi, Biaya per konversi, Nilai konversi, Nilai konversi per biaya).
Metrik perubahan absolut konversi	Kolom baru	Dukungan untuk estimasi selisih absolut Conversions menggunakan kolom estimasi titik, margin error, dan nilai p.
Penargetan
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS	Nilai enum baru / error	Ditampilkan saat mencoba mengecualikan semua target demografi.
Video
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR	Nilai enum baru	Mempublikasikan ZEFR sebagai partner integrasi visibilitas pihak ketiga.
DataLink.youtube_video.channel_id	Kolom baru	Mengekspos ID channel YouTube yang terkait dengan penautan data.

v24 (22-04-2026)

Fitur, update, dan perubahan yang menyebabkan gangguan berikut ditambahkan di Google Ads API v24, yang merupakan rilis utama.

Lihat Mengupgrade ke versi terbaru untuk mendapatkan panduan.

Perubahan yang dapat menyebabkan gangguan

Status awal	Status baru	Jenis perubahan	Panduan implementasi
Iklan
Opsional videos dan logo_images di DemandGenVideoResponsiveAdInfo	Kolom wajib diisi	Perubahan perilaku	Berikan videos dan logo_images saat membuat atau mengubah iklan video Peningkat Permintaan responsif.
Opsional videos, business_name, dan logo_images di VideoResponsiveAdInfo	Kolom wajib diisi	Perubahan perilaku	Berikan videos, business_name, dan logo_images saat membuat atau mengubah iklan responsif video. Perhatikan bahwa VideoResponsiveAdInfo sekarang dapat diubah.
Kampanye
Campaign.video_brand_safety_suitability	Tidak ada	Penghapusan	Kontrol kesesuaian tingkat kampanye dihapus. Kesesuaian keamanan merek masih tersedia di tingkat pelanggan. Sebagai gantinya, gunakan Customer.video_brand_safety_suitability.
Konversi
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	Tidak ada	Penghapusan	Kategori pengguna pendaftaran program loyalitas telah dihapus. Hapus referensi kode ke dalamnya.
Perencanaan
Jenis InsightsAudienceAttributeGroup untuk topic_audience_combinations	Jenis common.InsightsAudienceAttributeGroup	Perubahan perilaku / perubahan jenis	Integrasi library klien yang diketik harus diupdate untuk menggunakan namespace resource baru.
Kolom youtube_select_lineups di ReachPlanService.ListPlannableProducts	Tidak ada	Penghapusan	Beralih ke penggunaan daftar lagu dari youtube_select_lineup_targeting.
Kolom is_brand_connect_creator di ContentCreatorInsightsService.GenerateCreatorInsights dan GenerateTrendingInsights	Tidak ada	Penghapusan	Sebagai gantinya, periksa apakah kreator memiliki CREATOR_PARTNERSHIPS yang tersedia di partnership_opportunities.
geo_modifiers dan biddable_keywords di KeywordPlanIdeaService.GenerateKeywordForecastMetrics	geo_target_constants dan keywords	Mengganti nama / menghapus	Diganti dengan CampaignToForecast.geo_target_constants[] dan ForecastAdGroup.keywords[].
Kolom rencana / perkiraan kata kunci yang tidak digunakan lagi di GenerateKeywordForecastMetrics	Tidak ada	Penghapusan	Menghapus kolom dan jenis rencana / perkiraan berikut: CampaignToForecast.keyword_plan_network CampaignToForecast.negative_keywords dan ForecastAdGroup.negative_keywords ForecastAdGroup.max_cpc_bid_micros BiddableKeyword CriterionBidModifier KeywordForecastMetrics.impressions KeywordForecastMetrics.click_through_rate Perbarui integrasi yang sesuai.
Laporan
Segmen ad_sub_network_type di campaign_budget	Tidak ada	Penghapusan	Menghapus segmen ad_sub_network_type untuk resource campaign_budget.
Segmen click_type dalam tampilan aset	Tidak ada	Penghapusan	Menghapus segmen dari tampilan AdGroupAsset, CampaignAsset, dan CustomerAsset.
Video
Kegagalan sebagian diizinkan di ShareablePreviewService.GenerateShareablePreviews	Tidak ada kegagalan sebagian	Perubahan perilaku	Permintaan akan gagal dan menampilkan error jika ada ID di dalamnya yang gagal divalidasi.
Kode lama ShareablePreviewError: ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER TOO_MANY_ASSET_GROUPS_IN_REQUEST	MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST	Perubahan nama / perilaku	Kode error yang ditampilkan untuk grup aset diubah agar sesuai dengan error iklan grup iklan. Memperbarui logika penangkapan validasi.

Fitur dan update (tidak merusak)

Fitur dan update	Jenis	Deskripsi
Iklan
Mutabilitas VideoResponsiveAdInfo	Perubahan perilaku	Objek informasi iklan video responsif kini dapat diubah.
Aset
travel_feed_data dalam AssetSet	Kolom baru	Ditambahkan untuk mengambil atribut aset feed perjalanan (hotel_center_account_id, merchant_center_id, partner_center_id, subset_id, travel_feed_vertical_type).
Kampanye
Campaign.view_through_conversion_optimization_enabled	Kolom baru	Memungkinkan pengaktifan Pengoptimalan Konversi Lihat-Tayang (VTC) (default false) di kampanye Peningkat Permintaan dan Aplikasi.
CampaignCriterion.gender	Fitur baru	Mengaktifkan pengecualian gender untuk kampanye Performa Maksimal di semua versi Google Ads API.
Konversi
Jenis konversi Peningkat Prospek	Nilai enum baru	Menambahkan enum jenis tindakan konversi GA4/Firebase baru di ConversionActionType: GOOGLE_ANALYTICS_4_GENERATE_LEAD GOOGLE_ANALYTICS_4_QUALIFY_LEAD GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD FIREBASE_ANDROID_GENERATE_LEAD FIREBASE_ANDROID_QUALIFY_LEAD FIREBASE_ANDROID_CLOSE_CONVERT_LEAD FIREBASE_IOS_GENERATE_LEAD FIREBASE_IOS_QUALIFY_LEAD FIREBASE_IOS_CLOSE_CONVERT_LEAD
Umum
UserListErrorEnum.DUPLICATE_LOOKALIKE	Nilai enum baru / error	Ditampilkan saat mencoba membuat beberapa daftar mirip yang identik.
Perencanaan
Kolom ProductCoreAttributes di ListPlannableProductsResponse	Kolom baru	Menambahkan deskripsi produk yang dapat direncanakan, tujuan marketing, model biaya, dan metode pembelian ke ProductCoreAttributes di bagian ListPlannableProductsResponse.
Laporan
CartDataSalesView	Resource pelaporan baru	Mengekspos laporan yang menyegmentasikan metrik konversi menurut produk tertentu yang terjual (merek, dll.) selain produk yang diklik.
Metrik yang tidak dapat di-bid	Kolom baru	Menambahkan metrik yang tidak dapat di-bid (metrik yang menampilkan konversi yang tidak dioptimalkan oleh kampanye) ke semua resource yang cocok: all_average_cart_size all_average_order_value_micros all_cost_of_goods_sold_micros all_cross_sell_cost_of_goods_sold_micros all_cross_sell_gross_profit_micros all_cross_sell_revenue_micros all_cross_sell_units_sold all_gross_profit_margin all_gross_profit_micros all_lead_cost_of_goods_sold_micros all_lead_gross_profit_micros all_lead_revenue_micros all_lead_units_sold all_orders all_revenue_micros all_units_sold
conversion_attribution_event_type	Segmen baru	Ditambahkan ke ShoppingPerformanceView.
Belanja
Kampanye Aplikasi di ShoppingProduct	Fitur baru	Kampanye Aplikasi yang didukung di dalam resource ShoppingProduct. Status dan masalah catatan tidak didukung.
Pemfilteran produk berbasis tag	Fitur baru	Memperkenalkan pemfilteran menggunakan ekspresi set logis secara dinamis: Menambahkan jenis kriteria RETAIL_FILTER_BUNDLE dan RETAIL_FILTER. Menambahkan jenis kumpulan bersama RETAIL_FILTER. Menambahkan kolom retail_filter_bundle ke AdGroupCriterion. Menambahkan kolom retail_filter ke SharedCriterion. Menambahkan RETAIL ke ListingGroupFilterListingSource. Menambahkan dimensi RetailFilter ke AssetGroupListingGroupFilter. Menambahkan error validasi baru terkait di CriterionError dan AssetGroupListingGroupFilterError. Fitur ini hanya tersedia untuk akun yang ada dalam daftar yang diizinkan.

Versi utama dan minor v23

Google Ads API v23 mencakup fitur, update, dan perubahan yang menyebabkan gangguan berikut.

v23.3 (24-06-2026)

Fitur dan update baru berikut ditambahkan di Google Ads API v23.3. Versi kecil seperti v23.3 tidak berisi perubahan yang dapat menyebabkan gangguan.

Fitur dan update	Jenis	Deskripsi
Umum
Asset.synthetic_content_info Ad.synthetic_content_info	Kolom baru	Berisi pengesahan untuk konten sintetis/buatan AI, yang dibagi menjadi advertiser_attestation (pernyataan yang diberikan langsung oleh pengiklan) dan system_attestation (pengesahan yang otomatis terdeteksi atau diberikan oleh sistem Google). Untuk membantu Anda merencanakan pekerjaan integrasi mendatang untuk v25, antarmuka untuk mengubah kolom pengesahan pengiklan diperkenalkan lebih awal untuk v22 dan yang lebih tinggi. Antarmuka terlihat di versi ini, tetapi synthetic_content_info.advertiser_attestation.status dan synthetic_content_info.advertiser_attestation.source akan tetap tidak dapat diubah untuk versi ini. Jika Anda mencoba permintaan perubahan pada salah satu kolom ini, salah satu error berikut akan ditampilkan: "Kolom yang akan diubah tidak dapat diubah" atau "Kolom tidak dapat ditetapkan". Kolom ini akan dapat diubah sepenuhnya mulai di v25. Sebaiknya gunakan antarmuka ini sekarang untuk membuat dan menguji logika internal Anda sehingga sistem Anda siap untuk kemampuan penulisan penuh saat v25 diluncurkan.
Persetujuan banyak pihak	Fitur baru	Beta: Fitur ini masih dalam versi beta dan dapat berubah dalam rilis mendatang. Menambahkan dukungan untuk peninjauan persetujuan banyak pihak (MPA): Menambahkan resource MultiPartyAuthReview dan MultiPartyAuthReviewService yang sesuai. Menambahkan enum MultiPartyAuthReviewStatus untuk melacak status ulasan. Menambahkan CustomerUserAccess.pending_multi_party_auth_review untuk menautkan ke ulasan tertunda. Menambahkan MutateCustomerUserAccessResult.multi_party_auth_review dan MutateCustomerUserAccessInvitationResult.multi_party_auth_review untuk menampilkan nama resource ulasan terkait. Menambahkan MultiPartyAuthReviewError untuk error validasi.

v23.2 (25-03-2026)

Fitur dan update baru berikut ditambahkan di Google Ads API v23.2. Versi kecil seperti v23.2 tidak berisi perubahan yang dapat menyebabkan gangguan.

Fitur dan update	Jenis	Deskripsi
Aset
VideoEnhancement	Sumber daya baru	Berisi informasi iklan video khusus peningkatan kualitas, seperti apakah iklan tersebut dibuat oleh Google atau disediakan oleh pengiklan. Lihat artikel Tentang peningkatan kualitas video untuk mempelajari lebih lanjut.
AppTopCombinationView	Sumber daya baru	Resource hanya baca untuk memberikan insight tentang kombinasi aset berperforma terbaik dalam kampanye Aplikasi.
CustomerAsset	Fitur baru	Menambahkan dukungan untuk mengambil CustomerAsset dengan field_type yang ditetapkan ke BUSINESS_LOGO.
Kampanye
AdGroupAd.start_date_time AdGroupAd.end_date_time	Kolom baru	Memberikan batasan penjadwalan yang lebih terperinci untuk tanggal kampanye. Hal ini hanya didukung untuk beberapa jenis grup iklan.
HotelSettingInfo.disable_hotel_setting	Kolom baru	Memungkinkan penonaktifan feed hotel di kampanye Peningkat Permintaan.
Umum
CustomerClientLinkError	Nilai / error enum baru	Menambahkan dua kode error baru: MAX_CUSTOMER_LIMIT_REACHED dan ACCOUNT_CREATION_POLICY_VIOLATION.
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	Perubahan perilaku	Error kini akan muncul saat mencoba menggunakan kategori jenis pelanggan daftar pengguna yang dihentikan ini.
Perencanaan
GenerateTrendingInsights GenerateCreatorInsights	Fitur baru	Menambahkan dukungan untuk kombinasi AND/OR kustom dari entity, topik, dan audiens.
ReachPlanService.GenerateReachForecast	Nilai enum baru	Menambahkan rentang usia baru yang dapat ditargetkan, seperti AGE_RANGE_21_44 atau AGE_RANGE_21_49.
youtube_select_lineup_targeting	Kolom baru	Ditambahkan ke ReachPlanService.ListPlannableProducts, yang akan menggantikan youtube_select_lineups. Kedua kolom saat ini diisi.
ReachPlanSurface	Nilai enum baru	Menambahkan IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS sebagai opsi platform.
Forecast	Kolom baru	Menambahkan clicks untuk Maksimalkan Klik (CPC) Peningkat Permintaan di ReachPlanService.GenerateReachForecast.
partnership_opportunities	Kolom baru	Ditambahkan ke ContentCreatorInsightsService.GenerateCreatorInsights dan ContentCreatorInsightsService.GenerateTrendingInsights.
Laporan
biddable_indirect_install_first_in_app_conversion_micros	Kolom baru	Ditambahkan ke resource Campaign, Customer, dan AdGroup.
Video
ShareablePreviewService	Fitur baru	Diperluas untuk mendukung pratinjau YouTube Live dengan menyetel preview_type ke YOUTUBE_LIVE_PREVIEW. UNSUPPORTED_AD_TYPE dan TOO_MANY_RESOURCES_IN_REQUEST telah ditambahkan ke ShareablePreviewError. Hal ini hanya didukung untuk beberapa jenis iklan.

v23.1 (25-02-2026)

Fitur dan update baru berikut ditambahkan di Google Ads API v23.1. Versi kecil seperti v23.1 tidak berisi perubahan yang dapat menyebabkan gangguan.

Fitur dan update	Jenis	Deskripsi
Pengelolaan akun
advertising_partner_properties.allowed_domain	Kolom baru	Ditambahkan ke resource ProductLinkInvitation dan ProductLink. Partner iklan hanya dapat beriklan di domain ini.
Customer.contains_eu_political_advertising	Kolom baru	Mengambil status pernyataan tingkat akun apakah berisi iklan politik yang ditargetkan ke Uni Eropa, dan menampilkan EuPoliticalAdvertisingStatus.
Kampanye
Campaign.text_guidelines	Kolom baru	Menambahkan dukungan untuk panduan teks, yang dapat digunakan dengan kampanye Performa Maksimal dan Penelusuran untuk mengontrol aset teks yang dibuat AI secara terprogram. Dalam text_guidelines, Anda dapat menentukan term_exclusions dan messaging_restrictions.
CampaignPrimaryStatusReason	Nilai enum baru	Menambahkan CAMPAIGN_NOT_BOOKED, BOOKING_HOLD_EXPIRING, BOOKING_HOLD_EXPIRED, dan BOOKING_CANCELLED untuk memberikan alasan status utama kampanye dengan strategi bidding FIXED_CPM.
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure Campaign.VideoCampaignSettings.booking_details	Kolom baru	Menambahkan dukungan untuk pengungkapan mandiri kategori iklan reservasi dan detail pemesanan hanya baca.
Campaign.missing_eu_political_advertising_declaration	Kolom baru	Mendukung kueri dan pemfilteran kampanye yang tidak memiliki pernyataan tentang apakah kampanye tersebut berisi iklan politik yang ditargetkan ke Uni Eropa.
Konversi
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS	Nilai enum baru	Mendukung pelacakan pengguna yang menonton iklan, lalu menonton video dari channel yang sama.
Umum
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED	Nilai enum baru / error	Ditampilkan saat mencoba menargetkan hanya kategori yang tidak ditentukan dalam dimensi demografi.
Insentif
IncentiveErrorEnum	Nilai / error enum baru	Menambahkan dua kode error baru: MAX_INCENTIVES_REDEEMED dan ACCOUNT_TOO_OLD. Error ini dapat ditampilkan untuk permintaan yang dibuat pada atau setelah 11 Maret 2026.
Perencanaan
GenerateBenchmarksMetrics	Fitur baru	Menambahkan dukungan untuk perincian tanggal menggunakan BreakdownDefinition.
ReachPlanService.GenerateReachForecast	Nilai enum baru	Menambahkan GOOGLE_DISPLAY_NETWORK sebagai platform yang dapat ditargetkan untuk Maksimalkan Konversi Peningkat Permintaan.
GenerateTrendingInsights	Kolom baru	Menambahkan informasi garis tren historis di TrendInsightDataPoint ke TrendInsights saat menelusuri menurut topik.
Laporan
Metrik frekuensi pengguna unik	Kolom baru	Menambahkan metrik baru yang melaporkan jumlah pengguna yang melihat iklan Anda setidaknya dua, tiga, empat, lima, atau sepuluh kali: unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus, dan unique_users_ten_plus.
SearchTermMatchSource	Nilai enum baru	Menambahkan VERTICAL_ADS_DATA_FEED untuk mendukung feed data iklan vertikal, seperti penargetan entitas Iklan Perjalanan.
YouTubeVideoUpload
YouTubeVideoUpload	Layanan / resource baru	Menambahkan layanan YouTubeVideoUpload untuk mendukung penguploadan dan pengelolaan video di YouTube, serta resource YouTubeVideoUpload untuk mendukung pengambilan status dan metadata upload. Fitur ini hanya didukung untuk REST dan library klien Python.

v23 (28-01-2026)

Fitur baru, update, dan perubahan yang menyebabkan gangguan berikut ditambahkan di Google Ads API v23, yang merupakan rilis utama.

Lihat Mengupgrade ke versi terbaru untuk mendapatkan panduan.

Perubahan yang dapat menyebabkan gangguan

Status awal	Status baru	Jenis perubahan	Panduan implementasi
Iklan
Berbagi iklan diizinkan	AdGroupAdError.AD_SHARING_NOT_ALLOWED	Perubahan perilaku	Berbagi iklan di antara beberapa grup iklan tidak lagi diizinkan. Permintaan yang mencoba membagikan iklan akan menampilkan error AD_SHARING_NOT_ALLOWED.
Dukungan untuk CallAd dan CallAdInfo	Tidak ada	Penghapusan	Dukungan untuk iklan panggilan telepon telah dihapus. Lihat artikel pusat bantuan Tentang iklan panggilan telepon.
Kampanye
Campaign.start_date Campaign.end_date	Campaign.start_date_time Campaign.end_date_time	Mengganti nama / penggantian	Gunakan kolom tanggal dan waktu baru untuk menentukan komponen waktu kampanye. Kolom hanya tanggal asli dihapus.
Peningkat Permintaan
DemandGenMultiAssetAdInfo.lead_form_only	Tidak ada	Penghapusan	Kolom lead_form_only telah dihapus. Perbarui referensi dalam kode Anda.
Laporan
Menggabungkan metrik label performa aset dan enum	Tidak ada	Penghapusan	Menghapus metrik label performa aset gabungan. Enum label performa tidak lagi ditampilkan untuk Penelusuran dan Display.

Fitur dan update (tidak merusak)

Fitur dan update	Jenis	Deskripsi
Iklan
AdFormatType	Nilai enum baru	Menambahkan jenis format baru: TEXT, VERTICAL_ADS_BOOKING_LINK, dan VERTICAL_ADS_PROMOTION.
Aset
asset_group tampilan	Kolom baru	Menambahkan metrik berikut: metrics.engagements, metrics.engagement_rate, dan metrics.average_cpe.
asset_group_asset tampilan	Kolom baru	Menambahkan metrik berikut: metrics.average_cpe, metrics.average_cpm, metrics.trueview_average_cpv, metrics.video_trueview_view_rate, metrics.video_trueview_views, dan metrics.interaction_event_types.
Asset.orientation	Kolom baru	Kolom orientasi hanya baca ditambahkan ke aset gambar dan video.
CampaignAsset	Fitur baru	Menambahkan dukungan untuk mengambil aset kampanye dengan field_type yang ditetapkan ke HEADLINE dan DESCRIPTION.
ServedAssetFieldType	Nilai enum baru	Menambahkan HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE, dan DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO untuk aset yang ditayangkan sebagai sitelink.
BusinessMessageAsset	Fitur / dukungan baru	Aset Pesan Bisnis yang diperbarui: Menambahkan dukungan untuk Facebook Messenger dan Zalo sebagai penyedia. FACEBOOK_MESSENGER dan ZALO telah ditambahkan ke BusinessMessageProvider. Menambahkan kolom facebook_messenger_info dan zalo_info. Menambahkan CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS ke AssetError.
Penagihan
InvoiceService.ListInvoices	Opsi baru	Kini dapat menampilkan detail yang lebih terperinci di Invoice, termasuk perincian biaya tingkat kampanye, biaya peraturan yang dikelompokkan menurut item, dan informasi penyesuaian, dengan menyetel include_granular_level_invoice_details di ListInvoicesRequest.
RegulatoryFeeType UnitOfMeasure	Enum baru	Menambahkan enum helper untuk biaya peraturan dan satuan ukuran.
Kampanye
CampaignError	Nilai / error enum baru	Menambahkan kode error DURATION_TOO_LONG_FOR_TOTAL_BUDGET dan END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.
Konversi
ConversionActionCategory	Nilai enum baru	Menambahkan YOUTUBE_FOLLOW_ON_VIEWS untuk mendukung pelacakan pengguna yang menonton iklan, lalu menonton video dari channel yang sama.
Peningkat Permintaan
DemandGenVideoResponsiveAdInfo.companion_banner	Kolom baru	Menambahkan dukungan untuk banner pengiring di iklan video responsif Peningkat Permintaan.
Insentif
Menambahkan dukungan insentif Pilih Sendiri (CYO): Menambahkan metode FetchIncentive untuk mengambil insentif yang dipersonalisasi yang tersedia untuk pengguna. Menambahkan metode ApplyIncentive untuk menerapkan insentif yang dipilih ke akun pelanggan. Menambahkan resource AppliedIncentive (dapat dikueri menggunakan Search dan SearchStream) untuk memberikan detail penukaran. Menambahkan kode error baru di IncentiveError dan AuthenticationError.INVALID_EMAIL_ADDRESS. Untuk memfasilitasi penanganan kegagalan secara terprogram yang lebih terperinci, kami akan menambahkan kode error tambahan ke IncentivesService dalam rilis mendatang. Sebaiknya pantau pengumuman mendatang dan catatan rilis untuk kode error baru ini guna memastikan aplikasi Anda dapat mengelola mode kegagalan baru ini.
Perencanaan
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST	Nilai enum baru	Memungkinkan pembuatan audiens menggunakan Peristiwa Kehidupan di GenerateAudienceCompositionInsights, GenerateSuggestedTargetingInsights, GenerateInsightsFinderReport, dan GenerateCreatorInsights. Peristiwa Kehidupan tidak didukung untuk metode AudienceInsightsService lainnya seperti AudienceInsightsService.GenerateAudienceOverlap dan AudienceInsightsService.GenerateTargetingSuggestionMetrics.
ReachPlanService.GenerateConversionRates	Kolom / opsi baru	Respons kini mencakup platform untuk mendukung saran rasio konversi berdasarkan kontrol platform (misalnya, Gmail, Shorts). Hanya didukung untuk kampanye Peningkat Permintaan.
LanguageDistribution	Kolom / jenis baru	Ditambahkan ke YouTubeChannelInsights untuk memberikan detail distribusi bahasa dalam konten channel YouTube.
BenchmarksService	Layanan baru	Membandingkan data iklan YouTube dengan tolok ukur industri.
AudienceInsightsService.GenerateAudienceDefinition	Metode baru	Menerjemahkan deskripsi teks bebas audiens target ke dalam atribut audiens yang cocok menggunakan AI generatif.
YouTubeChannelInsights.relevance_score	Kolom baru	Mengevaluasi relevansi kreator untuk suatu topik yang diberi bobot berdasarkan penayangan.
TrendInsightMetrics.trend_change_percent	Kolom baru	Mewakili perubahan persentase nilai tren selama periode perbandingan.
Rekomendasi
GenerateRecommendationsRequest	Kolom baru	is_new_customer ditambahkan. Jika disetel ke true untuk rekomendasi CAMPAIGN_BUDGET, model yang digunakan adalah model yang dioptimalkan untuk pelanggan baru (hanya direkomendasikan untuk pelanggan yang tidak memiliki kampanye).
Laporan
AdGroupAdAssetView	Dukungan fitur / metrik baru	Sekarang mendukung metrik tayangan iklan, performa, dan konversi untuk RESPONSIVE_DISPLAY_AD.
Segmen ad_sub_network_type	Segmen baru	Memberikan perincian performa terperinci dalam jaringan iklan. Awalnya tersedia untuk kampanye Peningkat Permintaan di YouTube (In-stream, Dalam feed, Shorts). Harus dipilih bersama dengan ad_network_type.
Pelaporan Performa Maksimal	Fitur baru	Perincian jenis jaringan iklan yang diaktifkan untuk kampanye Performa Maksimal.
UserLocationView GeographicView	Dukungan segmen baru	Metrik dukungan yang disegmentasikan menurut tanggal konversi: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date, cross_device_conversions_by_conversion_date, dan cross_device_conversions_value_by_conversion_date.
Segmen iklan vertikal	Segmen baru	Menambahkan segmen berikut: vertical_ads_event_participant_display_names, vertical_ads_hotel_class, vertical_ads_listing, vertical_ads_listing_brand, vertical_ads_listing_city, vertical_ads_listing_country, vertical_ads_listing_region, vertical_ads_partner_account, dan vertical_ads_vertical.
PerStoreView MatchedLocationInterestView	Aset pelaporan baru	Menambahkan PerStoreView untuk mengkueri detail lokasi toko, dan MatchedLocationInterestView (untuk kampanye AI Maksimal) untuk memberikan metrik performa menurut lokasi geografis yang diminati.
Belanja
ShoppingPerformanceView	Dukungan metrik baru	Sekarang mendukung metrik berikut yang disegmentasikan menurut tanggal konversi: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, dan value_per_all_conversions_by_conversion_date.
ShoppingPerformanceView	Dukungan metrik baru	Menambahkan dukungan untuk: search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share, dan search_rank_lost_absolute_top_impression_share.
ShoppingProduct.product_image_uri	Kolom baru	Ditambahkan ke ShoppingProduct.
Iklan vertikal
AdGroup.vertical_ads_format_setting	Kolom baru	Memungkinkan kontrol atas format iklan yang dapat ditayangkan di kampanye Penelusuran menggunakan feed perjalanan.
AdGroupCriterion SharedCriterion	Kolom / kriteria baru	Menambahkan jenis kriteria vertical_ads_item_group_rule_list ke AdGroupCriterion dan vertical_ads_item_group_rule ke SharedCriterion untuk mengizinkan penargetan grup item di kampanye Penelusuran dengan feed perjalanan.
Integrasi feed data iklan vertikal	Fitur baru	Kini dapat menghubungkan feed data iklan vertikal ke kampanye penelusuran yang menjalankan AI Maksimal untuk menampilkan promosi properti dan iklan perjalanan link pemesanan bersama iklan teks. Kontrol format dengan vertical_ads_format_setting dan tentukan aturan menggunakan vertical_ads_item_group_rule. Menyegmentasikan pelaporan menurut AdFormatType dan dimensi feed data iklan vertikal.
Video
AdVideoAssetInfo.ad_video_asset_feature_control	Kolom baru	Menambahkan opsi kontrol fitur untuk aset iklan video.
CampaignCriterionError	Nilai enum baru / error	Menambahkan kode error INVALID_VIDEO_LINEUP_ID.
Metrik keterdengaran YouTube	Metrik baru	Menambahkan metrik kemampuan didengar untuk iklan audio di YouTube, yang melaporkan apakah iklan dapat didengar dan pada berapa banyak tayangan iklan tersebut dapat diukur.

Versi utama dan minor v22

Google Ads API v22 mencakup fitur, update, dan perubahan yang menyebabkan gangguan berikut.

v22.2 (24-06-2026)

Fitur dan update baru berikut ditambahkan di Google Ads API v22.2. Versi kecil seperti v22.2 tidak berisi perubahan yang dapat menyebabkan gangguan.

Fitur dan update	Jenis	Deskripsi
Umum
Asset.synthetic_content_info Ad.synthetic_content_info	Kolom baru	Berisi pengesahan untuk konten sintetis/buatan AI, yang dibagi menjadi advertiser_attestation (pernyataan yang diberikan langsung oleh pengiklan) dan system_attestation (pengesahan yang otomatis terdeteksi atau diberikan oleh sistem Google). Untuk membantu Anda merencanakan pekerjaan integrasi mendatang untuk v25, antarmuka untuk mengubah kolom pengesahan pengiklan diperkenalkan lebih awal untuk v22 dan yang lebih tinggi. Antarmuka terlihat di versi ini, tetapi synthetic_content_info.advertiser_attestation.status dan synthetic_content_info.advertiser_attestation.source akan tetap tidak dapat diubah untuk versi ini. Jika Anda mencoba permintaan perubahan pada salah satu kolom ini, salah satu error berikut akan ditampilkan: "Kolom yang akan diubah tidak dapat diubah" atau "Kolom tidak dapat ditetapkan". Kolom ini akan dapat diubah sepenuhnya mulai di v25. Sebaiknya gunakan antarmuka ini sekarang untuk membuat dan menguji logika internal Anda sehingga sistem Anda siap untuk kemampuan penulisan penuh saat v25 diluncurkan.
Persetujuan banyak pihak	Fitur baru	Beta: Fitur ini masih dalam versi beta dan dapat berubah dalam rilis mendatang. Menambahkan dukungan untuk peninjauan persetujuan banyak pihak (MPA): Menambahkan resource MultiPartyAuthReview dan MultiPartyAuthReviewService yang sesuai. Menambahkan enum MultiPartyAuthReviewStatus untuk melacak status ulasan. Menambahkan CustomerUserAccess.pending_multi_party_auth_review untuk menautkan ke ulasan tertunda. Menambahkan MutateCustomerUserAccessResult.multi_party_auth_review dan MutateCustomerUserAccessInvitationResult.multi_party_auth_review untuk menampilkan nama resource ulasan terkait. Menambahkan MultiPartyAuthReviewError untuk error validasi.

v22.1 (25-02-2026)

Fitur baru berikut ditambahkan di Google Ads API v22.1. Versi minor seperti v22.1 tidak berisi perubahan yang dapat menyebabkan gangguan.

Fitur dan update	Jenis	Deskripsi
Pengelolaan akun
Customer.contains_eu_political_advertising	Kolom baru	Mengambil status pernyataan tingkat akun apakah berisi iklan politik yang ditargetkan ke Uni Eropa, dan menampilkan EuPoliticalAdvertisingStatus.
Kampanye
Campaign.missing_eu_political_advertising_declaration	Kolom baru	Mendukung kueri dan pemfilteran kampanye yang tidak memiliki pernyataan tentang apakah kampanye tersebut berisi iklan politik yang ditargetkan ke Uni Eropa.

v22 (15-10-2025)

Fitur baru, update, dan perubahan yang tidak kompatibel berikut ditambahkan di Google Ads API v22, yang merupakan rilis utama.

Lihat Mengupgrade ke versi terbaru untuk mendapatkan panduan.

Perubahan yang dapat menyebabkan gangguan

Status awal	Status baru	Jenis perubahan	Panduan implementasi
Peningkat Permintaan
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros	minimum_budget_amount_micros	Mengganti nama / memperbaiki ejaan	Ganti nama referensi untuk menggunakan nama kolom yang sudah diperbaiki.
Umum
Tidak ada batas operasi di AddBatchJobOperations	Batas 10.000 operasi per permintaan	Perubahan perilaku	Pastikan tidak ada satu permintaan AddBatchJobOperations yang berisi lebih dari 10.000 operasi.
Ukuran halaman dibatasi secara diam-diam pada 1.000 di ListBatchJobResultsRequest	Error INVALID_PAGE_SIZE ditampilkan	Perubahan perilaku	Pastikan ListBatchJobResultsRequest.page_size disetel ke 1.000 atau kurang, karena meminta ukuran halaman yang lebih besar akan menghasilkan error.
Performa Maks
Label performa aset	Tidak ada	Penghapusan	Dukungan label performa aset dan enum label performa terkait telah dihapus untuk kampanye Performa Maksimal. Perbarui integrasi yang sesuai.
Campaign.url_expansion_opt_out	Bendera FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION di AssetAutomationSetting	Penghapusan / penggantian	Gunakan setelan otomatisasi aset teks perluasan URL final. Kolom penonaktifan perluasan URL tingkat Kampanye dihapus.
Perencanaan
views	trueview_views	Penghapusan / penggantian	Ganti referensi ke views dengan kolom trueview_views baru di ReachPlanService.
Video
average_cpv video_view_rate video_views video_view_rate_in_feed video_view_rate_in_stream video_view_rate_shorts	trueview_average_cpv video_trueview_view_rate video_trueview_views video_trueview_view_rate_in_feed video_trueview_view_rate_in_stream video_trueview_view_rate_shorts	Mengganti nama	Perbarui string kueri dan integrasi untuk menggunakan nama metrik baru yang merepresentasikan penayangan video TrueView.

Fitur dan update (tidak merusak)

Fitur dan update	Jenis	Deskripsi
Aset
AssetFieldType.LANDING_PAGE_PREVIEW	Nilai enum baru	Ditambahkan sebagai jenis kolom aset gambar baru.
AssetGenerationService	Layanan baru (Beta)	Memungkinkan pembuatan aset teks dan gambar menggunakan AI generatif: GenerateText: Membuat teks berdasarkan URL final, perintah, kata kunci, dll. GenerateImages: Membuat gambar berdasarkan URL final, perintah, atau merekontekstualisasi gambar produk. Error ditampilkan dengan kode dari AssetGenerationError. Awalnya hanya tersedia untuk sekelompok kecil peserta beta tertutup.
Kampanye
AppCampaignBiddingStrategyGoalType	Nilai enum baru	Menambahkan sasaran baru untuk Kampanye Aplikasi untuk penginstalan (ACi) guna mengoptimalkan tanpa menentukan target: OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: Gunakan dengan Maksimalkan Konversi standar. OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: Gunakan dengan Maksimalkan Nilai Konversi standar.
BiddingStrategyType	Fitur baru	Menambahkan dukungan untuk jenis strategi bidding pangsa tayangan iklan tetap.
Campaign.feed_types	Kolom baru	Menampilkan jenis feed yang dilampirkan ke kampanye. Untuk kampanye Performa Maksimal, ini dapat menunjukkan vertikal bisnis, seperti MERCHANT_CENTER_FEED untuk retail.
Penargetan kumpulan bersama	Fitur baru	Mengizinkan pelampiran set bersama kata kunci negatif ke kampanye multi-channel (untuk kampanye Aplikasi) dan kampanye lokal.
Peningkat Permintaan
Bidding TargetCPC	Fitur baru	Menambahkan strategi bidding untuk memaksimalkan klik pada target CPC: tetapkan target CPC tingkat kampanye menggunakan Campaign.target_cpc dan ganti di tingkat grup iklan menggunakan AdGroup.target_cpc_micros.
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES	Nilai enum baru	Jika diaktifkan untuk DemandGenMultiAssetAdInfo, elemen ini akan menambahkan elemen desain dan menyematkan aset teks ke dalam aset gambar untuk membuat aset gambar baru dengan rasio aspek yang berbeda (diaktifkan secara default).
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS	Nilai enum baru	Jika diaktifkan untuk DemandGenMultiAssetAdInfo, fitur ini akan membuat video menggunakan aset lain seperti gambar dan teks, yang kemudian dapat digunakan untuk membuat instance DemandGenVideoResponsiveAdInfo baru (diaktifkan secara default).
Umum
Penggantian ukuran halaman ListBatchJobResultsRequest	Perubahan perilaku	Jika page_size tidak disetel atau 0, nilai defaultnya kini adalah maksimum 1.000 (sebelumnya menampilkan INVALID_PAGE_SIZE).
QuotaError	Nilai enum baru / error	Menambahkan PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED untuk menunjukkan kapan batas frekuensi aktivasi profil pembayaran terlampaui.
Performa Maks
Setelan otomatisasi aset	Nilai enum baru	Menambahkan opsi otomatisasi aset Performa Maksimal baru: GENERATE_IMAGE_ENHANCEMENT: Mengaktifkan pembuatan otomatis gambar yang ditingkatkan (pemangkasan otomatis). Diaktifkan secara default. GENERATE_IMAGE_EXTRACTION: Gambar yang bersumber dari URL final. Secara default, setelan Ekstensi Gambar Dinamis akun akan digunakan.
Segmen pelaporan PMax	Segmen baru	Menambahkan segmen baru yang unik untuk kampanye Performa Maksimal: ad_using_product_data: Menunjukkan apakah iklan menggunakan data produk Google Merchant Center. ad_using_video: Menunjukkan apakah iklan menggunakan aset video.
Perencanaan
Daftar data partner CRM	Fitur / nilai enum baru	Menambahkan THIRD_PARTY_PARTNER_DATA ke sumber data CRM, beserta kode error validasi audiens partner (seperti persetujuan persyaratan layanan, Link tidak ada, dll.).
Metrik kreator livestream	Kolom baru	Menambahkan YouTubeMetrics.is_active_live_stream_creator, yang ditampilkan oleh insight kreator untuk menunjukkan apakah kreator memublikasikan live stream dalam 90 hari terakhir.
Metadata sumber CRM yang dapat direncanakan	Pesan baru	Menambahkan PlannableUserListMetadata di dalam PlannableUserList, yang ditampilkan oleh ReachPlanService.ListPlannableUserLists, untuk menampilkan jenis sumber data CRM.
Dukungan untuk video dan kreator terkait di TrendInsight	Kolom baru	Menambahkan dukungan untuk related_videos dan related_creators di TrendInsight, serta mengawasi properti di video_properties dan publish_date.
Peningkatan InsightsFinder	Fitur baru	GenerateInsightsFinderReport kini mendukung parental_status, income_ranges, dan kombinasi penargetan AND/OR yang lebih kompleks.
Laporan
Jenis klik baru	Nilai enum baru	Menambahkan CLICK_TO_MESSAGE_THIRD_PARTY_CLICK dan CLICK_TO_MESSAGE_LANDING_PAGE_CLICK.
Segmentasi AssetGroupAsset	Dukungan segmen baru	AssetGroupAsset kini dapat disegmentasikan menurut device, conversion_action, conversion_action_name, dan conversion_action_category.
RSA di AdGroupAdAssetView	Dukungan fitur / metrik baru	AdGroupAdAssetView kini sepenuhnya mendukung metrik performa dan konversi untuk RESPONSIVE_SEARCH_AD (sebelumnya hanya tayangan iklan yang ditampilkan).
Segmentasi metrik cluster kueri eksplorasi	Dukungan segmen baru	Metrik clicks_unique_query_clusters, conversions_unique_query_clusters, dan impressions_unique_query_clusters kini dapat disegmentasikan menurut kolom tanggal.
TargetingExpansionView	Resource pelaporan baru	Menambahkan TargetingExpansionView untuk melaporkan metrik untuk perluasan melalui penargetan manual, seperti perluasan tanpa kata kunci untuk AI Maksimal untuk kampanye penelusuran.
Belanja
Perbaikan cakupan Shopping	Perbaikan bug	Memperbaiki cakupan metrik kampanye dan grup iklan di resource ShoppingProduct.
Sasaran terpadu
Sasaran retensi	Fitur baru	Menambahkan dukungan untuk sasaran retensi pelanggan guna mengoptimalkan re-engagement pelanggan lama (misalnya, menggunakan target_option dengan TARGET_SPECIFIC atau TARGET_ALL).
Video
Metrik waktu tonton video	Kolom baru	Menambahkan metrik durasi waktu tonton: video_watch_time_duration_millis (total durasi) dan average_video_watch_time_duration_millis (durasi rata-rata per tayangan iklan).

Versi utama dan minor v21

Google Ads API v21 mencakup fitur, update, dan perubahan yang menyebabkan gangguan baru berikut.

v21.2 (24-06-2026)

Fitur dan update baru berikut ditambahkan di Google Ads API v21.2. Versi kecil seperti v21.2 tidak berisi perubahan yang dapat menyebabkan gangguan.

Fitur dan update	Jenis	Deskripsi
Umum
Persetujuan banyak pihak	Fitur baru	Beta: Fitur ini masih dalam versi beta dan dapat berubah dalam rilis mendatang. Menambahkan dukungan untuk peninjauan persetujuan banyak pihak (MPA): Menambahkan resource MultiPartyAuthReview dan MultiPartyAuthReviewService yang sesuai. Menambahkan enum MultiPartyAuthReviewStatus untuk melacak status ulasan. Menambahkan CustomerUserAccess.pending_multi_party_auth_review untuk menautkan ke ulasan tertunda. Menambahkan MutateCustomerUserAccessResult.multi_party_auth_review dan MutateCustomerUserAccessInvitationResult.multi_party_auth_review untuk menampilkan nama resource ulasan terkait. Menambahkan MultiPartyAuthReviewError untuk error validasi.

v21.1 (25-02-2026)

Fitur dan update baru berikut ditambahkan di Google Ads API v21.1. Versi kecil seperti v21.1 tidak berisi perubahan yang dapat menyebabkan gangguan.

Fitur dan update	Jenis	Deskripsi
Pengelolaan akun
Customer.contains_eu_political_advertising	Kolom baru	Mengambil status pernyataan tingkat akun apakah berisi iklan politik yang ditargetkan ke Uni Eropa, dan menampilkan EuPoliticalAdvertisingStatusEnum.
Kampanye
Campaign.missing_eu_political_advertising_declaration	Kolom baru	Mendukung kueri dan pemfilteran kampanye yang tidak memiliki pernyataan tentang apakah kampanye tersebut berisi iklan politik yang ditargetkan ke Uni Eropa.

v21 (06-08-2025)

Fitur baru, update, dan perubahan yang tidak kompatibel berikut ditambahkan di Google Ads API v21, yang merupakan rilis utama.

Lihat Mengupgrade ke versi terbaru untuk mendapatkan panduan.

Perubahan yang dapat menyebabkan gangguan

Status awal	Status baru	Jenis perubahan	Panduan implementasi
Kampanye
Menampilkan CriterionError.INVALID_LISTING_GROUP_HIERARCHY	Menampilkan CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION	Perubahan kode error	Untuk permintaan dengan kegagalan parsial yang diaktifkan, tangani kode error baru, bukan kode error hierarki asli.
Konversi
Akses ke mode debug_enabled di ConversionUploadService	Tidak ada	Penghapusan	Kolom debug_enabled dihapus. Perbarui kode yang mereferensikannya agar tidak menyetel atau mengkueri parameter ini.
Perubahan pada iklan politik Uni Eropa
Pernyataan mandiri kampanye opsional untuk iklan politik Uni Eropa	Kolom contains_eu_political_advertising wajib diisi untuk kampanye baru	Aturan validasi / perubahan perilaku	Panggilan API untuk membuat kampanye baru akan gagal dengan error FieldError.REQUIRED jika kolom ini tidak disetel. Mulai 22 September 2025, kampanye yang dinyatakan sebagai CONTAINS_EU_POLITICAL_ADVERTISING tidak akan lagi ditayangkan di Uni Eropa.
Kriteria yang dapat diubah tanpa pernyataan mandiri	Gagal memperbarui dengan CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION	Aturan validasi / perubahan perilaku	Tetapkan status pernyataan mandiri sebelum mencoba membuat atau memperbarui kriteria penargetan kedekatan, lokasi, atau grup lokasi tingkat kampanye atau grup iklan untuk kampanye yang ada.
Eksperimen tanpa persyaratan pernyataan mandiri	Gagal memperbarui dengan ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION	Aturan validasi / perubahan perilaku	Pastikan bahwa pernyataan mandiri telah diselesaikan di kampanye eksperimen.
Performa Maks
brand_guidelines_enabled secara default adalah false	Default-nya adalah true	Perubahan perilaku	Untuk kampanye Performa Maksimal baru, pedoman merek diaktifkan secara default. Tetapkan kolom secara eksplisit ke false jika harus dinonaktifkan.
Perencanaan
Jenis argumen input asli untuk AudienceInsightsService.GenerateTargetingSuggestionMetrics	Input jenis InsightsAudience	Perubahan jenis	Perbarui penerapan untuk meneruskan jenis input baru yang mendukung kombinasi minat pengguna AND-of-OR, sehingga memungkinkan metrik jangkauan potensial untuk definisi audiens kustom.

Fitur dan update (tidak merusak)

Fitur dan update	Jenis	Deskripsi
AI Maksimal untuk kampanye Penelusuran
ai_max_setting.enable_ai_max di Campaign	Kolom baru	Mengaktifkan AI Maksimal untuk memperluas pencocokan istilah penelusuran (memperhatikan otomatisasi aset teks dan daftar merek sebelumnya hingga dinonaktifkan). Kolom Campaign.ai_max_setting.bundling_required menunjukkan apakah AI Maksimal harus diaktifkan untuk mematuhi/mengubah setelan tersebut, dan AdGroup.ai_max_ad_group_setting.disable_search_term_matching dapat menonaktifkan pencocokan di tingkat grup iklan. Lihat Dapatkan performa yang lebih optimal dengan AI Maksimal untuk kampanye Penelusuran.
CampaignError.AI_MAX_MUST_BE_ENABLED	Nilai enum baru / error	Dikeluarkan saat mengaktifkan otomatisasi aset teks perluasan URL di kampanye Penelusuran tanpa mengaktifkan AI Maksimal.
Penargetan tingkat grup iklan	Fitur baru	Dukungan tambahan telah disertakan di AI Maksimal untuk kampanye Penelusuran untuk daftar merek, lokasi, dan halaman web (aturan URL) di tingkat grup iklan.
ai_max_search_term_ad_combination_view	Resource pelaporan baru	Melaporkan performa pada kombinasi istilah penelusuran, judul, dan halaman landing.
Segmen search_term_match_type	Nilai enum baru	Menambahkan AI_MAX sebagai opsi jenis pencocokan istilah penelusuran.
Aset
PromotionAsset	Kolom baru	Menambahkan terms_and_conditions_text, terms_and_conditions_uri, dan opsi oneof promotion_trigger (promotion_barcode_info, promotion_qr_code_info). Lihat Tentang aset promosi.
AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION	Nilai enum baru	Ditambahkan ke AssetAutomationType untuk mengontrol pembuatan teks dan halaman landing otomatis dari URL final di kampanye Penelusuran.
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset	Layanan / metode baru	Memungkinkan penghapusan aset perluasan URL final yang dibuat otomatis dari kampanye.
ServedAssetFieldType.DESCRIPTION_PREFIX	Nilai enum baru	Ditambahkan untuk memperbaiki masalah pelaporan saat jenis ditampilkan sebagai UNKNOWN di ad_group_ad_asset_combination_view.
Kampanye
CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING	Nilai enum baru	Ditampilkan saat kampanye yang dibatasi lokasi tidak memiliki penargetan lokasi (yang kini memunculkan LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN jika ditargetkan di luar area yang diizinkan).
Integrasi analisis aplikasi pihak ketiga	Kolom baru	Menambahkan dukungan untuk VideoCustomer.third_party_integration_partners dan Campaign.third_party_integration_partners. Lihat Melacak konversi aplikasi dengan analisis aplikasi pihak ketiga.
Campaign.advertising_partner_ids	Dukungan kolom baru	Kolom kini dapat ditetapkan untuk kampanye yang sudah ada (tetap tidak dapat diubah setelah ditetapkan).
Penempatan negatif tingkat pengelola	Fitur baru	Memungkinkan pengecualian daftar penempatan di seluruh akun pengiklan individual menggunakan CustomerNegativeCriterion.
Konfigurasi toleransi dalam strategi target ROAS	Kolom baru	Menambahkan dukungan untuk TargetRoas.target_roas_tolerance_percent_millis (untuk strategi portofolio kampanye Penelusuran) di MaximizeConversionValue dan TargetRoas.
LocationInterestView	Resource pelaporan baru	Meringkas performa kriteria minat lokasi grup iklan.
Konversi
Segmen conversion_attribution_event_type	Nilai enum baru	Menambahkan ENGAGED_VIEW ke opsi jenis atribusi konversi.
Peningkat Permintaan
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM	Nilai enum baru / error	Ditambahkan sebagai persiapan untuk menerapkan anggaran harian minimum untuk kampanye Peningkat Permintaan. Detail diekspos menggunakan budgetDailyMinimumErrorDetails.
Performa Maks
campaign_search_term_view	Resource pelaporan baru	Menggabungkan metrik istilah penelusuran di tingkat kampanye, sehingga memungkinkan analisis dan pelaporan istilah penelusuran untuk Performa Maksimal.
Perencanaan
ReachPlanService.ListPlannableUserInterests	Metode baru	Memungkinkan penemuan minat yang dapat direncanakan dan minat berniat beli untuk generateReachForecast.
AdditionalApplicationInfo	Kolom baru	Ditambahkan sebagai input opsional di ReachPlanService.ListPlannableUserLists.
Daftar atribut AudienceInsights	Fitur baru	AudienceInsightsService.ListAudienceInsightsAttributes kini mengambil daftar pengguna pihak pertama yang tersedia.
AudienceCompositionInsights menargetkan daftar CRM	Fitur baru	AudienceInsightsService.GenerateAudienceCompositionInsights kini menampilkan detail indeks daftar pengguna untuk dimensi AudienceInsightsDimension: AGE_RANGE, GENDER, AFFINITY_USER_INTEREST, dan IN_MARKET_USER_INTEREST.
TrendInsightMetrics pangsa audiens	Kolom baru	Merepresentasikan pangsa audiens untuk tren.
Kategori KnowledgeGraphAttributeMetadata	Kolom baru	Memfilter atribut Pustaka Pengetahuan dengan mencocokkan kategori.
Laporan
Metrik penayangan aset	Fitur / metrik baru	Menambahkan beberapa metrik baru ke AssetGroupAsset, ChannelAggregateAssetView, dan CampaignAggregateAssetView. Kampanye Performa Maksimal kini juga melaporkan nilai sebenarnya untuk impressions.
Ekstensi pemilih	Fitur baru	Membuat AssetSet dan CampaignAssetSet dapat dikueri bersama di dalam ChangeStatus.
search_term_targeting_status	Segmen baru	Segmen yang dapat dipilih dalam tampilan istilah penelusuran kampanye.
final_url_expansion_asset_view	Resource pelaporan baru	Melaporkan detail performa aset perluasan URL final.
Penyesuaian nilai AssetGroup	Kolom baru	Menambahkan dukungan untuk metrik value_adjustment dan all_value_adjustment dalam laporan AssetGroup.
landing_page_source	Segmen baru	Menyediakan segmen sumber halaman landing di landing_page_view.
search_term_match_source	Segmen baru	Segmen yang dapat dipilih dalam istilah penelusuran dan tampilan istilah penelusuran kampanye.
match_type	Segmen baru	Kunci segmen yang dapat dipilih dalam tampilan kata kunci.
Pelaporan cluster niat kueri unik	Kolom baru	Menambahkan clicks_unique_query_clusters, conversions_unique_query_clusters, dan impressions_unique_query_clusters untuk melaporkan cluster maksud kueri unik.
ClickType.VEHICLE_ASSETS	Nilai enum baru	Lacak dan laporkan klik yang terkait secara khusus dengan format iklan kendaraan dalam laporan click_view.
Eksplorasi Smart Bidding
konfigurasi toleransi dalam strategi Penelusuran	Kolom / setelan baru	Memungkinkan pengaktifan Eksplorasi Smart Bidding di kampanye Penelusuran dengan menetapkan target_roas_tolerance_percent_millis antara 10.000 (10%) dan 30.000 (30%) inklusif (Maksimalkan Konversi memerlukan setelan target_roas). Lihat postingan blog kami tentang Eksplorasi Smart Bidding dan artikel Pusat Bantuan.
kompatibilitas pelaporan keberagaman	Fitur baru	Pelaporan keragaman gabungan kini didukung untuk metrik berikut untuk cluster maksud kueri unik. Tampilan yang tersegmentasi menurut waktu tersedia di UI Google Ads: clicks_unique_query_clusters conversions_unique_query_clusters impressions_unique_query_clusters
Video
YouTubeVideoListAsset	Kolom / resource baru	Memungkinkan pembuatan tautan antara kampanye dan aset daftar video menggunakan Asset.youtube_video_list_asset. Lihat Menggunakan video terkait.
Ekstensi metadata insight	Kolom baru	Menambahkan metadata baru ke YouTubeChannelInsights dan YouTubeVideoAttributeMetadata.
Jenis klik interaktif	Nilai enum baru	Menambahkan jenis klik: VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK, dan PRODUCT_ASSETS.
VideoAdInventoryControl.allow_non_skippable_in_stream	Kolom baru	Memungkinkan iklan Video Responsif ditayangkan sebagai iklan in-stream yang tidak dapat dilewati untuk kampanye yang menggabungkan format yang dapat dilewati dan tidak dapat dilewati.
Setelan pengurutan video	Kolom baru	Menambahkan konfigurasi pengurutan hanya baca: Campaign.VideoCampaignSettings.video_ad_sequence dan VideoAdSequenceStepSetting. Lihat Tentang pengurutan iklan video.
Penargetan grup channel video	Jenis / kolom kriteria baru	Menambahkan jenis kriteria VIDEO_LINEUP dan kolom yang sesuai di CampaignCriterion dan AdGroupCriterion. Fitur ini hanya tersedia untuk akun yang masuk daftar yang diizinkan.
Tampilan penempatan kesesuaian konten	Aset pelaporan baru	Menambahkan laporan Kesesuaian Konten untuk tingkat detail (detail_content_suitability_placement_view) dan grup (group_content_suitability_placement_view). Lihat Tentang laporan 'Kesesuaian konten'.

Arsip catatan rilis

Lihat Versi yang dihentikan untuk catatan rilis yang diarsipkan.