Catatan rilis

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

Versi utama v26

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

v26 (14-10-2026)

Fitur baru, update, dan perubahan yang menyebabkan gangguan berikut ditambahkan di Google Ads API v26, 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 country_code opsional di LocalServicesPmaxCampaignSettings	Kolom wajib diisi selama pembuatan kampanye Performa Maksimal Jasa dan Servis (LocalServicesPmaxCampaignSettings.country_code)	Perubahan perilaku	Pastikan Anda menentukan country_code (bersama dengan listing_id yang baru diperlukan) saat membuat kampanye Performa Maksimal Jasa dan Servis.
Konversi
Kolom enhanced_conversions_for_leads_enabled di ConversionTrackingSetting (Customer.conversion_tracking_setting)	Tidak ada	Penghapusan	Gunakan ConversionTrackingSetting.enablement_setting di Customer.conversion_tracking_setting untuk memeriksa setelan Konversi yang Disempurnakan di tingkat akun.
Penargetan
Kolom kriteria khusus hotel di AdGroupBidModifier: hotel_date_selection_type hotel_advance_booking_window hotel_length_of_stay (min_nights dan max_nights) hotel_check_in_day hotel_check_in_date_range	Kolom kriteria agnostik vertikal di AdGroupBidModifier: user_set_dates dari jenis UserSetDatesInfo advance_booking_window dari jenis AdvanceBookingWindowInfo length_of_booking berjenis LengthOfBookingInfo (min_days dan max_days) start_day_of_week dari jenis StartDayOfWeekInfo start_date_range dari jenis StartDateRangeInfo	Mengganti nama / menghapus	Perbarui referensi untuk menggunakan kolom kriteria agnostik vertikal, yang mendukung penargetan di seluruh vertical perjalanan selain hotel (seperti Rekomendasi aktivitas). ID kriteria, perilaku penargetan, dan pengubah bid yang ada tetap sama. Nilai untuk min_nights dan max_nights akan diteruskan ke min_days dan max_days sebagaimana adanya.
HotelDateSelectionType dan jenis segments.user_set_dates	DateSelectionType	Ganti nama / jenis	Gunakan DateSelectionType, bukan HotelDateSelectionType.
Alasan error khusus hotel di CriterionError: HOTEL_LENGTH_OF_STAY_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_CHECK_IN_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_CHECK_IN_DATE_RANGE_START_DATE_TOO_EARLY HOTEL_CHECK_IN_DATE_RANGE_END_DATE_TOO_LATE HOTEL_CHECK_IN_DATE_RANGE_REVERSED	Alasan error yang tidak bergantung pada vertikal di CriterionError: LENGTH_OF_BOOKING_OVERLAPS_WITH_EXISTING_CRITERION ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION START_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION START_DATE_RANGE_START_DATE_TOO_EARLY START_DATE_RANGE_END_DATE_TOO_LATE START_DATE_RANGE_REVERSED	Ganti nama	Memperbarui penanganan error untuk memeriksa alasan error baru yang tidak bergantung pada vertikal.

Fitur dan update (tidak menyebabkan gangguan)

Fitur dan info terbaru	Jenis	Deskripsi
Aset
Penyedia pesan bisnis LINE dan SMS	Kolom dan nilai enum baru	Menambahkan dukungan untuk LINE dan SMS sebagai penyedia pesan di BusinessMessageAsset, termasuk kolom baru BusinessMessageAsset.line_info dan BusinessMessageAsset.sms_info beserta BusinessMessageProvider.LINE dan BusinessMessageProvider.SMS.
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY	Nilai enum / error baru	Ditambahkan ke AssetGroupError untuk menunjukkan kapan kategori yang ditentukan dalam GoogleLocalServicesInfo (AssetGroup.google_local_services_info) tidak didukung untuk kampanye Performa Maksimal Jasa Lokal.
Kampanye
Pembuatan kampanye Performa Maksimal Jasa dan Servis	Fitur, kolom, dan error baru	PmaxCampaignSettings.local_services_enabled diperbarui dari OUTPUT_ONLY ke IMMUTABLE, sehingga klien API eksternal dapat menentukan local_services_enabled = true saat membuat kampanye Performa Maksimal Jasa dan Servis baru. Juga menambahkan LocalServicesPmaxCampaignSettings.listing_id untuk mengekspos ID listingan Google Profil Bisnis yang ditautkan ke kampanye Performa Maksimal Jasa dan Servis (ditandai sebagai WAJIB selama pembuatan kampanye Performa Maksimal Jasa dan Servis), dan menambahkan kode error CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID.
Error validasi kampanye Jasa dan Servis	Nilai enum dan error baru	Menambahkan error validasi baru untuk kampanye Local Services: CampaignError: LOCAL_SERVICES_MULTIPLE_PERFORMANCE_MAX_CAMPAIGNS_NOT_ALLOWED LOCAL_SERVICES_AGREEMENT_REQUIRED AssetSetLinkError: LOCATION_ASSET_DOES_NOT_MATCH_CAMPAIGN_LISTING_ID CampaignConversionGoalError dan CampaignGoalConfigError: CANNOT_UNLINK_LOCAL_SERVICES_GOAL_FROM_LOCAL_SERVICES_CAMPAIGN GOAL_NOT_ALLOWED_FOR_LOCAL_SERVICES_CAMPAIGN LOCAL_SERVICES_GOAL_NOT_ALLOWED_FOR_NON_LOCAL_SERVICES_CAMPAIGN ConversionGoalCampaignConfigError: CANNOT_DISABLE_CAMPAIGN_OVERRIDE_GOALS_FOR_LOCAL_SERVICES_CAMPAIGN
Validasi penautan akun Pusat Pengelolaan Hotel	Nilai enum / error baru	Menambahkan kode error CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED ke CampaignError untuk menunjukkan bahwa penautan set aset properti hotel (Campaign.hotel_property_asset_set) ke kampanye Performa Maksimal untuk sasaran perjalanan memerlukan penautan akun Pusat Pengelolaan Hotel yang aktif.
Anggaran minimum per hari untuk Peningkat Permintaan	Kolom baru	Menambahkan kolom demand_gen_info.minimum_budget_per_day_micros ke CurrencyConstant, yang menentukan anggaran minimum yang diperlukan per hari untuk kampanye Peningkat Permintaan dalam mata uang tersebut. Nilai kolom ini diperbarui saat anggaran minimum yang diterapkan oleh API berubah.
Konfigurasi pengukuran peningkatan untuk kampanye	Kolom baru	Menambahkan Campaign.lift_measurement_config untuk mengekspos nama resource konfigurasi pengukuran peningkatan yang ditautkan ke kampanye.
Validasi eksperimen AI Maksimal	Nilai enum / error baru	Menambahkan kode error ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED ke ExperimentArmError saat mencoba membuat eksperimen ADOPT_AI_MAX untuk kampanye yang sudah mengaktifkan AI Maksimal (atau diaktifkan dalam permintaan yang sama sebelum pembuatan grup eksperimen).
Jenis listingan kampanye Shopping	Dukungan yang diperluas	Dukungan yang diperluas untuk Campaign.listing_type ke kampanye Shopping.
Pembaruan pernyataan mandiri iklan politik Uni Eropa	Perilaku yang diperbarui dan kolom baru	Campaign.contains_eu_political_advertising kini bersifat opsional untuk beberapa kampanye yang tidak menargetkan Uni Eropa secara positif. Kecuali seperti yang dicatat untuk kampanye DEMAND_GEN dengan penargetan yang diupgrade, kolom ini bersifat opsional jika kampanye memenuhi semua kondisi berikut setelah permintaan dijalankan: Tidak berisi kriteria kampanye lokasi positif yang berada di Uni Eropa Tidak berisi kriteria kampanye grup lokasi atau kedekatan positif Berisi setidaknya satu kriteria kampanye lokasi positif yang berada di luar Uni Eropa Untuk kampanye DEMAND_GEN dengan upgraded_targeting, kolom ini bersifat opsional jika setiap grup iklan aktif dalam kampanye memenuhi semua kondisi berikut setelah permintaan dijalankan: Tidak berisi kriteria grup iklan lokasi positif yang berada di Uni Eropa Tidak berisi kriteria grup iklan kedekatan atau grup lokasi positif Berisi setidaknya satu kriteria grup iklan lokasi positif yang berada di luar Uni Eropa Kolom ini juga bersifat opsional untuk kampanye yang tidak memiliki grup iklan aktif. Jika permintaan membuat grup iklan yang tidak memenuhi kondisi ini, AdGroupError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION akan ditampilkan. Perubahan ini berlaku untuk kampanye baru dan yang sudah ada. Dalam beberapa kasus, kampanye baru hanya dapat dibuat jika kriteria ditambahkan dalam permintaan yang sama — gunakan GoogleAdsService.Mutate untuk mengelompokkan mutasi. Memperbarui Campaign.missing_eu_political_advertising_declaration agar sesuai dengan perubahan pada Campaign.contains_eu_political_advertising. Menambahkan GeoTargetConstant.require_eu_political_advertising_declaration untuk menunjukkan apakah suatu lokasi berada di dalam atau di luar Uni Eropa. Menambahkan CampaignCriterion.require_eu_political_advertising_declaration dan AdGroupCriterion.require_eu_political_advertising_declaration. Campaign.contains_eu_political_advertising diperlukan jika kolom ini true untuk kriteria tingkat kampanye dalam kampanye (atau untuk kriteria tingkat grup iklan aktif dalam kampanye DEMAND_GEN dengan penargetan yang diupgrade). Kolom akan menampilkan true jika kolom negative kriteria adalah false dan kriteria tersebut adalah lokasi di Uni Eropa, kedekatan (terlepas dari apakah tumpang-tindih dengan wilayah Uni Eropa atau tidak), atau grup lokasi (terlepas dari apakah tumpang-tindih dengan wilayah Uni Eropa atau tidak).
Konversi
Konfigurasi Konversi yang Disempurnakan Terpadu	Kolom dan enum baru	Menambahkan ConversionTrackingSetting.enablement_setting dan ConversionTrackingSetting.effective_enablement_setting (di Customer.conversion_tracking_setting) untuk mengekspos konfigurasi Konversi yang Disempurnakan terpadu untuk akun, yang diwakili menggunakan enum EnhancedConversionsConfig baru.
ConversionActionCategory.MESSAGE_LEAD	Nilai enum baru	Ditambahkan ke ConversionActionCategory untuk mendukung interaksi pesan atau chat yang menunjukkan minat pada penawaran pengiklan.
ConversionAttributionEventType.CLICK	Nilai enum baru	Ditambahkan ke ConversionAttributionEventType untuk merepresentasikan konversi yang diatribusikan ke klik iklan, yang sebelumnya disertakan dalam nilai enum UNKNOWN.
Umum
Pembaruan prospek Jasa dan Servis	Kolom dan nilai enum baru	Menambahkan kolom LocalServicesLead.campaign ke resource LocalServicesLead untuk menautkan prospek ke kampanye terkait. Menambahkan COUPON ke LocalServicesLeadType untuk mendukung jenis prospek kupon untuk Jasa dan Servis.
Rekomendasi
Rekomendasi menaikkan anggaran untuk Penelusuran	Rekomendasi baru	Menambahkan RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW, Recommendation.raise_budget_performance_too_low_recommendation, dan ApplyRecommendationOperation.raise_budget_performance_too_low untuk mendukung peningkatan anggaran saat anggaran harian terlalu rendah untuk kampanye Penelusuran.
Laporan
Pengukuran Search Lift	Fitur, resource, segmen, dan metrik baru	Menambahkan dukungan untuk pengukuran Search Lift: Menambahkan resource hanya baca baru SearchLiftKeywordBundle yang mewakili paket kata kunci dalam studi Search Lift. Menambahkan segmen baru yang dapat dipilih (segments.search_lift_keyword_bundle dan segments.search_property) serta 15 metrik Search Lift baru (seperti relative_search_lift, normalized_incremental_searches, search_lift_cost_micros, dan search_lift_impressions) untuk mendukung analisis Search Lift dengan LiftMeasurementConfig (ditautkan ke kampanye menggunakan Campaign.lift_measurement_config). Menambahkan enum SearchLiftKeywordBundleStatus, SearchLiftMatchingInfoSource, dan SearchLiftSearchProperty.
Tampilan aset perluasan URL Final untuk kampanye Shopping	Dukungan yang diperluas	Memperluas final_url_expansion_asset_view untuk mendukung kampanye Shopping (dengan ad_group yang dapat dipilih sebagai sumber yang diatribusikan bersama dengan final_url_expansion_asset_view.ad_group).
Video
Pengungkapan konten generatif YouTube	Kolom dan enum baru	Menambahkan dukungan untuk pengungkapan konten generatif untuk upload YouTube. Kolom baru YouTubeVideoUpload.video_content_metadata dari jenis VideoContentMetadata telah ditambahkan ke YouTubeVideoUpload, yang berisi setelan pengungkapan di bagian VideoContentMetadata.generative_content_disclosure dari jenis YouTubeVideoUploadGenerativeContentDisclosure.

Versi utama dan minor v25

Google Ads API v25 menyertakan fitur baru, update, dan perubahan yang dapat menyebabkan gangguan berikut.

v25.2 (23-09-2026)

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

Fitur dan info terbaru	Jenis	Deskripsi
Aset
Opsi URL untuk AssetGroup	Kolom baru	Menambahkan dukungan untuk opsi URL di AssetGroup, sehingga pengiklan dapat menentukan template pelacakan, parameter kustom, dan akhiran URL final di tingkat grup aset: AssetGroup.tracking_url_template: Template URL untuk membuat URL pelacakan. AssetGroup.url_custom_parameters: Daftar pemetaan yang akan digunakan untuk mengganti tag parameter kustom URL di tracking_url_template, final_urls, atau final_mobile_urls. AssetGroup.final_url_suffix: Template URL untuk menambahkan parameter ke URL halaman landing yang ditayangkan dengan pelacakan paralel.
Kampanye
Info crawl video otomatis	Kolom dan enum baru	Menambahkan AutomatedVideoCrawlSetting ke Campaign.AssetAutomationSetting, bersama dengan AssetAutomationType.AUTOMATED_VIDEO_CRAWL, sehingga Anda dapat menentukan setelan crawl video otomatis untuk kampanye Performa Maksimal. AutomatedVideoCrawlSetting.automated_video_crawl_infos berisi daftar entri AutomatedVideoCrawlInfo, yang masing-masing mengonfigurasi url crawl, source_platform (VideoCrawlSourcePlatform: LANDING_PAGE, SOCIAL, atau YOUTUBE), dan status keikutsertaan enabled.
Error pengganda nilai Pengoptimalan Siklus Proses Pelanggan	Nilai enum dan error baru	Menambahkan alasan error validasi baru saat mengonfigurasi pengganda nilai (value_multiplier dan high_lifetime_value_multiplier) untuk Pengoptimalan Siklus Proses Pelanggan: GoalError: HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER CampaignGoalConfigError: HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_MULTIPLIER_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE
SmartCampaignSettingService.GeneratePMaxDraftCampaign	Fitur baru	Menambahkan SmartCampaignSettingService.GeneratePMaxDraftCampaign untuk mendukung pembuatan draf kampanye Performa Maksimal dari kampanye Pintar yang ada, yang diinisialisasi dengan status CampaignStatus.PAUSED dan status pembuatan CampaignCreationStatus.INCOMPLETE (lihat Mengonversi kampanye Pintar ke kampanye Performa Maksimal): Tetapkan GeneratePMaxDraftCampaignRequest.validate_only ke true untuk memvalidasi konversi dan menerima peringatan validasi atau masalah konversi di GeneratePMaxDraftCampaignResponse.validated_info tanpa membuat draf kampanye. (Biarkan gbp_enabled dan image_enabled tidak disetel atau false; menyetelnya ke true belum didukung dan menampilkan SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED atau SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED.) GeneratePMaxDraftCampaignResponse menampilkan nama resource entity yang dihasilkan (pmax_campaign, campaign_budget, asset_group, dan assets) beserta validated_info.
Konversi
Tayangan iklan Firebase	Jenis dan kategori tindakan konversi baru	Mengekspos jenis tindakan konversi FIREBASE_ANDROID_APP_AD_IMPRESSION dan FIREBASE_IOS_APP_AD_IMPRESSION, sehingga Anda dapat mengambil dan mengubah tindakan konversi ini. Juga mengekspos kategori IN_APP_AD_REVENUE di ConversionActionCategory untuk melacak pendapatan monetisasi iklan dalam aplikasi.
Umum
BusinessProfileLocationSyncError	Enum dan error baru	Menambahkan alasan error sinkronisasi lokasi Profil Bisnis saat menyinkronkan lokasi dalam AssetSet berjenis LOCATION_SYNC. Alih-alih menampilkan error UNKNOWN umum, API kini menampilkan BusinessProfileLocationSyncError dengan alasan tertentu (EMAIL_INVALID, OAUTH_TOKEN_INVALID, ACCOUNT_REMOVED, dan NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT).
Perencanaan
Metrik persentil BenchmarksService.GenerateBenchmarksMetrics	Fitur baru	Memperbarui BenchmarksService.GenerateBenchmarksMetrics untuk memberikan metrik yang mewakili posisi kompetitif pelanggan di antara pengiklan lain dalam format tingkat persentil. Metrik ditampilkan dalam PercentileMetrics di kolom CustomerMetrics.percentile_metrics baru (di GenerateBenchmarksMetricsResponse.customer_metrics dan BreakdownMetrics.customer_metrics) dan direpresentasikan menggunakan BenchmarksCustomerPercentileTier. CustomerMetrics.percentile_metrics hanya diisi jika kedua kondisi berikut terpenuhi di GenerateBenchmarksMetricsRequest: PERCENTILE_DATA diminta di supplemental_data. BenchmarksSource.all_advertisers ditetapkan di benchmarks_source (yang juga memerlukan penentuan category_filter). Menambahkan dukungan untuk metrik persentil untuk tanggal kuartal terbuka dalam ListBenchmarksAvailableDatesResponse.supported_dates (ditampilkan oleh BenchmarksService.ListBenchmarksAvailableDates). Meskipun metrik gabungan pelanggan (CustomerMetrics.aggregate_metrics), metrik rasio pelanggan (CustomerMetrics.average_rate_metrics), dan metrik persentil pelanggan (CustomerMetrics.percentile_metrics) didukung di semua tanggal dalam supported_dates (termasuk kuartal terbuka), metrik pangsa pelanggan (CustomerMetrics.share_metrics) dan metrik rasio sumber tolok ukur (average_benchmarks_metrics, seperti average_cpm iklan "/Apparel/Clothing") tidak didukung untuk kuartal terbuka dan dihilangkan dari respons kecuali jika date_range yang diminta termasuk dalam rentang ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics yang lebih sempit. Menambahkan error BenchmarksError.NO_METRICS_FOUND kustom yang menunjukkan bahwa tidak ada metrik yang ditemukan untuk kombinasi input yang dipilih guna meningkatkan kegunaan.
Nama sebutan channel YouTube untuk insight kreator	Fitur baru	ContentCreatorInsightsService.GenerateCreatorInsights diperbarui untuk mendukung penelusuran berdasarkan nama sebutan channel YouTube menggunakan YouTubeChannels.youtube_channel_handles (nama sebutan channel yang valid harus diawali dengan @, seperti @channel_handle). Opsi ini mirip dengan penelusuran berdasarkan ID channel YouTube. Respons berisi insight tentang kreator YouTube yang diminta.
Rekomendasi
Rekomendasi bid CPA dan ROAS	Rekomendasi baru	Menambahkan Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) dan Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW), beserta ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low dan ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low, untuk mendukung peningkatan Target CPA atau penurunan Target ROAS saat bid terlalu rendah agar kampanye Penelusuran dapat memasuki lelang: RaiseTargetCpaPerformanceBidTooLowRecommendation memberikan recommended_target_multiplier (faktor yang lebih besar dari 1.0) dan current_average_target_cpa_micros; terapkan menggunakan RaiseTargetCpaPerformanceBidTooLowParameters dengan target_cpa_multiplier. LowerTargetRoasPerformanceBidTooLowRecommendation memberikan recommended_target_multiplier (faktor kurang dari 1.0) dan current_average_target_roas; terapkan menggunakan LowerTargetRoasPerformanceBidTooLowParameters dengan target_roas_multiplier.
Laporan
Segmen dimensi itinerari hotel	Segmen baru	Menambahkan segmen dimensi itinerari pemesanan hotel dan perjalanan berikut ke Segments (dapat dipilih dengan campaign, ad_group, dan customer): Segments.advance_booking_window: Periode pemesanan di awal untuk itinerari dalam hari. Segments.length_of_booking: Durasi pemesanan untuk rencana perjalanan dalam hari. Segments.start_date: Tanggal mulai pemesanan yang diformat sebagai yyyy-MM-dd. Segments.start_day_of_week: Hari mulai dalam seminggu (DayOfWeek) pemesanan. Segments.user_set_dates: Menunjukkan apakah tanggal yang ditentukan pengguna dipilih (HotelDateSelectionType).
Metrik iklan vertikal	Metrik baru	Menambahkan metrik berikut untuk pelaporan iklan vertikal hotel dan perjalanan ke Metrics (dapat dipilih dengan campaign, ad_group, dan customer): Metrics.vertical_ads_average_booking_value_micros: Tarif harian rata-rata berbobot klik dalam mikro, termasuk pajak dan biaya, selama total durasi menginap untuk pemesanan hotel. Metrics.vertical_ads_potential_impressions: Total tayangan iklan valid yang dibatasi penayangan yang tersedia di seluruh konteks kueri. Metrics.vertical_ads_price_difference_percentage: Delta persentase yang membandingkan harga yang ditawarkan pengiklan dengan harga terendah yang bersaing untuk properti yang sama.
Segmen iklan vertikal	Segmen baru	Menambahkan segmen berikut untuk pelaporan iklan vertikal hotel dan perjalanan ke Segments (dapat dipilih dengan campaign, ad_group, dan customer): Segments.vertical_ads_price_tier: Tingkat harga pengiklan (HotelPriceBucket) dibandingkan dengan pesaing dalam lelang. Segments.vertical_ads_rate_rule_id: ID aturan tarif yang terkait dengan aturan tarif pengiklan. Segments.vertical_ads_rate_type: Jenis tarif (HotelRateType) pemesanan hotel.

v25.1 (19-08-2026)

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

Fitur dan info terbaru	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 update berikut: Menambahkan resource hanya baca baru LiftMeasurementConfig yang mewakili 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	Resource 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 / error baru	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.
BenchmarksService penyempurnaan	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 dan penayangan gabungan pelanggan, serta metrik pangsa 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 Reach Planner. Menambahkan kolom baru parental_statuses ke Targeting untuk layanan ReachPlanService.GenerateReachForecast, dan parental_statuses ke PlannableTargeting untuk layanan ReachPlanService.ListPlannableProducts.
Rekomendasi
Recommendation.campaign_specific_app_goal_recommendation	Rekomendasi baru	Menyarankan penambahan sasaran konversi aplikasi khusus 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 dapat 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	Masing-masing merupakan bagian dari oneof value_adjustment dan high_lifetime_value_adjustment, 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 yang sesuai CustomerLifecycleGoalService dan CampaignLifecycleGoalService, serta setelan/enum lama (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings)	Tidak ada	Penghapusan	Gunakan skema sasaran terpadu yang diperbarui: 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 info terbaru	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 khusus 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 diperbarui: Memperluas resource Goal untuk mendukung setelan Akuisisi Pelanggan Baru menggunakan kolom new_customer_acquisition_goal_settings. Memperluas resource CampaignGoalConfig untuk mendukung penggantian khusus 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 memungkinkan 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 enum dan error 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 mengklaim insentif) USER_SUSPENDED (akun pelanggan ditangguhkan) MAX_PENDING_INCENTIVES (pelanggan telah mencapai jumlah maksimum insentif yang menunggu keputusan) ACCOUNT_HAD_RECENT_SPEND (akun memiliki pembelanjaan baru-baru ini dan tidak memenuhi syarat) MAX_INCENTIVES_REDEEMED_FROM_OFFER (pelanggan telah menukarkan jumlah insentif maksimum dari penawaran ini) MISMATCHING_BILLING_COUNTRY_CODE (kode negara penagihan yang diberikan dalam permintaan tidak cocok dengan negara akun pelanggan)
Perencanaan
Detail channel YouTube di insight trending	Kolom baru	Menambahkan dukungan untuk detail channel YouTube lainnya dari video terkait saat menelusuri insight trending. Menambahkan kolom baru channel_id, channel_name, dan channel_url 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 instream yang tidak dapat dilewati di YouTube berdasarkan durasi: INSTREAM_NON_SKIPPABLE_STANDARD (iklan dalam stream yang tidak dapat dilewati dengan durasi standar) INSTREAM_NON_SKIPPABLE_MAX30_SEC (iklan in-stream yang tidak dapat dilewati tidak lebih dari 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 menyertakan fitur baru, update, dan perubahan yang dapat 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 info terbaru	Jenis	Deskripsi
Iklan
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT	Nilai enum baru	Membuat informasi teks dari halaman landing untuk ditampilkan di panel interaksi untuk instance DemandGenVideoResponsiveAd (yang diikutsertakan secara default mulai versi API ini).
Aset
AssetGroup.google_local_services_info	Kolom baru	Ditambahkan untuk mendukung informasi Iklan Local Services (ID kategori dan info) di kampanye Performa Maksimal.
AssetGroupSignal.local_services_id	Kolom baru	Ditambahkan untuk mendukung sinyal ID layanan Iklan Jasa dan Servis di kampanye Performa Maksimal.
AssetGroupSignal.vertical_ads_item_group_rule_list	Kolom baru	Ditambahkan untuk mendukung aturan kelompok item iklan vertikal guna memilih item dari feed vertikal yang dilampirkan 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 / error baru	Ditampilkan saat mencoba menghapus semua grup aset dari kampanye.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS	Nilai enum / error baru	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 Jasa dan Servis.
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps	Kolom baru	Menyertakan Google Maps dalam saluran yang dapat dipilih untuk grup iklan Peningkat Permintaan.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN	Nilai enum / error baru	Ditampilkan saat mencoba menghapus semua lokasi dari kampanye Performa Maksimal layanan lokal.
SmartCampaignErrorEnum.CREATION_FAILED	Nilai enum / error baru	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, lalu menelepon, mengirim pesan, atau melakukan pemesanan kepada 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 sekarang untuk membangun dan menguji logika internal Anda sehingga sistem Anda siap untuk kemampuan tulis 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 peninjauan. Menambahkan CustomerUserAccess.pending_multi_party_auth_review untuk menautkan ke ulasan yang menunggu keputusan. 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 tepat 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 di country_locations (hanya mendukung penelusuran untuk satu negara).
CREATOR_TOPIC_INSIGHTS	Nilai enum baru	Ditambahkan ke InsightsKnowledgeGraphEntityCapabilities untuk menandakan entitas guna menelusuri kreator yang membahas suatu topik. Entity 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. Menampilkan kreator lokal yang ditonton atau berbasis di negara yang dipilih dan telah mengizinkan berbagi data lokasi.
GenerateTrendingInsightsRequest.sub_country_locations	Kolom baru	Ditambahkan ke ContentCreatorInsightsService.GenerateTrendingInsights, sehingga memungkinkan penelusuran insight trending menggunakan lokasi negara dan lokasi subnegara.
Laporan
PerformanceMaxPlacementView	Ekstensi segmen	Dibuat dapat disegmentasikan oleh ad_network_type.
Belanja
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads	Kolom baru	Jika benar (true), pengecualian merek diabaikan untuk iklan Shopping. Hanya didukung untuk kampanye Shopping.
Penargetan
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE	Nilai enum / error baru	Ditampilkan saat mencoba menargetkan bahasa yang tidak diizinkan.
Video
DataLink.youtube_link_metadata	Kolom baru	Berisi brand_channel_id untuk menentukan ID channel korporat YouTube yang ditautkan.

v24.1 (13-05-2026)

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

Fitur dan info terbaru	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 yang menampilkan iklan Anda. 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 eksperimental iklan. asset_groups: Daftar grup aset di grup 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 / error baru	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 / error baru	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 dapat 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
videos dan logo_images opsional di DemandGenVideoResponsiveAdInfo	Kolom wajib diisi	Perubahan perilaku	Berikan videos dan logo_images saat membuat atau mengubah iklan video Peningkat Permintaan responsif.
videos, business_name, dan logo_images opsional di VideoResponsiveAdInfo	Kolom wajib diisi	Perubahan perilaku	Berikan videos, business_name, dan logo_images saat membuat atau mengubah iklan responsif video. Perhatikan bahwa VideoResponsiveAdInfo kini 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 library tersebut.
Perencanaan
Jenis InsightsAudienceAttributeGroup untuk topic_audience_combinations	Jenis common.InsightsAudienceAttributeGroup	Perubahan perilaku / 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	Penggantian nama / penghapusan	Digantikan oleh 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	Segmen dihapus 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	Penggantian 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 menyebabkan gangguan)

Fitur dan info terbaru	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 Aplikasi dan Peningkat Permintaan.
CampaignCriterion.gender	Fitur baru	Mengaktifkan pengecualian gender untuk kampanye Performa Maksimal di semua versi Google Ads API.
Konversi
Jenis konversi Lead Gen	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 / error baru	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	Referensi pelaporan baru	Menampilkan 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. RETAIL ditambahkan ke ListingGroupFilterListingSource. Menambahkan dimensi RetailFilter ke AssetGroupListingGroupFilter. Menambahkan error validasi baru terkait di CriterionError dan AssetGroupListingGroupFilterError. Fitur ini hanya tersedia untuk akun dalam daftar yang diizinkan.

Versi utama dan minor v23

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

v23.3 (24-06-2026)

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

Fitur dan info terbaru	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 dideteksi 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 dalam 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 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 peninjauan. Menambahkan CustomerUserAccess.pending_multi_party_auth_review untuk menautkan ke ulasan yang menunggu keputusan. 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 minor seperti v23.2 tidak berisi perubahan yang dapat menyebabkan gangguan.

Fitur dan info terbaru	Jenis	Deskripsi
Aset
VideoEnhancement	Resource 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	Resource baru	Resource hanya baca untuk memberikan insight tentang kombinasi aset berperforma terbaik di 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 selama tanggal kampanye. Fitur 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 ditampilkan saat mencoba menggunakan kategori jenis pelanggan daftar pengguna yang tidak digunakan lagi ini.
Perencanaan
GenerateTrendingInsights GenerateCreatorInsights	Fitur baru	Menambahkan dukungan untuk kombinasi kustom DAN/ATAU dari entitas, topik, dan audiens.
ReachPlanService.GenerateReachForecast	Nilai enum baru	Menambahkan rentang usia baru yang dapat ditarget, 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. Fitur 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 info terbaru	Jenis	Deskripsi
Pengelolaan akun
advertising_partner_properties.allowed_domain	Kolom baru	Ditambahkan ke resource ProductLinkInvitation dan ProductLink. Partner iklan hanya akan 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 buatan 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 untuk 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 dan kemudian menonton video dari channel yang sama.
Umum
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED	Nilai enum / error baru	Ditampilkan saat mencoba menargetkan hanya kategori yang tidak ditentukan dalam dimensi demografi.
Insentif
IncentiveErrorEnum	Nilai enum / error 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 pengelompokan tanggal menggunakan BreakdownDefinition.
ReachPlanService.GenerateReachForecast	Nilai enum baru	Menambahkan GOOGLE_DISPLAY_NETWORK sebagai platform yang dapat ditarget 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 / fasilitas baru	Menambahkan layanan YouTubeVideoUpload untuk mendukung upload dan pengelolaan video di YouTube, serta resource YouTubeVideoUpload untuk mendukung pengambilan status upload dan metadata. Fitur ini hanya didukung untuk REST dan library klien Python.

v23 (28-01-2026)

Fitur baru, update, dan perubahan yang dapat 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	Pembagian 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	Ganti nama / penggantian	Gunakan kolom tanggal-waktu baru untuk menentukan komponen waktu untuk 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 info terbaru	Jenis	Deskripsi
Iklan
AdFormatType	Nilai enum baru	Menambahkan jenis format baru: TEXT, VERTICAL_ADS_BOOKING_LINK, dan VERTICAL_ADS_PROMOTION.
Aset
Tampilan asset_group	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 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	Sekarang dapat menampilkan detail yang lebih terperinci di Invoice, termasuk perincian biaya tingkat kampanye, biaya peraturan yang diperinci, dan informasi penyesuaian, dengan menetapkan include_granular_level_invoice_details di ListInvoicesRequest.
RegulatoryFeeType UnitOfMeasure	Enum baru	Menambahkan enum bantuan untuk biaya peraturan dan satuan ukuran.
Kampanye
CampaignError	Nilai enum / error 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 terprogram yang lebih terperinci, kami akan menambahkan kode error tambahan ke IncentivesService dalam rilis mendatang. Sebaiknya pantau pengumuman dan catatan rilis mendatang 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 menyertakan 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 dari target audiens menjadi atribut audiens yang cocok menggunakan AI generatif.
YouTubeChannelInsights.relevance_score	Kolom baru	Mengevaluasi seberapa relevan kreator untuk suatu topik yang diberi bobot berdasarkan penayangan.
TrendInsightMetrics.trend_change_percent	Kolom baru	Menunjukkan persentase perubahan nilai tren selama periode perbandingan.
Rekomendasi
GenerateRecommendationsRequest	Kolom baru	is_new_customer ditambahkan. Jika ditetapkan ke true untuk rekomendasi CAMPAIGN_BUDGET, model yang dioptimalkan untuk pelanggan baru akan digunakan (hanya direkomendasikan untuk pelanggan yang tidak memiliki kampanye).
Laporan
AdGroupAdAssetView	Dukungan fitur / metrik baru	Kini 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	Mengaktifkan pengelompokan jenis jaringan iklan untuk kampanye Performa Maksimal.
UserLocationView GeographicView	Dukungan segmen baru	Mendukung metrik yang disegmentasi 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	Referensi 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, dan value_per_conversions_by_conversion_date, 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 kelompok item di kampanye Penelusuran dengan feed perjalanan.
Integrasi feed data iklan vertikal	Fitur baru	Kini dapat menghubungkan feed data iklan vertical ke kampanye penelusuran yang menjalankan AI Maksimal untuk menampilkan iklan perjalanan promosi properti dan link pemesanan bersama iklan teks. Kontrol format dengan vertical_ads_format_setting dan tentukan aturan menggunakan vertical_ads_item_group_rule. Segmenkan pelaporan menurut dimensi feed data iklan vertikal dan AdFormatType.
Video
AdVideoAssetInfo.ad_video_asset_feature_control	Kolom baru	Menambahkan opsi kontrol fitur untuk aset iklan video.
CampaignCriterionError	Nilai enum / error baru	Menambahkan kode error INVALID_VIDEO_LINEUP_ID.
Metrik audibilitas YouTube	Metrik baru	Menambahkan metrik keterdengaran untuk iklan audio di YouTube, yang melaporkan apakah iklan terdengar dan pada berapa banyak tayangan iklan keterdengaran dapat diukur.

Arsip catatan rilis

Lihat Versi yang dihentikan untuk mengetahui catatan rilis yang diarsipkan.