Catatan rilis

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

Versi utama dan minor v25

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

v25.1 (19-08-2026)

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

Fitur dan update	Jenis	Deskripsi
Aset
AssetFieldType.TEXT_DISCLAIMER ServedAssetFieldType.TEXT_DISCLAIMER	Nilai enum baru	Menambahkan dukungan untuk aset pernyataan penyangkalan teks.
Kampanye
Campaign.aca_migration_date_time Campaign.broad_match_migration_date_time	Kolom baru	Melacak migrasi otomatis yang akan datang ke AI Maksimal.
Konversi
Pengukuran Brand Lift	Fitur baru	Menambahkan dukungan untuk pengukuran Brand Lift dengan pembaruan berikut: Menambahkan resource dimensi hanya baca baru untuk hasil studi peningkatan: LiftMeasurementAgeRange, LiftMeasurementCampaign, LiftMeasurementDevice, LiftMeasurementGender, dan LiftMeasurementVideo. Menambahkan segmen dan metrik baru untuk mendukung analisis Brand Lift dengan LiftMeasurementConfig dan resource dimensi baru. Menambahkan enum berikut: BrandLiftMeasurementType, LiftMeasurementFlightStatus, SurveyIntendedAction, SurveyLiftFlightTargetResponseMode, dan SurveySubjectType.
Pengukuran Conversion Lift	Fitur baru	Menambahkan dukungan untuk pengukuran Conversion Lift dengan pembaruan berikut: Menambahkan resource hanya baca baru LiftMeasurementConfig yang merepresentasikan studi peningkatan. Menambahkan segmen baru yang dapat dipilih untuk menyegmentasikan dan memfilter hasil peningkatan. Menambahkan 24 metrik Conversion Lift baru dan metrik skor pemenang yang mendukung analisis statistik mendetail tentang performa peningkatan. Menambahkan dukungan untuk mengambil detail kampanye dan sasaran konversi. Menambahkan kolom opsional baru Experiment.lift_measurement_config. Menambahkan enum ConversionLiftIncludedConversionActionTypes.
LiftMeasurementFlight	Sumber daya baru	Resource hanya baca baru yang merepresentasikan detail penerbangan untuk konfigurasi pengukuran peningkatan, termasuk tanggal mulai dan akhir penerbangan yang diukur (start_date dan end_date).
Umum
SmartCampaignError	Nilai enum baru	Menambahkan kode error spesifik baru untuk batasan pembuatan Performa Maksimal: VALIDATE_ONLY_GENERATE_PMAX_NOT_SUPPORTED GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION	Nilai enum baru / error	Ditampilkan saat project Google Cloud dengan tingkat akses TEST mencoba membuat permintaan terhadap akun non-pengujian.
Perencanaan
Insight sentimen merek	Fitur baru	Menambahkan dukungan untuk insight sentimen merek di ContentCreatorInsightsService: Menambahkan pesan BrandSentimentInsight, SentimentInsightDistribution, dan SentimentInsightSummary. Menambahkan enum Sentiment. Menambahkan nilai BRAND_SENTIMENT_DATA ke enum ContentCreatorInsightsSupplementalData. Menambahkan nilai BRAND ke enum InsightsKnowledgeGraphEntityCapabilities.
Peningkatan BenchmarksService	Fitur baru	Menambahkan dukungan untuk kategori sebagai filter untuk menentukan cakupan analisis tolok ukur. Juga mendukung metrik penting bisnis tambahan: Menambahkan opsi untuk membandingkan dengan semua pengiklan yang menjalankan Iklan dalam satu atau beberapa Kategori Produk & Layanan menggunakan BenchmarksService.GenerateBenchmarksMetrics dan category_filter. Menampilkan lebih banyak metrik iklan pelanggan seperti biaya gabungan, penayangan, dll. pelanggan dan metrik berbagi seperti share_of_voice. Metrik ditampilkan menggunakan AggregateMetrics dan ShareMetrics. Daftar kategori yang didukung dapat diambil menggunakan BenchmarksService.ListBenchmarksSources dengan jenis sumber CATEGORY.
Penargetan status keorangtuaan	Fitur baru	Menambahkan dukungan untuk penargetan status keorangtuaan dalam perencanaan jangkauan. Kolom baru parental_statuses telah ditambahkan ke Targeting untuk layanan ReachPlanService.GenerateReachForecast, dan parental_statuses telah ditambahkan ke PlannableTargeting untuk layanan ReachPlanService.ListPlannableProducts.
Rekomendasi
Recommendation.campaign_specific_app_goal_recommendation	Rekomendasi baru	Menyarankan untuk menambahkan sasaran konversi aplikasi spesifik per kampanye. Resource EffectiveAutomaticGoal baru digunakan untuk merepresentasikan sasaran saat ini dalam rekomendasi ini.
Laporan
Metrics.original_conversion_value	Kolom baru	Mewakili nilai konversi asli dari konversi yang dapat di-bid. Ini adalah nilai konversi yang tidak disesuaikan sebelum penyesuaian aturan nilai, seperti aturan nilai konversi atau penyesuaian sasaran siklus proses diterapkan.
Statistik keanggotaan program loyalitas	Fitur baru	Menambahkan dukungan untuk menyegmentasikan statistik menurut status program keanggotaan loyalitas pengguna, dan menambahkan dimensi utama keanggotaan loyalitas untuk aturan nilai konversi: Menambahkan segmen Segments.loyalty_membership untuk mendukung segmentasi metrik laporan menurut tingkat program loyalitas pengguna yang melakukan konversi. Menambahkan dimensi utama LOYALTY_MEMBERSHIP untuk mengidentifikasi kapan kondisi keanggotaan program loyalitas terpenuhi untuk aturan nilai konversi.
Penargetan
vertical_ads_item_bid	Jenis kriteria baru	Menambahkan jenis kriteria vertical_ads_item_bid baru ke AdGroupCriterion.criterion.

v25 (22-07-2026)

Fitur baru, update, dan perubahan yang menyebabkan gangguan berikut ditambahkan di Google Ads API v25, 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
Kolom mandiri additional_value dan additional_high_lifetime_value di CustomerLifecycleOptimizationValueSettings	Bagian dari oneof value_adjustment dan high_lifetime_value_adjustment masing-masing, bersama dengan kolom value_multiplier dan high_lifetime_value_multiplier baru	Perubahan struktural	Perbarui referensi ke kolom ini karena sekarang menjadi bagian dari oneof.
Resource CustomerLifecycleGoal dan CampaignLifecycleGoal lama, layanan CustomerLifecycleGoalService dan CampaignLifecycleGoalService yang sesuai, serta setelan/enum lama (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings)	Tidak ada	Penghapusan	Gunakan skema sasaran terpadu yang diubah: Gunakan kolom new_customer_acquisition_goal_settings di resource Goal. Gunakan kolom campaign_new_customer_acquisition_settings di resource CampaignGoalConfig untuk mengonfigurasi penggantian spesifik per kampanye.
Umum
Kolom enum bertingkat dalam pesan permintaan dan respons Layanan Insentif: FetchIncentiveRequest.type Incentive.type IncentiveOffer.type	Kolom enum mandiri: FetchIncentiveRequest.incentive_type Incentive.incentive_type IncentiveOffer.offer_type	Mengganti nama / menghapus	Gunakan kolom enum mandiri baru, bukan kolom type lama.
Kolom selected_incentive_id dan customer_id opsional di ApplyIncentiveRequest	Kolom wajib diisi	Perubahan perilaku	Pastikan Anda memberikan kedua kolom saat memanggil ApplyIncentive.
Kolom alamat email konsumen ContactDetails.email di resource LocalServicesLead	Tidak ada	Penghapusan	Hapus referensi ke kolom ini karena tidak lagi didukung.
Kolom allowed_domain opsional di AdvertisingPartnerLinkInvitationProperties	Kolom wajib diisi saat memanggil CreateProductLinkInvitation untuk partner iklan	Perubahan perilaku	Pastikan Anda memberikan allowed_domain saat membuat undangan penautan produk untuk partner iklan.
Perencanaan
Kolom search_brand di GenerateCreatorInsightsRequest	Tidak ada	Penghapusan	Sebagai gantinya, gunakan search_topics.
Kolom plannable_location_id di Targeting dan kolom cookie_frequency_cap di GenerateReachForecastRequest	Tidak ada	Penghapusan	Beralihlah ke penggunaan plannable_location_ids dan cookie_frequency_cap_setting.
Laporan
Kolom customer_metrics di GenerateBenchmarksMetricsResponse dan BreakdownMetrics dengan jenis Metrics	Kolom jenis CustomerMetrics	Perubahan jenis / perubahan perilaku	Perbarui integrasi Anda untuk menggunakan jenis CustomerMetrics baru, yang hanya berisi metrik yang merepresentasikan performa iklan pelanggan.

Fitur dan update (tidak merusak)

Fitur dan update	Jenis	Deskripsi
Iklan
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS	Nilai / perilaku enum baru	Tersedia untuk DemandGenMultiAssetAds. Jika diaktifkan, fitur ini akan membuat gambar animasi menggunakan gambar non-animasi sebagai input. DemandGenMultiAssetAds baru diikutsertakan secara default mulai dari versi API ini.
Mutabilitas info konten sintetis	Perubahan perilaku	Asset.synthetic_content_info dan Ad.synthetic_content_info kini sepenuhnya dapat diubah di v25, v24, dan v23.
Kampanye
Sasaran Retensi Loyalitas	Fitur / setelan baru	Menambahkan dukungan untuk Sasaran Retensi Loyalitas, yang memungkinkan pengiklan mengoptimalkan kampanye untuk mempertahankan anggota program loyalitas. Menambahkan LOYALTY_RETENTION ke enum GoalType. Menambahkan CampaignGoalConfig.campaign_loyalty_retention_settings untuk mengonfigurasi setelan retensi loyalitas spesifik per kampanye, termasuk penyesuaian bid dan menampilkan manfaat khusus anggota dalam format PLA. Menambahkan Goal.loyalty_retention_goal_settings untuk mengonfigurasi setelan sasaran retensi loyalitas tingkat akun. Menambahkan kode error baru: LOYALTY_RETENTION_GOAL_INVALID_MODE CANNOT_USE_INCOMPATIBLE_CLO_GOALS LOYALTY_RETENTION_GOAL_ALREADY_EXISTS
Sasaran Akuisisi Pelanggan Baru	Fitur / setelan baru	Dukungan Sasaran Akuisisi Pelanggan Baru yang diperbarui di Google Ads API untuk mencerminkan skema sasaran terpadu yang diubah: Memperluas resource Goal untuk mendukung setelan Akuisisi Pelanggan Baru menggunakan kolom new_customer_acquisition_goal_settings. Memperluas resource CampaignGoalConfig untuk mendukung penggantian spesifik kampanye untuk Akuisisi Pelanggan Baru menggunakan kolom campaign_new_customer_acquisition_settings. Menambahkan enum CustomerLifecycleOptimizationGoalSubType baru untuk menentukan subjenis sasaran yang didukung. Menambahkan NEW_CUSTOMER_ACQUISITION ke enum GoalType. Menambahkan alasan error validasi baru ke GoalError: NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS Menambahkan alasan error validasi baru ke CampaignGoalConfigError: CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE CANNOT_USE_INCOMPATIBLE_CLO_GOALS Menambahkan ErrorDetails.incompatible_clo_goal_error_details untuk mengekspos struktur IncompatibleCloGoalsErrorDetails baru untuk error validasi.
Konversi
Atribusi konversi pihak ketiga YouTube	Kolom baru	Menambahkan dukungan untuk verifikasi atribusi konversi YouTube menggunakan partner pihak ketiga: Menambahkan CustomerThirdPartyIntegrationPartners.conversion_attribution_integration_partners untuk mengizinkan konfigurasi partner integrasi di tingkat pelanggan. Menambahkan CampaignThirdPartyIntegrationPartners.conversion_attribution_integration_partners untuk mengizinkan konfigurasi partner integrasi di tingkat kampanye. Lihat artikel Pusat Bantuan untuk mempelajari lebih lanjut.
Umum
ContactDetails.phone_number_extension	Kolom baru	Ditambahkan ke resource LocalServicesLead.
IncentiveError	Nilai / error enum baru	Menambahkan kode error spesifik baru untuk kegagalan penukaran insentif: BILLING_COUNTRY_NOT_ELIGIBLE (negara penagihan pelanggan tidak memenuhi syarat untuk mendapatkan insentif) USER_IS_MCC_MANAGER (pengguna adalah akun pengelola dan tidak dapat menukarkan insentif) USER_SUSPENDED (akun pelanggan ditangguhkan) MAX_PENDING_INCENTIVES (pelanggan telah mencapai jumlah maksimum insentif yang menunggu persetujuan) ACCOUNT_HAD_RECENT_SPEND (akun memiliki pembelanjaan baru-baru ini dan tidak memenuhi syarat) MAX_INCENTIVES_REDEEMED_FROM_OFFER (pelanggan telah menukarkan jumlah maksimum insentif dari penawaran ini) MISMATCHING_BILLING_COUNTRY_CODE (kode negara penagihan yang diberikan dalam permintaan tidak cocok dengan negara akun pelanggan)
Perencanaan
Detail channel YouTube dalam insight trending	Kolom baru	Menambahkan dukungan untuk detail channel YouTube lainnya dari video terkait saat menelusuri insight trending. Kolom baru channel_id, channel_name, dan channel_url telah ditambahkan ke YouTubeVideoAttributeMetadata.
YouTubeChannelInsights.data_sharing_consent_given	Kolom baru	Ditambahkan ke YouTubeChannelInsights. Hal ini benar jika kreator telah menyetujui untuk membagikan data non-publik. Jika ya, kolom berikut akan diisi: average_views_per_video average_likes_per_video average_comments_per_video engagement_rate channel_audience_attributes
Laporan
ad_sub_format_type	Segmen baru	Memberikan perincian iklan in-stream YouTube yang tidak dapat dilewati menurut durasi: INSTREAM_NON_SKIPPABLE_STANDARD (iklan in-stream yang tidak dapat dilewati dengan durasi standar) INSTREAM_NON_SKIPPABLE_MAX30_SEC (iklan dalam stream yang tidak dapat dilewati dengan durasi maksimal 30,99 detik) INSTREAM_NON_SKIPPABLE_MAX60_SEC (iklan in-stream yang tidak dapat dilewati dengan durasi tidak lebih dari 60,99 detik) Segmen ini harus selalu dipilih bersama dengan ad_format_type. Dapat dipilih dengan AdGroup, AdGroupAd, Campaign, Customer, Video, dan VideoEnhancement.
Metrik media sosial khusus video	Kolom / metrik baru	Menambahkan metrik sosial khusus video untuk membantu pengiklan melacak engagement pengguna (komentar, suka, dan berbagi) untuk iklan Shorts di YouTube: Metrics.youtube_comments Metrics.youtube_likes Metrics.youtube_shares Opsi ini tersedia dalam AdGroup, AdGroupAd, Asset, Campaign, Customer, dan Video.

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 Local Services (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 ada dalam 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	Mencakup 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_attestation (pernyataan yang diberikan langsung oleh pengiklan) dan system_attestation (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 modifikasi 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.
Otorisasi Banyak Pihak	Fitur baru	Beta: Fitur ini masih dalam versi beta dan dapat berubah dalam rilis mendatang. Menambahkan dukungan untuk ulasan 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. 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 secara 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 muncul. 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 baru, 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 perkiraan / rencana 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	Mengganti nama / perubahan 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 pemasaran, 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 modifikasi 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 ulasan 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 ditampilkan 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. 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
Metrik dan enum label performa aset gabungan	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 dan kemudian 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 iklan perjalanan link pemesanan dan promosi properti 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 modifikasi 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 ulasan 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 menyebabkan gangguan 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.
Membatasi ukuran halaman secara diam-diam hingga 1.000 di ListBatchJobResultsRequest	Menampilkan error INVALID_PAGE_SIZE	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 multisaluran (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, fitur 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, 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 properti watch 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).

Arsip catatan rilis

Lihat Versi yang dihentikan untuk catatan rilis yang diarsipkan.