Sürüm notları

Mevcut ve planlanan özellik kullanımdan kaldırma işlemlerinin güncel listesi için Özelliklerin kullanımdan kaldırılması başlıklı makaleyi inceleyin.

v26 ana sürümü

Google Ads API v26'da aşağıdaki yeni özellikler, güncellemeler ve zarar veren değişiklikler yer almaktadır.

26 sürümü (14.10.2026)

Önemli bir sürüm olan Google Ads API 26 sürümüne aşağıdaki yeni özellikler, güncellemeler ve zarar veren değişiklikler eklendi.

Yardım için En yeni sürüme yükseltme başlıklı makaleyi inceleyin.

Zarar veren değişiklikler

İlk durum	Yeni durum	Değişiklik türü	Uygulama kılavuzu
Kampanyalar
LocalServicesPmaxCampaignSettings içinde isteğe bağlı country_code alanı	Yerel Hizmetler Maksimum Performans kampanyası oluşturma sırasında zorunlu alan (LocalServicesPmaxCampaignSettings.country_code)	Davranış değişikliği	Yerel Hizmetler Maksimum Performans kampanyaları oluştururken country_code (yeni zorunlu listing_id ile birlikte) belirttiğinizden emin olun.
Dönüşümler
ConversionTrackingSetting (Customer.conversion_tracking_setting) içindeki enhanced_conversions_for_leads_enabled alanı	Yok	Kaldırma	Hesap düzeyindeki gelişmiş dönüşümler ayarını incelemek için Customer.conversion_tracking_setting üzerinde ConversionTrackingSetting.enablement_setting kullanın.
Hedefleme
AdGroupBidModifier bölgesindeki otele özgü ölçüt alanları: hotel_date_selection_type hotel_advance_booking_window hotel_length_of_stay (min_nights ve max_nights) hotel_check_in_day hotel_check_in_date_range	AdGroupBidModifier içinde sektörden bağımsız ölçüt alanları: UserSetDatesInfo türündeki user_set_dates AdvanceBookingWindowInfo türünde advance_booking_window LengthOfBookingInfo türünde length_of_booking (min_days ve max_days) StartDayOfWeekInfo türündeki start_day_of_week StartDateRangeInfo türündeki start_date_range	Yeniden adlandırma / kaldırma	Otel dışındaki seyahat dikey alanlarında (ör. Aktivite Önerileri) hedeflemeyi destekleyen, dikey alandan bağımsız ölçüt alanlarını kullanmak için referansları güncelleyin. Ölçüt kimlikleri, hedefleme davranışı ve mevcut teklif değiştiriciler aynı kalır. min_nights ve max_nights değerleri, min_days ve max_days değerlerine olduğu gibi aktarılır.
HotelDateSelectionType ve segments.user_set_dates türü	DateSelectionType	Yeniden adlandırma / tür değişikliği	HotelDateSelectionType yerine DateSelectionType kullanın.
CriterionError bölgesindeki otele özgü hata nedenleri: 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	CriterionError içinde sektöre özgü olmayan hata nedenleri: 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	Yeniden adlandır	Hata işlemeyi, sektörden bağımsız yeni hata nedenlerini kontrol edecek şekilde güncelleyin.

Özellikler ve güncellemeler (kesintisiz)

Özellikler ve güncellemeler	Tür	Açıklama
Öğeler
LINE ve SMS işletme mesajı sağlayıcıları	Yeni alanlar ve enum değerleri	BusinessMessageAsset içinde mesaj sağlayıcı olarak LINE ve SMS desteği eklendi. BusinessMessageProvider.LINE ve BusinessMessageProvider.SMS ile birlikte BusinessMessageAsset.line_info ve BusinessMessageAsset.sms_info gibi yeni alanlar eklendi.
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY	Yeni enum değeri / hata	GoogleLocalServicesInfo (AssetGroup.google_local_services_info) içinde belirtilen bir kategorinin Yerel Hizmetler Maksimum Performans kampanyaları için desteklenmediğini belirtmek üzere AssetGroupError öğesine eklendi.
Kampanyalar
Yerel Hizmetler Maksimum Performans kampanyası oluşturma	Yeni özellikler, alanlar ve hata	PmaxCampaignSettings.local_services_enabled, OUTPUT_ONLY yerine IMMUTABLE olarak güncellendi. Böylece harici API istemcileri, yeni Yerel Hizmetler Maksimum Performans kampanyaları oluştururken local_services_enabled = true değerini belirtebilecek. Ayrıca, Yerel Hizmetler Maksimum Performans kampanyasına bağlı Google İşletme Profili giriş kimliğini göstermek için LocalServicesPmaxCampaignSettings.listing_id alanını (Yerel Hizmetler Maksimum Performans kampanyası oluşturulurken ZORUNLU olarak işaretlenir) ve CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID hata kodunu ekledik.
Yerel Hizmetler kampanyası doğrulama hataları	Yeni enum değerleri ve hatalar	Yerel Hizmet kampanyaları için yeni doğrulama hataları eklendi: CampaignError: LOCAL_SERVICES_MULTIPLE_PERFORMANCE_MAX_CAMPAIGNS_NOT_ALLOWED LOCAL_SERVICES_AGREEMENT_REQUIRED AssetSetLinkError: LOCATION_ASSET_DOES_NOT_MATCH_CAMPAIGN_LISTING_ID CampaignConversionGoalError ve 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
Hotel Center hesabı bağlantı doğrulaması	Yeni enum değeri / hata	Bir otel mülkü öğe kümesini (Campaign.hotel_property_asset_set) seyahat hedefleri için Maksimum Performans kampanyasına bağlamak için etkin bir Hotel Center hesabı bağlantısı gerektiğini belirtmek üzere CampaignError öğesine CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED hata kodu eklendi.
Talep Yaratma kampanyaları için minimum günlük bütçe	Yeni alan	CurrencyConstant'a demand_gen_info.minimum_budget_per_day_micros alanı eklendi. Bu alan, söz konusu para birimindeki Talep Yaratma kampanyaları için gereken minimum günlük bütçeyi belirtir. Bu alanın değeri, API tarafından uygulanan minimum bütçe değiştiğinde güncellenir.
Kampanyalar için artış ölçümü yapılandırması	Yeni alan	Kampanyaya bağlı artış ölçümü yapılandırmasının kaynak adını göstermek için Campaign.lift_measurement_config eklendi.
AI Max denemesi doğrulama	Yeni enum değeri / hata	Maksimum Yapay Zeka'nın halihazırda etkin olduğu (veya deneme kolu oluşturulmadan önce aynı istekte etkinleştirildiği) bir kampanya için ADOPT_AI_MAX denemesi oluşturmaya çalışırken ExperimentArmError hizmetine ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED hata kodu eklendi.
Alışveriş kampanyası listeleme türü	Genişletilmiş destek	Campaign.listing_type için Alışveriş kampanyalarında genişletilmiş destek.
AB siyasi reklamcılığı kişisel beyan güncellemeleri	Güncellenen davranış ve yeni alanlar	Campaign.contains_eu_political_advertising, Avrupa Birliği'ni pozitif olarak hedeflemeyen bazı kampanyalar için artık isteğe bağlıdır. Hedeflemesi yükseltilmiş DEMAND_GEN kampanyaları için belirtilenler hariç, istek yürütüldükten sonra bir kampanya aşağıdaki koşulların tümünü karşılıyorsa alan isteğe bağlıdır: AB içinde pozitif konum kampanyası ölçütü içermemesi Pozitif yakın çevre veya yer grubu kampanya ölçütü içermiyor AB dışında en az bir pozitif konum kampanya ölçütü içeriyor upgraded_targeting içeren DEMAND_GEN kampanyaları için, istek yürütüldükten sonra kampanyadaki her etkin reklam grubu aşağıdaki koşulların tümünü karşılıyorsa alan isteğe bağlıdır: AB'de bulunan pozitif konum reklam grubu ölçütü içermiyor Pozitif yakınlık veya yer grubu reklam grubu ölçütü içermiyor AB dışında en az bir pozitif konum reklam grubu ölçütü içeriyor Bu alan, etkin reklam grubu içermeyen kampanyalar için de isteğe bağlıdır. Bir istek bu koşulları karşılamayan bir reklam grubu oluşturursa AdGroupError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION döndürülür. Bu değişiklikler hem yeni hem de mevcut kampanyalar için geçerlidir. Bazı durumlarda, yeni bir kampanya yalnızca aynı isteğe ölçütler eklenirse oluşturulabilir. Değişiklikleri gruplandırmak için GoogleAdsService.Mutate kullanın. Campaign.missing_eu_political_advertising_declaration, Campaign.contains_eu_political_advertising üzerindeki değişiklikleri yansıtacak şekilde güncellendi. Bir konumun AB içinde mi yoksa dışında mı olduğunu belirtmek için GeoTargetConstant.require_eu_political_advertising_declaration eklendi. CampaignCriterion.require_eu_political_advertising_declaration ve AdGroupCriterion.require_eu_political_advertising_declaration eklendi. Bu alan, kampanyadaki herhangi bir kampanya düzeyi ölçütü için (veya hedefleme yükseltilmiş DEMAND_GEN kampanyalardaki herhangi bir etkin reklam grubu düzeyi ölçütü için) true ise Campaign.contains_eu_political_advertising gereklidir. Ölçütün negative alanı false ise ve ölçüt AB içindeki bir konum, yakınlık (AB bölgesiyle çakışıp çakışmadığına bakılmaksızın) veya yer grubu (AB bölgesiyle çakışıp çakışmadığına bakılmaksızın) ise alanlar true değerini döndürür.
Dönüşümler
Birleştirilmiş gelişmiş dönüşüm yapılandırması	Yeni alanlar ve enum	Hesap için birleştirilmiş gelişmiş dönüşümler yapılandırmasını göstermek üzere ConversionTrackingSetting.enablement_setting ve ConversionTrackingSetting.effective_enablement_setting (Customer.conversion_tracking_setting üzerinde) eklendi. Bu yapılandırma, yeni EnhancedConversionsConfig enum kullanılarak temsil edilir.
ConversionActionCategory.MESSAGE_LEAD	Yeni enum değeri	Reklamverenin teklifiyle ilgilenildiğini belirten mesaj veya sohbet etkileşimlerini desteklemek için ConversionActionCategory'e eklendi.
ConversionAttributionEventType.CLICK	Yeni enum değeri	Daha önce UNKNOWN enum değerine dahil edilen, bir reklam tıklamasıyla ilişkilendirilen dönüşümleri temsil etmek için ConversionAttributionEventType değerine eklendi.
Genel
Yerel Hizmetler hizmet talebi güncellemeleri	Yeni alan ve enum değeri	Bir potansiyel müşteriyi ilişkili kampanyasına bağlamak için LocalServicesLead kaynağına LocalServicesLead.campaign alanı eklendi. Yerel Hizmetler için kupon hizmet talebi türlerini desteklemek amacıyla LocalServicesLeadType öğesine COUPON eklendi.
Öneriler
Arama Ağı için bütçeyi artırma önerisi	Yeni öneri	Arama Ağı kampanyaları için günlük bütçeler çok düşük olduğunda bütçelerin artırılmasını desteklemek amacıyla RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW, Recommendation.raise_budget_performance_too_low_recommendation ve ApplyRecommendationOperation.raise_budget_performance_too_low eklendi.
Raporlar
Arama Artışı ölçümleri	Yeni özellikler, kaynaklar, segmentler ve metrikler	Arama Artışı ölçümleri için destek eklendi: Arama Artışı araştırmasındaki bir anahtar kelime grubunu temsil eden yeni bir salt okunur kaynak SearchLiftKeywordBundle eklendi. LiftMeasurementConfig ile arama artışı analizini desteklemek için yeni seçilebilir segmentler (segments.search_lift_keyword_bundle ve segments.search_property) ve 15 yeni arama artışı metriği (ör. relative_search_lift, normalized_incremental_searches, search_lift_cost_micros ve search_lift_impressions) eklendi (Campaign.lift_measurement_config kullanan kampanyalara bağlı). SearchLiftKeywordBundleStatus, SearchLiftMatchingInfoSource ve SearchLiftSearchProperty sabitleri eklendi.
Alışveriş kampanyaları için nihai URL genişletmesi öğe görünümü	Genişletilmiş destek	Alışveriş kampanyalarını desteklemek için final_url_expansion_asset_view genişletildi (ad_group, final_url_expansion_asset_view.ad_group ile birlikte ilişkilendirilen bir kaynak olarak seçilebilir).
Videolar
YouTube'da yapay zekayla üretilmiş içerik açıklamaları	Yeni alanlar ve enum	YouTube'a yüklenen içeriklerde üretken içerik açıklamaları için destek eklendi. YouTubeVideoUpload'e VideoContentMetadata türünde yeni bir YouTubeVideoUpload.video_content_metadata alanı eklendi. Bu alan, YouTubeVideoUploadGenerativeContentDisclosure türünde VideoContentMetadata.generative_content_disclosure altında açıklama ayarlarını içerir.

v25 ana ve alt sürümleri

Google Ads API 25 sürümü, aşağıdaki yeni özellikleri, güncellemeleri ve zarar veren değişiklikleri içerir.

25.2 sürümü (23.09.2026)

Google Ads API v25.2'ye aşağıdaki yeni özellikler ve güncellemeler eklendi. v25.2 gibi küçük sürümlerde zarar veren değişiklikler bulunmaz.

Özellikler ve güncellemeler	Tür	Açıklama
Öğeler
AssetGroup için URL seçenekleri	Yeni alanlar	AssetGroup için URL seçenekleri desteği eklendi. Bu sayede reklamverenler, öğe grubu düzeyinde izleme şablonları, özel parametreler ve nihai URL son ekleri belirtebilir: AssetGroup.tracking_url_template: İzleme URL'si oluşturmak için kullanılan URL şablonu. AssetGroup.url_custom_parameters: tracking_url_template, final_urls veya final_mobile_urls içinde URL özel parametre etiketlerinin yerine kullanılacak eşlemelerin listesi. AssetGroup.final_url_suffix: Paralel izleme ile sunulan açılış sayfası URL'lerine parametreler eklemek için kullanılan URL şablonu.
Kampanyalar
Otomatik video tarama bilgileri	Yeni alanlar ve enum'lar	AssetAutomationType.AUTOMATED_VIDEO_CRAWL ile birlikte Campaign.AssetAutomationSetting'a AutomatedVideoCrawlSetting eklendi. Bu sayede, Maksimum Performans kampanyası için otomatik video tarama ayarlarını belirleyebilirsiniz. AutomatedVideoCrawlSetting.automated_video_crawl_infos, her biri bir taramayı url, source_platform (VideoCrawlSourcePlatform: LANDING_PAGE, SOCIAL veya YOUTUBE) ve enabled etkinleştirme durumunu yapılandıran AutomatedVideoCrawlInfo girişlerinin listesini içerir.
Müşteri yaşam döngüsü optimizasyonu değer çarpanı hataları	Yeni enum değerleri ve hatalar	Müşteri yaşam döngüsü optimizasyonu için değer çarpanları (value_multiplier ve high_lifetime_value_multiplier) yapılandırılırken yeni doğrulama hatası nedenleri eklendi: 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	Yeni özellik	SmartCampaignSettingService.GeneratePMaxDraftCampaign, mevcut bir akıllı kampanyadan Maksimum Performans taslak kampanyası oluşturmayı desteklemek için eklendi. Bu kampanya, CampaignStatus.PAUSED durumu ve CampaignCreationStatus.INCOMPLETE oluşturma durumuyla başlatılır (bkz. Akıllı kampanyaları Maksimum Performans kampanyalarına dönüştürme): Dönüşümü doğrulamak ve taslak kampanyayı oluşturmadan GeneratePMaxDraftCampaignResponse.validated_info içinde doğrulama uyarıları veya dönüşüm sorunları almak için GeneratePMaxDraftCampaignRequest.validate_only değerini true olarak ayarlayın. (gbp_enabled ve image_enabled parametrelerini ayarlamadan bırakın veya false olarak ayarlayın. Bu parametrelerin true olarak ayarlanması henüz desteklenmemektedir ve SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED veya SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED değerini döndürür.) GeneratePMaxDraftCampaignResponse, validated_info ile birlikte oluşturulan öğelerin kaynak adlarını (pmax_campaign, campaign_budget, asset_group ve assets) döndürür.
Dönüşümler
Firebase reklam gösterimleri	Yeni dönüşüm işlemi türleri ve kategori	FIREBASE_ANDROID_APP_AD_IMPRESSION ve FIREBASE_IOS_APP_AD_IMPRESSION dönüşüm işlemi türleri kullanıma sunuldu. Bu sayede, söz konusu dönüşüm işlemlerini alabilir ve değiştirebilirsiniz. Ayrıca, uygulama içi reklamdan para kazanma gelirini izlemek için ConversionActionCategory'da IN_APP_AD_REVENUE kategorisini kullanıma sunduk.
Genel
BusinessProfileLocationSyncError	Yeni enum ve hatalar	LOCATION_SYNC türündeki bir AssetSet içinde konumlar senkronize edilirken İşletme Profili konum senkronizasyonu hatalarının nedenleri eklendi. API artık genel bir UNKNOWN hatası döndürmek yerine belirli nedenlerle (EMAIL_INVALID, OAUTH_TOKEN_INVALID, ACCOUNT_REMOVED ve NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT) BusinessProfileLocationSyncError döndürüyor.
Planlama
BenchmarksService.GenerateBenchmarksMetrics yüzdelik dilim metrikleri	Yeni özellikler	Müşterinin diğer reklamverenler arasındaki rekabetçi konumunu temsil eden metrikleri yüzdelik dilim katmanı biçiminde sunmak için BenchmarksService.GenerateBenchmarksMetrics güncellendi. Metrikler, yeni CustomerMetrics.percentile_metrics alanında (hem GenerateBenchmarksMetricsResponse.customer_metrics hem de BreakdownMetrics.customer_metrics üzerinde) PercentileMetrics olarak döndürülür ve BenchmarksCustomerPercentileTier kullanılarak gösterilir. CustomerMetrics.percentile_metrics, yalnızca GenerateBenchmarksMetricsRequest'te aşağıdaki koşulların ikisi de karşılandığında doldurulur: supplemental_data içinde PERCENTILE_DATA isteniyor. BenchmarksSource.all_advertisers, benchmarks_source üzerinde ayarlanır (category_filter değerinin de belirtilmesi gerekir). ListBenchmarksAvailableDatesResponse.supported_dates içindeki açık üç aylık dönem tarihlerinde yüzdelik metrikler için destek eklendi (BenchmarksService.ListBenchmarksAvailableDates tarafından döndürülür). Müşteri toplu metrikleri (CustomerMetrics.aggregate_metrics), müşteri oranı metrikleri (CustomerMetrics.average_rate_metrics) ve müşteri yüzdelik metrikleri (CustomerMetrics.percentile_metrics) supported_dates içindeki tüm tarihlerde (açık üç aylık dönemler dahil) desteklenirken müşteri payı metrikleri (CustomerMetrics.share_metrics) ve karşılaştırma ölçütü kaynağının oran metrikleri (average_benchmarks_metrics, örneğin "/Giyim/Kıyafet" reklamlarının average_cpm) açık üç aylık dönemlerde desteklenmez ve istenen date_range daha dar olan ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics aralığında olmadığı sürece yanıttan çıkarılır. Kullanılabilirliği artırmak için, seçilen giriş kombinasyonuyla ilgili metrik bulunamadığını belirten özel bir BenchmarksError.NO_METRICS_FOUND hatası eklendi.
İçerik üreticilere yönelik analizler için YouTube kanalı herkese açık kullanıcı adları	Yeni özellik	ContentCreatorInsightsService.GenerateCreatorInsights, YouTubeChannels.youtube_channel_handles kullanılarak YouTube kanal adlarına göre arama yapmayı destekleyecek şekilde güncellendi (geçerli kanal adları @ ile başlamalıdır, örneğin @channel_handle). Bu seçenek, YouTube kanal kimliklerine göre arama yapmaya benzer. Yanıt, istenen YouTube içerik üreticileriyle ilgili analizler içerir.
Öneriler
EBM ve ROAS teklifi önerileri	Yeni öneriler	Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) ve Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW) ile birlikte ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low ve ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low eklendi. Bu sayede, teklifler Arama Ağı kampanyalarının açık artırmalara girmesi için çok düşük olduğunda hedef EBM'yi artırma veya hedef ROAS'ı düşürme desteklenir: RaiseTargetCpaPerformanceBidTooLowRecommendation, recommended_target_multiplier (1.0 değerinden büyük bir faktör) ve current_average_target_cpa_micros sağlar; target_cpa_multiplier ile RaiseTargetCpaPerformanceBidTooLowParameters kullanarak uygulayın. LowerTargetRoasPerformanceBidTooLowRecommendation, recommended_target_multiplier (1.0 değerinden küçük bir faktör) ve current_average_target_roas sağlar. target_roas_multiplier ile LowerTargetRoasPerformanceBidTooLowParameters kullanarak uygulayın.
Raporlar
Otel seyahat planı boyut segmentleri	Yeni segmentler	Segments için aşağıdaki otel ve seyahat rezervasyonu seyahat planı boyut segmentleri eklendi (campaign, ad_group ve customer ile seçilebilir): Segments.advance_booking_window: Seyahat planı için gün cinsinden erken rezervasyon dönemi. Segments.length_of_booking: Seyahat planının rezervasyon süresi (gün). Segments.start_date: Rezervasyonun başlangıç tarihi yyyy-MM-dd biçiminde biçimlendirilmiş. Segments.start_day_of_week: Rezervasyonun başladığı gün (DayOfWeek). Segments.user_set_dates: Kullanıcı tarafından belirtilen tarihlerin seçilip seçilmediğini gösterir (HotelDateSelectionType).
Dikey reklam metrikleri	Yeni metrikler	Otel ve seyahat sektöründeki reklam raporları için Metrics'ye aşağıdaki metrikler eklendi (campaign, ad_group ve customer ile seçilebilir): Metrics.vertical_ads_average_booking_value_micros: Otel rezervasyonlarında konaklama süresinin toplamı boyunca vergi ve ücretler dahil olmak üzere tıklama ağırlıklı ortalama günlük mikro fiyat. Metrics.vertical_ads_potential_impressions: Sorgu bağlamında kullanılabilen, görüntüleme sayısı sınırlı toplam uygun gösterim sayısı. Metrics.vertical_ads_price_difference_percentage: Reklamverenin teklif ettiği fiyat ile aynı tesis için en düşük rakip fiyatı karşılaştıran yüzde farkı.
Dikey reklam segmentleri	Yeni segmentler	Segments için otel ve seyahat dikey reklam raporlamasına aşağıdaki segmentler eklendi (campaign, ad_group ve customer ile seçilebilir): Segments.vertical_ads_price_tier: Açık artırmadaki rakiplere kıyasla reklamverenin fiyat katmanı (HotelPriceBucket). Segments.vertical_ads_rate_rule_id: Reklamverenin ücret kuralıyla ilişkili ücret kuralı kimliği. Segments.vertical_ads_rate_type: Otel rezervasyonunun ücret türü (HotelRateType).

25.1 sürümü (19.08.2026)

Google Ads API v25.1'e aşağıdaki yeni özellikler ve güncellemeler eklendi. v25.1 gibi alt sürümlerde zarar veren değişiklikler bulunmaz.

Özellikler ve güncellemeler	Tür	Açıklama
Öğeler
AssetFieldType.TEXT_DISCLAIMER ServedAssetFieldType.TEXT_DISCLAIMER	Yeni enum değerleri	Metin sorumluluk reddi beyanı öğeleri için destek eklendi.
Kampanyalar
Campaign.aca_migration_date_time Campaign.broad_match_migration_date_time	Yeni alanlar	Maksimum Yapay Zeka'ya yapılacak otomatik taşıma işlemini takip edin.
Dönüşümler
Brand Lift ölçümleri	Yeni özellikler	Aşağıdaki güncellemelerle Brand Lift ölçümleri için destek eklendi: Artış araştırması sonuçları için yeni salt okunur boyut kaynakları eklendi: LiftMeasurementAgeRange, LiftMeasurementCampaign, LiftMeasurementDevice, LiftMeasurementGender ve LiftMeasurementVideo. LiftMeasurementConfig ile Brand Lift analizini ve yeni boyut kaynaklarını desteklemek için yeni segmentler ve metrikler eklendi. Şu numaralandırmalar eklendi: BrandLiftMeasurementType, LiftMeasurementFlightStatus, SurveyIntendedAction, SurveyLiftFlightTargetResponseMode ve SurveySubjectType.
Dönüşüm Artışı ölçümleri	Yeni özellikler	Aşağıdaki güncellemelerle Dönüşüm Artışı ölçümleri için destek eklendi: Artış çalışmasını temsil eden yeni bir salt okunur kaynak LiftMeasurementConfig eklendi. Dönüşüm artışı sonuçlarını segmentlere ayırmak ve filtrelemek için yeni seçilebilir segmentler eklendi. Artış performansının ayrıntılı istatistiksel analizini destekleyen 24 yeni dönüşüm artışı metriği ve kazanan puanı metriği eklendi. Kampanya ayrıntılarını ve dönüşüm hedeflerini alma desteği eklendi. İsteğe bağlı yeni bir alan (Experiment.lift_measurement_config) eklendi. ConversionLiftIncludedConversionActionTypes enum'u eklendi.
LiftMeasurementFlight	Yeni kaynak	Ölçülen yayın başlangıç ve bitiş tarihleri (start_date ve end_date) dahil olmak üzere bir artış ölçümü yapılandırmasının yayın ayrıntılarını temsil eden salt okunur yeni bir kaynak.
Genel
SmartCampaignError	Yeni enum değerleri	Maksimum Performans oluşturma kısıtlamaları için yeni özel hata kodları eklendi: 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	Yeni enum değeri / hata	TEST erişim düzeyine sahip bir Google Cloud projesi, test hesabı olmayan bir hesaba istek göndermeye çalıştığında döndürülür.
Planlama
Marka duyarlılığı analizleri	Yeni özellikler	ContentCreatorInsightsService'da marka yaklaşımı analizleri için destek eklendi: BrandSentimentInsight, SentimentInsightDistribution ve SentimentInsightSummary mesajları eklendi. Sentiment enum'u eklendi. ContentCreatorInsightsSupplementalData enum'una BRAND_SENTIMENT_DATA değeri eklendi. InsightsKnowledgeGraphEntityCapabilities enum'ına BRAND değeri eklendi.
BenchmarksService iyileştirme	Yeni özellikler	Karşılaştırma analizinin kapsamını belirlemek için filtre olarak kategoriler için destek eklendi. Ayrıca, işletme açısından kritik olan diğer metrikler de desteklenir: BenchmarksService.GenerateBenchmarksMetrics ve category_filter kullanarak bir veya daha fazla ürün ve hizmet kategorisinde reklam yayınlayan tüm reklamverenlerle karşılaştırma yapma seçeneği eklendi. Müşterinin toplam maliyeti ve görüntülemeleri gibi daha fazla müşteri reklamı metriği ile share_of_voice gibi paylaşım metrikleri gösterildi. Metrikler AggregateMetrics ve ShareMetrics kullanılarak döndürülür. Desteklenen kategorilerin listesi, CATEGORY kaynak türüyle BenchmarksService.ListBenchmarksSources kullanılarak alınabilir.
Ebeveynlik durumu hedefleme	Yeni özellik	Erişim Planlayıcı'da ebeveynlik durumu hedefleme desteği eklendi. ReachPlanService.GenerateReachForecast hizmeti için Targeting'e yeni parental_statuses alanı ve ReachPlanService.ListPlannableProducts hizmeti için PlannableTargeting'e parental_statuses alanı eklendi.
Öneriler
Recommendation.campaign_specific_app_goal_recommendation	Yeni öneri	Kampanyaya özel bir uygulama dönüşümü hedefi eklemenizi önerir. Yeni EffectiveAutomaticGoal kaynağı, bu önerideki mevcut hedefleri temsil etmek için kullanılır.
Raporlar
Metrics.original_conversion_value	Yeni alan	Teklif verilebilir dönüşümlerden elde edilen orijinal dönüşüm değerini temsil eder. Bu, dönüşüm değeri kuralları veya yaşam döngüsü hedefleri ayarlamaları gibi değer kuralı ayarlamaları uygulanmadan önceki ayarlanmamış dönüşüm değeridir.
Bağlılık programı üyeliği istatistikleri	Yeni özellikler	İstatistikleri kullanıcı bağlılık üyeliği programı durumuna göre segmentlere ayırma desteği ve dönüşüm değeri kuralları için bağlılık üyeliği birincil boyutu eklendi: Dönüşüm gerçekleştiren kullanıcının bağlılık programı katmanına göre rapor metriklerinin segmentlere ayrılmasını desteklemek için Segments.loyalty_membership segmenti eklendi. Bir dönüşüm değeri kuralı için bağlılık üyeliği koşulunun ne zaman karşılandığını belirlemek üzere LOYALTY_MEMBERSHIP birincil boyutu eklendi.
Hedefleme
vertical_ads_item_bid	Yeni ölçüt türü	AdGroupCriterion.criterion için yeni vertical_ads_item_bid ölçüt türü eklendi.

25 sürümü (22.07.2026)

Aşağıdaki yeni özellikler, güncellemeler ve zarar veren değişiklikler, ana sürüm olan Google Ads API v25'e eklendi.

Yardım için En yeni sürüme yükseltme başlıklı makaleyi inceleyin.

Zarar veren değişiklikler

İlk durum	Yeni durum	Değişiklik türü	Uygulama kılavuzu
Kampanyalar
CustomerLifecycleOptimizationValueSettings içindeki bağımsız alanlar additional_value ve additional_high_lifetime_value	Yeni value_multiplier ve high_lifetime_value_multiplier alanlarıyla birlikte sırasıyla value_adjustment ve high_lifetime_value_adjustment oneof'larının bir parçasıdır.	Yapısal değişiklik	Bu alanlar artık oneof'ların bir parçası olduğundan, bu alanlara yapılan referansları güncelleyin.
Eski CustomerLifecycleGoal ve CampaignLifecycleGoal kaynakları, bunlara karşılık gelen hizmetler CustomerLifecycleGoalService ve CampaignLifecycleGoalService ile eski ayarlar/numaralandırmalar (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings)	Yok	Kaldırma	Yenilenen birleştirilmiş hedefler şemasını kullanın: Goal kaynağındaki new_customer_acquisition_goal_settings alanını kullanın. Kampanyaya özel geçersiz kılmaları yapılandırmak için CampaignGoalConfig kaynağındaki campaign_new_customer_acquisition_settings alanını kullanın.
Genel
Teşvik Hizmeti isteği ve yanıt mesajlarındaki iç içe yerleştirilmiş enum alanları: FetchIncentiveRequest.type Incentive.type IncentiveOffer.type	Bağımsız enum alanları: FetchIncentiveRequest.incentive_type Incentive.incentive_type IncentiveOffer.offer_type	Yeniden adlandırma / kaldırma	Eski type alanları yerine yeni bağımsız enum alanlarını kullanın.
ApplyIncentiveRequest'daki isteğe bağlı selected_incentive_id ve customer_id alanları	Zorunlu alanlar	Davranış değişikliği	ApplyIncentive işlevini çağırırken her iki alanı da sağladığınızdan emin olun.
LocalServicesLead kaynağındaki tüketici e-posta adresi alanı ContactDetails.email	Yok	Kaldırma	Artık desteklenmediği için bu alana yapılan referansları kaldırın.
AdvertisingPartnerLinkInvitationProperties içinde isteğe bağlı allowed_domain alanı	Bir reklamcılık iş ortağı için CreateProductLinkInvitation aranırken zorunlu alan	Davranış değişikliği	Bir reklamcılık iş ortağı için ürün bağlantısı daveti oluştururken allowed_domain sağladığınızdan emin olun.
Planlama
GenerateCreatorInsightsRequest'daki search_brand alanı	Yok	Kaldırma	Bunun yerine search_topics kullanın.
Targeting içindeki plannable_location_id alanı ve GenerateReachForecastRequest içindeki cookie_frequency_cap alanı	Yok	Kaldırma	plannable_location_ids ve cookie_frequency_cap_setting kullanımına geçin.
Raporlar
GenerateBenchmarksMetricsResponse ve BreakdownMetrics uygulamalarındaki customer_metrics alanı, Metrics türündedir.	CustomerMetrics türünde alan	Tür değişikliği / davranış değişikliği	Entegrasyonlarınızı, yalnızca müşterinin reklam performansını temsil eden metrikleri içeren yeni CustomerMetrics türünü kullanacak şekilde güncelleyin.

Özellikler ve güncellemeler (kesintisiz)

Özellikler ve güncellemeler	Tür	Açıklama
Reklamlar
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS	Yeni enum değeri / davranışı	DemandGenMultiAssetAds tarihine kadar kullanılabilir. Etkinleştirilirse giriş olarak animasyonlu olmayan resimleri kullanarak animasyonlu resimler oluşturur. Yeni DemandGenMultiAssetAds, bu API sürümünden itibaren varsayılan olarak etkinleştirilir.
Yapay içerik bilgilerinin değiştirilebilirliği	Davranış değişikliği	Asset.synthetic_content_info ve Ad.synthetic_content_info, v25, v24 ve v23'te artık tamamen değiştirilebilir.
Kampanyalar
Bağlılık Elde Tutma Hedefi	Yeni özellikler / ayarlar	Reklamverenlerin kampanyaları bağlılık programı üyelerini elde tutmak için optimize etmesine olanak tanıyan Bağlılık Elde Tutma Hedefi için destek eklendi. GoalType enum'una LOYALTY_RETENTION eklendi. Teklif ayarlamaları ve üyelik avantajlarını PLA biçiminde gösterme dahil olmak üzere kampanyaya özel bağlılık programı müşteri elde tutma ayarlarını yapılandırmak için CampaignGoalConfig.campaign_loyalty_retention_settings eklendi. Hesap düzeyinde bağlılık elde tutma hedefi ayarlarını yapılandırmak için Goal.loyalty_retention_goal_settings eklendi. Yeni hata kodları eklendi: LOYALTY_RETENTION_GOAL_INVALID_MODE CANNOT_USE_INCOMPATIBLE_CLO_GOALS LOYALTY_RETENTION_GOAL_ALREADY_EXISTS
Yeni Müşteri Edinme Hedefi	Yeni özellikler / ayarlar	Yenilenen birleştirilmiş hedefler şemasını yansıtmak için Google Ads API'de güncellenen yeni müşteri edinme hedefi desteği: Goal kaynağı, new_customer_acquisition_goal_settings alanı kullanılarak yeni müşteri edinme ayarlarını destekleyecek şekilde genişletildi. campaign_new_customer_acquisition_settings alanını kullanarak yeni müşteri edinme için kampanyaya özel geçersiz kılmaları desteklemek üzere CampaignGoalConfig kaynağı genişletildi. Desteklenen hedef alt türlerini tanımlamak için yeni CustomerLifecycleOptimizationGoalSubType enum eklendi. NEW_CUSTOMER_ACQUISITION, GoalType enum'ına eklendi. GoalError'e yeni doğrulama hatası nedenleri eklendi: NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS CampaignGoalConfigError için yeni doğrulama hatası nedenleri eklendi: 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 Doğrulama hataları için yeni IncompatibleCloGoalsErrorDetails yapısını kullanıma sunmak üzere ErrorDetails.incompatible_clo_goal_error_details eklendi.
Dönüşümler
YouTube üçüncü taraf dönüşüm ilişkilendirme	Yeni alanlar	Üçüncü taraf iş ortakları kullanılarak YouTube dönüşümü ilişkilendirme doğrulaması için destek eklendi: Entegrasyon iş ortaklarının müşteri düzeyinde yapılandırılmasına olanak tanımak için CustomerThirdPartyIntegrationPartners.conversion_attribution_integration_partners eklendi. Entegrasyon iş ortaklarının kampanya düzeyinde yapılandırılmasına olanak tanımak için CampaignThirdPartyIntegrationPartners.conversion_attribution_integration_partners eklendi. Daha fazla bilgi için Yardım Merkezi makalesini inceleyin.
Genel
ContactDetails.phone_number_extension	Yeni alan	LocalServicesLead kaynağına eklendi.
IncentiveError	Yeni enum değerleri ve hatalar	Teşvik kullanma hataları için yeni özel hata kodları eklendi: BILLING_COUNTRY_NOT_ELIGIBLE (Müşterinin fatura adresinin bulunduğu ülke teşvik için uygun değil.) USER_IS_MCC_MANAGER (Kullanıcı bir yönetici hesabı olduğu için teşvikten yararlanamaz.) USER_SUSPENDED (müşteri hesabı askıya alındı) MAX_PENDING_INCENTIVES (Müşteri, maksimum bekleyen teşvik sayısına ulaştı) ACCOUNT_HAD_RECENT_SPEND (hesap yakın zamanda harcama yaptı ve uygun değil) MAX_INCENTIVES_REDEEMED_FROM_OFFER (Müşteri, bu tekliften maksimum sayıda teşvikten yararlanmıştır.) MISMATCHING_BILLING_COUNTRY_CODE (İstekte belirtilen fatura adresinin bulunduğu ülke kodu, müşterinin hesap ülkesiyle eşleşmiyor.)
Planlama
Trend analizlerinde YouTube kanalı ayrıntıları	Yeni alanlar	Arama trendi analizleri aranırken ilgili videoların daha fazla YouTube kanalı ayrıntısı için destek eklendi. YouTubeVideoAttributeMetadata tablosuna yeni channel_id, channel_name ve channel_url alanları eklendi.
YouTubeChannelInsights.data_sharing_consent_given	Yeni alan	YouTubeChannelInsights ekranına eklendi. İçerik üretici, herkese açık olmayan verileri paylaşmayı kabul ettiyse bu geçerlidir. Bu durumda aşağıdaki alanlar doldurulur: average_views_per_video average_likes_per_video average_comments_per_video engagement_rate channel_audience_attributes
Raporlar
ad_sub_format_type	Yeni segment	YouTube yayın içi atlanamayan reklamlarının süreye göre dökümünü sağlar: INSTREAM_NON_SKIPPABLE_STANDARD (standart süreli yayın içi atlanamayan reklam) INSTREAM_NON_SKIPPABLE_MAX30_SEC (30,99 saniyeden uzun olmayan, atlanamayan yayın içi reklam) INSTREAM_NON_SKIPPABLE_MAX60_SEC (60,99 saniyeden uzun olmayan yayın içi atlanamayan reklam) Bu segment her zaman ad_format_type ile birlikte seçilmelidir. AdGroup, AdGroupAd, Campaign, Customer, Video ve VideoEnhancement ile seçilebilir.
Videoya özel sosyal metrikler	Yeni alanlar / metrikler	Reklamverenlerin YouTube'daki Shorts reklamları için kullanıcı etkileşimini (yorumlar, beğeniler ve paylaşımlar) izlemesine yardımcı olmak amacıyla videoya özel sosyal metrikler eklendi: Metrics.youtube_comments Metrics.youtube_likes Metrics.youtube_shares AdGroup, AdGroupAd, Asset, Campaign, Customer ve Video dillerinde kullanılabilir.

v24 ana ve alt sürümleri

Google Ads API v24, aşağıdaki yeni özellikleri, güncellemeleri ve zarar veren değişiklikleri içerir.

24.2 sürümü (24.06.2026)

Google Ads API 24.2 sürümüne aşağıdaki yeni özellikler ve güncellemeler eklendi. 24.2 gibi alt sürümlerde zarar veren değişiklikler bulunmaz.

Özellikler ve güncellemeler	Tür	Açıklama
Reklamlar
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT	Yeni enum değeri	DemandGenVideoResponsiveAd örnekleri (bu API sürümünden itibaren varsayılan olarak etkinleştirilir) için etkileşim panelinde gösterilecek açılış sayfası metin bilgilerini oluşturur.
Öğeler
AssetGroup.google_local_services_info	Yeni alan	Maksimum Performans kampanyalarında Yerel Hizmet Reklamları bilgilerini (kategori kimliği ve açıklama metinleri) desteklemek için eklendi.
AssetGroupSignal.local_services_id	Yeni alan	Maksimum Performans kampanyalarında Yerel Hizmet Reklamları hizmet kimliği sinyallerini desteklemek için eklendi.
AssetGroupSignal.vertical_ads_item_group_rule_list	Yeni alan	Maksimum Performans kampanyalarında ekli dikey feed'lerden öğe seçmek için dikey reklam öğe grubu kurallarını desteklemek üzere eklendi. Bu özellik yalnızca izin verilenler listesindeki hesaplarda kullanılabilir.
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN	Yeni enum değeri / hata	Bir kampanyadaki tüm öğe grupları kaldırılmaya çalışıldığında döndürülür.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS	Yeni enum değeri / hata	Bir öğe grubundan tüm sinyaller kaldırılmaya çalışıldığında döndürülür.
Kampanyalar
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings Campaign.PmaxCampaignSettings.local_services_enabled	Yeni alanlar	Yerel Hizmetler Maksimum Performans kampanyalarını tanımlama desteği
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps	Yeni alan	Talep Yaratma reklam grupları için seçilebilir kanallara Google Haritalar'ı dahil eder.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN	Yeni enum değeri / hata	Yerel hizmetler Maksimum Performans kampanyasından tüm konumlar kaldırılmaya çalışıldığında döndürülür.
SmartCampaignErrorEnum.CREATION_FAILED	Yeni enum değeri / hata	Yeni akıllı kampanyalar oluşturmaya çalışırken döndürülür.
Dönüşümler
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS	Yeni enum değerleri	Bir kullanıcı yerel hizmet reklamını tıklayıp reklamvereni aradığında, reklamverene mesaj gönderdiğinde veya reklamverenden rezervasyon yaptığında gerçekleşen dönüşümleri temsil eder.
Denemeler
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION	Yeni enum değerleri	Yeni ExperimentType türleri için destek eklendi: COMPARE_CAMPAIGNS: Tek bir denemede aynı veya farklı türlerdeki birden fazla kampanyayı karşılaştıran kampanya karması denemeleri ve özel Maksimum Performans denemeleri için. PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION: Metin özelleştirme ve nihai URL genişletmesi için Maksimum Performans optimizasyon denemeleri.
Genel
Asset.synthetic_content_info Ad.synthetic_content_info	Yeni alanlar	advertiser_attestation (doğrudan reklamveren tarafından sağlanan beyanlar) ve system_attestation (sistem tarafından otomatik olarak algılanan veya sağlanan onaylar) olmak üzere ikiye ayrılmış, yapay/yapay zekayla üretilmiş içeriklerle ilgili onaylar içerir. Bu özellik, 23 ve 22 sürümlerine de eklenmiştir. 25. sürüm için planladığınız entegrasyon çalışmalarına yardımcı olmak amacıyla, reklamveren onay alanlarını değiştirme arayüzü 22. sürüm ve sonraki sürümlerde erken kullanıma sunuluyor. Arayüz bu sürümlerde görünür ancak synthetic_content_info.advertiser_attestation.status ve synthetic_content_info.advertiser_attestation.source bu sürümlerde değişmez kalır. Bu alanlardan birinde değişiklik isteğinde bulunmaya çalışırsanız aşağıdaki hatalardan biri döndürülür: "The field attempted to be mutated is immutable" (Değiştirilmeye çalışılan alan değiştirilemez) veya "Field cannot be set" (Alan ayarlanamıyor). Bu alanlar, v25'ten itibaren tamamen değiştirilebilir hale gelecek. Sisteminizin 25. sürüm kullanıma sunulduğunda tam yazma özelliklerine hazır olması için dahili mantığınızı oluşturup test etmek üzere arayüzü hemen kullanmanızı öneririz.
Çok Taraflı Yetkilendirme	Yeni özellikler	Beta: Bu özellik şu anda beta sürümündedir ve gelecekteki sürümlerde değiştirilebilir. Çok Taraflı Yetkilendirme (MPA) incelemeleri için destek eklendi: MultiPartyAuthReview kaynağı ve ilgili MultiPartyAuthReviewService eklendi. İnceleme durumunu izlemek için MultiPartyAuthReviewStatus enum'u eklendi. Bekleyen bir incelemeye bağlantı oluşturmak için CustomerUserAccess.pending_multi_party_auth_review eklendi. İlişkili yorum kaynağı adını döndürmek için MutateCustomerUserAccessResult.multi_party_auth_review ve MutateCustomerUserAccessInvitationResult.multi_party_auth_review eklendi. Doğrulama hataları için MultiPartyAuthReviewError eklendi. Bu özellik v23.3, v22.2 ve v21.2 sürümlerine de eklenmiştir.
IncentiveService.FetchIncentive	Davranış değişikliği	İstekte geçersiz bir e-posta adresi sağlandığında yöntem artık AuthenticationError.INVALID_EMAIL_ADDRESS hatası vermek yerine varsayılan teşvik tekliflerini döndürür.
Planlama
GenerateCreatorInsightsRequest.search_topics	Yeni alan	ContentCreatorInsightsService.GenerateCreatorInsights hizmetine eklendi. Bu seçenek, country_locations bölümünde belirtilen ülkede bir konu hakkında konuşan içerik üreticileri arar (yalnızca bir ülkede arama yapmayı destekler).
CREATOR_TOPIC_INSIGHTS	Yeni enum değeri	Bir konu hakkında konuşan içerik üreticileri aramak için kullanılan öğeleri belirtmek üzere InsightsKnowledgeGraphEntityCapabilities simgesi eklendi. Bu varlıklar search_topics alanında kullanılmalıdır. AudienceInsightsService.ListAudienceInsightsAttributes kullanılarak alındı.
KnowledgeGraphEntitySearchOptions	Yeni tür / seçenekler	ListAudienceInsightsAttributes'da konular için ek arama seçenekleri içerir. Bu seçenekler arasında, içerik üretici özellikleri olarak desteklenen tüm konuları alma ve özelliklere göre filtreleme yer alır.
GenerateCreatorInsightsRequest.supplemental_data GenerateTrendingInsightsRequest.supplemental_data	Yeni alanlar	ContentCreatorInsightsService yöntemleri için isteğe bağlı girişler. Bu alanın sağlanması, yanıtta ek konumlar veya içerik üretici özellikleri doldurur.
local_creator_insights related_local_creators	Yeni alanlar	supplemental_data, LOCAL_CREATOR_DATA enum'unu içerdiğinde doldurulur. Seçilen ülkede görüntülenen veya bu ülkede bulunan ve konum verilerini paylaşmayı kabul eden yerel içerik üreticileri gösterir.
GenerateTrendingInsightsRequest.sub_country_locations	Yeni alan	ContentCreatorInsightsService.GenerateTrendingInsights'e eklenerek ülke konumu ve alt ülke konumları kullanılarak trend analizleri için arama yapılmasına olanak tanındı.
Raporlar
PerformanceMaxPlacementView	Segmentler uzantısı	ad_network_type tarafından segmentlere ayrılabilir hale getirildi.
Alışveriş
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads	Yeni alan	Doğru ise Alışveriş reklamları için marka hariç tutmaları yoksayılır. Yalnızca Alışveriş kampanyaları için desteklenir.
Hedefleme
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE	Yeni enum değeri / hata	İzin verilmeyen bir dili hedeflemeye çalışıldığında döndürülür.
Videolar
DataLink.youtube_link_metadata	Yeni alan	Bağlı YouTube marka kanalının kimliğini belirtmek için brand_channel_id içerir.

24.1 sürümü (13.05.2026)

Google Ads API 24.1 sürümüne aşağıdaki yeni özellikler ve güncellemeler eklendi. v24.1 gibi küçük sürümlerde zarar veren değişiklikler bulunmaz.

Özellikler ve güncellemeler	Tür	Açıklama
Reklamlar
DemandGenMultiAssetAdInfo.classic_display_images	Yeni alan	Özel olarak yüklenen görüntülü reklam resimleri, ek duyarlı öğeler gerektirmeden yayınlanır.
Denemeler
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING	Yeni enum değerleri	Yeni ExperimentType türleri için destek eklendi: ADOPT_AI_MAX: Maksimum Yapay Zeka'nın Google Yapay Zeka ve geniş eşlemeli anahtar kelimeler aracılığıyla daha fazla müşteriyle etkileşim kurmanıza nasıl yardımcı olabileceğini test eden denemeler için. ADOPT_BROAD_MATCH_KEYWORDS: Geniş eşlemeli anahtar kelimelerin, reklamlarınızın göründüğü arama sayısını nasıl etkileyebileceğini test eden denemeler için. OPTIMIZE_ASSETS: Öğeleri optimize etmeye yönelik özel denemeler için. PMAX_REPLACEMENT_SHOPPING: Alışveriş kampanyalarınızın Maksimum Performans'a kıyasla performansını test eden denemeler için.
Experiment.video_experiment	Yeni alan	Video kampanyalarından oluşan mevcut YOUTUBE_CUSTOM denemeleri için yapılandırma desteği.
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info	Yeni alanlar	Deneme kollarında öğe testi, öğe grupları ve Maksimum Performans ayarlarını desteklemek için alanları kullanıma sunar: asset_testing_info: Reklamların deneme kopyalarıyla ilişkili öğelerin ayrıntıları. asset_groups: Öğe optimizasyonu denemeleri için deneme kolundaki öğe gruplarının listesi. performance_max_experiment_arm_info: PMAX_REPLACEMENT_SHOPPING denemelerindeki Maksimum Performans kampanyalarının ayarları.
Genel
CustomerUserAccess.passkey_enabled	Yeni alan	Kullanıcının geçiş anahtarını etkinleştirip etkinleştirmediğini gösteren salt okunur alan.
Raporlar
mobile_device_platform	Yeni segment	Raporların kullanıcı cihazının platformuna (ör. iOS veya Android) göre segmentlere ayrılmasına olanak tanır.
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED	Yeni enum değeri / hata	İstenen günlük, saatlik veya haftalık zaman ayrıntı düzeyi, sorgu tarih aralıkları için desteklenmediğinde (yalnızca son 37 ay için kullanılabilir) döndürülür.
vertical_ads_listing_user_rating vertical_ads_listing_venue	Yeni segmentler	Dikey reklamlar için kullanılacak yeni segmentler.
user_rating, venue ve event_participant_display_name	Yeni filtre ölçütleri	SharedCriterion kaynağı için VerticalAdsItemGroupRuleInfo'da filtreleme desteklenir.
Kontrol/değerlendirme denemesi metrikleri	Yeni alanlar	Yedi temel metrik ailesinde (tıklama sayısı, gösterim sayısı, maliyet, dönüşüm sayısı, dönüşüm başına maliyet, dönüşüm değeri, maliyet başına dönüşüm değeri) kontrol değerleri (control_clicks vb.), deney değerleri (clicks vb.), nokta tahminleri (clicks_point_estimate vb.), hata payları (clicks_margin_of_error vb.) ve p değerleri (clicks_p_value vb.) eklendi.
Dönüşüm sayısı mutlak değişim metrikleri	Yeni alanlar	Nokta tahmini, hata payı ve p değeri alanlarını kullanarak Conversions mutlak fark tahminleri için destek.
Hedefleme
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS	Yeni enum değeri / hata	Tüm demografi hedefleri hariç tutulmaya çalışıldığında döndürülür.
Videolar
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR	Yeni enum değeri	ZEFR, üçüncü taraf görüntülenebilirlik entegrasyon iş ortağı olarak yayınlandı.
DataLink.youtube_video.channel_id	Yeni alan	Veri bağlantısıyla ilişkili YouTube kanal kimliğini gösterir.

24 sürümü (22.04.2026)

Önemli bir sürüm olan Google Ads API 24 sürümüne aşağıdaki yeni özellikler, güncellemeler ve zarar veren değişiklikler eklendi.

Yardım için En yeni sürüme yükseltme başlıklı makaleyi inceleyin.

Zarar veren değişiklikler

İlk durum	Yeni durum	Değişiklik türü	Uygulama kılavuzu
Reklamlar
DemandGenVideoResponsiveAdInfo içinde isteğe bağlı videos ve logo_images	Zorunlu alanlar	Davranış değişikliği	Duyarlı Talep Yaratma video reklamları oluştururken veya değiştirirken videos ve logo_images değerlerini sağlayın.
VideoResponsiveAdInfo uygulamasında isteğe bağlı videos, business_name ve logo_images	Zorunlu alanlar	Davranış değişikliği	Video duyarlı reklamlar oluştururken veya değiştirirken videos, business_name ve logo_images değerlerini sağlayın. VideoResponsiveAdInfo öğesinin artık değiştirilebilir olduğunu unutmayın.
Kampanyalar
Campaign.video_brand_safety_suitability	Yok	Kaldırma	Kampanya düzeyinde uygunluk kontrolü kaldırıldı. Marka güvenliği uygunluğu, müşteri düzeyinde kullanılmaya devam etmektedir. Bunun yerine Customer.video_brand_safety_suitability kullanın.
Dönüşümler
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	Yok	Kaldırma	Bağlılık programı kayıtları kullanıcı kategorisi kaldırıldı. Kodda bu API'ye yapılan referansları kaldırın.
Planlama
topic_audience_combinations için InsightsAudienceAttributeGroup türü	common.InsightsAudienceAttributeGroup türü	Davranış değişikliği / tür değişikliği	Türlenmiş istemci kitaplıkları entegrasyonları, yeni kaynak ad alanlarını kullanacak şekilde güncellenmelidir.
ReachPlanService.ListPlannableProducts içindeki youtube_select_lineups alanı	Yok	Kaldırma	youtube_select_lineup_targeting kanal listelerini kullanmaya geçin.
ContentCreatorInsightsService.GenerateCreatorInsights ve GenerateTrendingInsights'daki is_brand_connect_creator alanı	Yok	Kaldırma	Bunun yerine, içerik üreticinin partnership_opportunities'da CREATOR_PARTNERSHIPS seçeneğini sunup sunmadığını kontrol edin.
KeywordPlanIdeaService.GenerateKeywordForecastMetrics içinde geo_modifiers ve biddable_keywords	geo_target_constants ve keywords	Yeniden adlandırma / kaldırma	CampaignToForecast.geo_target_constants[] ve ForecastAdGroup.keywords[] ile değiştirildi.
GenerateKeywordForecastMetrics sürümünde desteği sonlandırılan anahtar kelime planı / tahmin alanları	Yok	Kaldırma	Aşağıdaki plan / tahmin alanları ve türleri kaldırıldı: CampaignToForecast.keyword_plan_network CampaignToForecast.negative_keywords ve ForecastAdGroup.negative_keywords ForecastAdGroup.max_cpc_bid_micros BiddableKeyword CriterionBidModifier KeywordForecastMetrics.impressions KeywordForecastMetrics.click_through_rate Entegrasyonları buna göre güncelleyin.
Raporlar
campaign_budget içindeki ad_sub_network_type segmenti	Yok	Kaldırma	campaign_budget kaynağı için ad_sub_network_type segmenti kaldırıldı.
Öğe görünümlerinde click_type segmenti	Yok	Kaldırma	AdGroupAsset, CampaignAsset ve CustomerAsset görünümlerinden segment kaldırıldı.
Videolar
ShareablePreviewService.GenerateShareablePreviews içinde kısmi hataya izin verilir.	Kısmi hata yok	Davranış değişikliği	İçindeki kimliklerden herhangi birinin doğrulaması başarısız olursa istekler başarısız olur ve hata döndürülür.
ShareablePreviewError eski kodlar: ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER TOO_MANY_ASSET_GROUPS_IN_REQUEST	MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST	Yeniden adlandırma / davranış değişikliği	Öğe grupları için döndürülen hata kodları, reklam grubu reklam hatalarıyla uyumlu olacak şekilde değiştirildi. Doğrulama yakalama mantığını güncelleyin.

Özellikler ve güncellemeler (kesintisiz)

Özellikler ve güncellemeler	Tür	Açıklama
Reklamlar
VideoResponsiveAdInfo öğesinin değişkenliği	Davranış değişikliği	Duyarlı video reklam bilgisi nesneleri artık değiştirilebilir.
Öğeler
AssetSet alt bölgesinde travel_feed_data	Yeni alan	Seyahat feed'i öğe özelliklerini (hotel_center_account_id, merchant_center_id, partner_center_id, subset_id, travel_feed_vertical_type) almak için eklendi.
Kampanyalar
Campaign.view_through_conversion_optimization_enabled	Yeni alan	Talep Yaratma ve uygulama kampanyalarında görüntüleme dönüşümü (GD) optimizasyonunun (varsayılan false) etkinleştirilmesine olanak tanır.
CampaignCriterion.gender	Yeni özellik	Tüm Google Ads API sürümlerinde Maksimum Performans kampanyaları için cinsiyet hariç tutmaları etkinleştirildi.
Dönüşümler
Potansiyel müşteri kazanma dönüşümü türleri	Yeni enum değerleri	ConversionActionType içinde yeni GA4/Firebase dönüşüm işlemi türü enum'ları eklendi: 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
Genel
UserListErrorEnum.DUPLICATE_LOOKALIKE	Yeni enum değeri / hata	Birden fazla aynı benzer liste oluşturmaya çalışıldığında döndürülür.
Planlama
ListPlannableProductsResponse içindeki ProductCoreAttributes alan	Yeni alanlar	ListPlannableProductsResponse altındaki ProductCoreAttributes için planlanabilir ürün açıklaması, pazarlama hedefi, maliyet modeli ve satın alma yöntemi eklendi.
Raporlar
CartDataSalesView	Yeni raporlama kaynağı	Tıklanan ürünün yanı sıra satılan belirli ürüne (marka vb.) göre dönüşüm metriklerini segmentlere ayıran raporları gösterir.
Teklif verilemeyen metrikler	Yeni alanlar	Eşleşen tüm kaynaklara teklif verilmeyen metrikler (kampanyaların optimize etmediği dönüşümleri gösteren metrikler) eklendi: 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	Yeni segment	ShoppingPerformanceView ekranına eklendi.
Alışveriş
ShoppingProduct uygulamasındaki uygulama kampanyaları	Yeni özellik	ShoppingProduct kaynağında desteklenen uygulama kampanyaları. Not durumu ve sorunlar desteklenmez.
Etikete dayalı ürün filtreleme	Yeni özellik	Mantıksal küme ifadeleri kullanılarak dinamik filtreleme özelliği kullanıma sunuldu: RETAIL_FILTER_BUNDLE ve RETAIL_FILTER ölçüt türleri eklendi. RETAIL_FILTER paylaşılan küme türü eklendi. retail_filter_bundle alanı AdGroupCriterion öğesine eklendi. SharedCriterion öğesine retail_filter alanı eklendi. RETAIL, ListingGroupFilterListingSource listesine eklendi. AssetGroupListingGroupFilter raporuna RetailFilter boyutu eklendi. CriterionError ve AssetGroupListingGroupFilterError ile ilgili yeni doğrulama hataları eklendi. Bu özellik yalnızca izin verilenler listesindeki hesaplarda kullanılabilir.

v23 ana ve alt sürümleri

Google Ads API v23, aşağıdaki yeni özellikleri, güncellemeleri ve zarar veren değişiklikleri içerir.

v23.3 (24.06.2026)

Google Ads API v23.3'e aşağıdaki yeni özellikler ve güncellemeler eklendi. 23.3 gibi alt sürümlerde zarar veren değişiklikler bulunmaz.

Özellikler ve güncellemeler	Tür	Açıklama
Genel
Asset.synthetic_content_info Ad.synthetic_content_info	Yeni alanlar	advertiser_attestation (doğrudan reklamveren tarafından sağlanan beyanlar) ve system_attestation (Google'ın sistemleri tarafından otomatik olarak algılanan veya sağlanan onaylar) olmak üzere ikiye ayrılmış, yapay/yapay zekayla üretilen içeriklerle ilgili onayları içerir. 25. sürüm için yaklaşan entegrasyon çalışmalarınızı planlamanıza yardımcı olmak amacıyla, reklamveren onay alanlarını değiştirme arayüzü 22. ve sonraki sürümler için erken kullanıma sunuluyor. Arayüz bu sürümlerde görünür ancak synthetic_content_info.advertiser_attestation.status ve synthetic_content_info.advertiser_attestation.source bu sürümler için değişmez olarak kalır. Bu alanlardan birinde değişiklik isteğinde bulunmaya çalışırsanız aşağıdaki hatalardan biri döndürülür: "The field attempted to be mutated is immutable" (Değiştirilmeye çalışılan alan değiştirilemez) veya "Field cannot be set" (Alan ayarlanamıyor). Bu alanlar, v25'ten itibaren tamamen değiştirilebilir hale gelecek. Sisteminizin 25. sürüm kullanıma sunulduğunda tam yazma özelliklerine hazır olması için dahili mantığınızı oluşturup test etmek üzere arayüzü hemen kullanmanızı öneririz.
Çok taraflı onaylar	Yeni özellikler	Beta: Bu özellik şu anda beta sürümündedir ve gelecekteki sürümlerde değiştirilebilir. Çok taraflı onay (MPA) incelemeleri için destek eklendi: MultiPartyAuthReview kaynağı ve ilgili MultiPartyAuthReviewService eklendi. Yorum durumunu izlemek için MultiPartyAuthReviewStatus enum'u eklendi. Bekleyen bir incelemeye bağlantı oluşturmak için CustomerUserAccess.pending_multi_party_auth_review eklendi. İlişkili yorum kaynağı adını döndürmek için MutateCustomerUserAccessResult.multi_party_auth_review ve MutateCustomerUserAccessInvitationResult.multi_party_auth_review eklendi. Doğrulama hataları için MultiPartyAuthReviewError eklendi.

23.2 sürümü (25.03.2026)

Google Ads API 23.2 sürümüne aşağıdaki yeni özellikler ve güncellemeler eklendi. 23.2 gibi alt sürümlerde zarar veren değişiklikler bulunmaz.

Özellikler ve güncellemeler	Tür	Açıklama
Öğeler
VideoEnhancement	Yeni kaynak	Google tarafından mı yoksa reklamveren tarafından mı sağlandığı gibi geliştirmeye özgü video reklam bilgilerini içerir. Daha fazla bilgi edinmek için Video iyileştirmeleri hakkında başlıklı makaleyi inceleyin.
AppTopCombinationView	Yeni kaynak	Uygulama kampanyalarındaki en iyi performans gösteren öğe kombinasyonları hakkında analizler sağlayan salt okunur kaynak.
CustomerAsset	Yeni özellik	field_type, BUSINESS_LOGO olarak ayarlanmışken CustomerAsset öğesini alma desteği eklendi.
Kampanyalar
AdGroupAd.start_date_time AdGroupAd.end_date_time	Yeni alanlar	Kampanya tarihleri üzerinde daha ayrıntılı planlama kısıtlamaları sağlayın. Bu özellik yalnızca bazı reklam grubu türlerinde desteklenir.
HotelSettingInfo.disable_hotel_setting	Yeni alan	Talep Yaratma kampanyalarında otel feed'ini devre dışı bırakmanıza olanak tanır.
Genel
CustomerClientLinkError	Yeni enum değerleri / hatalar	MAX_CUSTOMER_LIMIT_REACHED ve ACCOUNT_CREATION_POLICY_VIOLATION olmak üzere iki yeni hata kodu eklendi.
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	Davranış değişikliği	Artık desteği sonlandırılan bu kullanıcı listesi müşteri türü kategorisi kullanılmaya çalışıldığında hata veriliyor.
Planlama
GenerateTrendingInsights GenerateCreatorInsights	Yeni özellikler	Varlıkların, konuların ve kitlelerin özel VE/VEYA kombinasyonları için destek eklendi.
ReachPlanService.GenerateReachForecast	Yeni enum değerleri	AGE_RANGE_21_44 veya AGE_RANGE_21_49 gibi yeni hedeflenebilir yaş grupları eklendi.
youtube_select_lineup_targeting	Yeni alan	ReachPlanService.ListPlannableProducts'e eklendi. youtube_select_lineups, bu yeni sürümle değiştirilecek. Şu anda her iki alan da doldurulmuş durumda.
ReachPlanSurface	Yeni enum değeri	IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS, yüzey seçeneği olarak eklendi.
Forecast	Yeni alan	ReachPlanService.GenerateReachForecast'da Talep Yaratma için tıklamaları artırma (TBM) clicks eklendi.
partnership_opportunities	Yeni alan	ContentCreatorInsightsService.GenerateCreatorInsights ve ContentCreatorInsightsService.GenerateTrendingInsights listelerine eklendi.
Raporlar
biddable_indirect_install_first_in_app_conversion_micros	Yeni alan	Campaign, Customer ve AdGroup kaynaklarına eklendi.
Videolar
ShareablePreviewService	Yeni özellik	preview_type, YOUTUBE_LIVE_PREVIEW olarak ayarlanarak YouTube Canlı önizlemelerini destekleyecek şekilde genişletildi. UNSUPPORTED_AD_TYPE ve TOO_MANY_RESOURCES_IN_REQUEST, ShareablePreviewError grubuna eklendi. Bu özellik yalnızca bazı reklam türleri için desteklenir.

v23.1 (25.02.2026)

Google Ads API v23.1'e aşağıdaki yeni özellikler ve güncellemeler eklendi. v23.1 gibi alt sürümlerde zarar veren değişiklikler bulunmaz.

Özellikler ve güncellemeler	Tür	Açıklama
Hesap yönetimi
advertising_partner_properties.allowed_domain	Yeni alan	ProductLinkInvitation ve ProductLink kaynaklarına eklendi. Reklamcılık iş ortağı yalnızca bu alan adında reklam yayınlayabilir.
Customer.contains_eu_political_advertising	Yeni alan	AB'yi hedefleyen siyasi reklamlar içerip içermediğine dair hesap düzeyindeki beyan durumunu alır ve EuPoliticalAdvertisingStatus döndürür.
Kampanyalar
Campaign.text_guidelines	Yeni alan	Maksimum Performans ve Arama Ağı kampanyalarında kullanılabilen ve yapay zeka tarafından oluşturulan metin öğelerini programatik olarak kontrol etmenizi sağlayan metin kuralları için destek eklendi. text_guidelines içinde term_exclusions ve messaging_restrictions tanımlayabilirsiniz.
CampaignPrimaryStatusReason	Yeni enum değerleri	FIXED_CPM teklif stratejisini kullanan kampanyalar için birincil durum nedenlerini sağlamak üzere CAMPAIGN_NOT_BOOKED, BOOKING_HOLD_EXPIRING, BOOKING_HOLD_EXPIRED ve BOOKING_CANCELLED eklendi.
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure Campaign.VideoCampaignSettings.booking_details	Yeni alanlar	Rezervasyon reklamı kategorisi için otomatik açıklama ve salt okunur rezervasyon ayrıntıları desteği eklendi.
Campaign.missing_eu_political_advertising_declaration	Yeni alan	AB'yi hedefleyen siyasi reklamlar içerip içermediğiyle ilgili beyanların eksik olduğu kampanyaları sorgulamayı ve filtrelemeyi destekler.
Dönüşümler
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS	Yeni enum değeri	Reklam izleyen ve daha sonra aynı kanalda bir video izleyen kullanıcıların izlenmesini destekler.
Genel
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED	Yeni enum değeri / hata	Demografi boyutlarında yalnızca belirlenmemiş kategoriyi hedeflemeye çalışırken döndürülür.
Teşvikler
IncentiveErrorEnum	Yeni enum değerleri / hatalar	MAX_INCENTIVES_REDEEMED ve ACCOUNT_TOO_OLD olmak üzere iki yeni hata kodu eklendi. Bu hatalar, 11 Mart 2026'da veya daha sonra yapılan istekler için döndürülebilir.
Planlama
GenerateBenchmarksMetrics	Yeni özellik	BreakdownDefinition kullanılarak tarih dökümleri için destek eklendi.
ReachPlanService.GenerateReachForecast	Yeni enum değeri	GOOGLE_DISPLAY_NETWORK, Talep Yaratma dönüşümleri artırma için hedeflenebilir bir yüzey olarak eklendi.
GenerateTrendingInsights	Yeni alanlar	Konuya göre arama yaparken TrendInsightDataPoint içindeki geçmiş trend çizgisi bilgileri TrendInsights aracına eklendi.
Raporlar
Benzersiz kullanıcı sıklığı metrikleri	Yeni alanlar	Reklamınızı en az iki, üç, dört, beş veya on kez gören kullanıcı sayısını bildiren yeni metrikler eklendi: unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus ve unique_users_ten_plus.
SearchTermMatchSource	Yeni enum değeri	Seyahat reklamları gibi dikey reklam veri feed'lerini desteklemek için VERTICAL_ADS_DATA_FEED eklendi.
YouTubeVideoUpload
YouTubeVideoUpload	Yeni hizmet / kaynak	YouTube'da video yükleme ve yönetmeyi desteklemek için YouTubeVideoUpload hizmeti, yükleme durumunu ve meta verileri getirmeyi desteklemek için YouTubeVideoUpload kaynağı eklendi. Bu özellik yalnızca REST ve Python istemci kitaplığı için desteklenir.

23 sürümü (28.01.2026)

Aşağıdaki yeni özellikler, güncellemeler ve zarar veren değişiklikler, önemli bir sürüm olan Google Ads API 23 sürümüne eklendi.

Yardım için En yeni sürüme yükseltme başlıklı makaleyi inceleyin.

Zarar veren değişiklikler

İlk durum	Yeni durum	Değişiklik türü	Uygulama kılavuzu
Reklamlar
Reklam paylaşımına izin verilir.	AdGroupAdError.AD_SHARING_NOT_ALLOWED	Davranış değişikliği	Birden fazla reklam grubu arasında reklam paylaşımına artık izin verilmiyor. Reklam paylaşmaya çalışan istekler AD_SHARING_NOT_ALLOWED hatası döndürür.
CallAd ve CallAdInfo için destek	Yok	Kaldırma	Telefon araması reklamlarına yönelik destek kaldırıldı. Telefon araması reklamları hakkında başlıklı Yardım Merkezi makalesini inceleyin.
Kampanyalar
Campaign.start_date Campaign.end_date	Campaign.start_date_time Campaign.end_date_time	Yeniden adlandırma / değiştirme	Kampanyaların zaman bileşenlerini belirtmek için yeni tarih-saat alanlarını kullanın. Yalnızca tarih içeren orijinal alanlar kaldırılır.
Talep Yaratma
DemandGenMultiAssetAdInfo.lead_form_only	Yok	Kaldırma	lead_form_only alanı kaldırıldı. Kodunuzdaki referansları güncelleyin.
Raporlar
Toplu öğe performans etiketi metrikleri ve enum	Yok	Kaldırma	Toplu öğe performansı etiketi metrikleri kaldırıldı. Performans etiketi numaralandırması artık Arama Ağı ve Görüntülü Reklam Ağı için döndürülmüyor.

Özellikler ve güncellemeler (bozucu olmayan)

Özellikler ve güncellemeler	Tür	Açıklama
Reklamlar
AdFormatType	Yeni enum değerleri	Yeni biçim türleri eklendi: TEXT, VERTICAL_ADS_BOOKING_LINK ve VERTICAL_ADS_PROMOTION.
Öğeler
asset_group görünümü	Yeni alanlar	Şu metrikler eklendi: metrics.engagements, metrics.engagement_rate ve metrics.average_cpe.
asset_group_asset görünümü	Yeni alanlar	Şu metrikler eklendi: metrics.average_cpe, metrics.average_cpm, metrics.trueview_average_cpv, metrics.video_trueview_view_rate, metrics.video_trueview_views ve metrics.interaction_event_types.
Asset.orientation	Yeni alan	Resim ve video öğelerine salt okunur yön alanı eklendi.
CampaignAsset	Yeni özellik	field_type, HEADLINE ve DESCRIPTION olarak ayarlanmış kampanya öğelerini alma desteği eklendi.
ServedAssetFieldType	Yeni enum değerleri	Site bağlantısı olarak yayınlanan öğeler için HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE ve DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO eklendi.
BusinessMessageAsset	Yeni özellikler / destek	Güncellenen işletme mesajı öğeleri: Facebook Messenger ve Zalo'nun sağlayıcı olarak desteklenmesi eklendi. FACEBOOK_MESSENGER ve ZALO, BusinessMessageProvider grubuna eklendi. facebook_messenger_info ve zalo_info alanları eklendi. CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS, AssetError listesine eklendi.
Faturalandırma
InvoiceService.ListInvoices	Yeni seçenekler	Artık Invoice içinde daha ayrıntılı bilgiler döndürebilirsiniz. Kampanya düzeyinde maliyet dökümü, kalem kalem düzenleyici maliyetler ve ayarlama bilgileri gibi ayrıntıları ListInvoicesRequest içinde include_granular_level_invoice_details'ı ayarlayarak döndürebilirsiniz.
RegulatoryFeeType UnitOfMeasure	Yeni enum veri türleri	Yasal ücretler ve ölçü birimleri için yardımcı enum'lar eklendi.
Kampanyalar
CampaignError	Yeni enum değerleri / hatalar	DURATION_TOO_LONG_FOR_TOTAL_BUDGET ve END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET hata kodları eklendi.
Dönüşümler
ConversionActionCategory	Yeni enum değeri	Bir reklamı izledikten sonra aynı kanaldan bir video izleyen kullanıcıların izlenmesini desteklemek için YOUTUBE_FOLLOW_ON_VIEWS eklendi.
Talep Yaratma
DemandGenVideoResponsiveAdInfo.companion_banner	Yeni alan	Talep Yaratma duyarlı video reklamlarında tamamlayıcı banner'lar için destek eklendi.
Teşvikler
Kendi Ödülünüzü Seçin (CYO) ödülleri desteği eklendi: Kullanıcıya sunulan kişiselleştirilmiş teşvikleri almak için FetchIncentive yöntemi eklendi. Seçilen bir teşviki müşteri hesabına uygulamak için ApplyIncentive yöntemi eklendi. Kullanım ayrıntılarını sağlamak için AppliedIncentive kaynağı (Search ve SearchStream kullanılarak sorgulanabilir) eklendi. IncentiveError ve AuthenticationError.INVALID_EMAIL_ADDRESS dillerine yeni hata kodları eklendi. Hataların daha ayrıntılı programatik olarak işlenmesini kolaylaştırmak için gelecekteki sürümlerde IncentivesService sınıfına ek hata kodları ekleyeceğiz. Uygulamalarınızın bu yeni hata modlarını yönetebildiğinden emin olmak için yaklaşan duyuruları ve bu yeni hata kodlarıyla ilgili sürüm notlarını takip etmenizi öneririz.
Planlama
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST	Yeni enum değeri	GenerateAudienceCompositionInsights, GenerateSuggestedTargetingInsights, GenerateInsightsFinderReport ve GenerateCreatorInsights dillerinde Yaşamdaki Önemli Olaylar'ı kullanarak kitle oluşturmaya olanak tanır. Yaşamdaki önemli olaylar, AudienceInsightsService.GenerateAudienceOverlap ve AudienceInsightsService.GenerateTargetingSuggestionMetrics gibi diğer AudienceInsightsService yöntemleri için desteklenmez.
ReachPlanService.GenerateConversionRates	Yeni alanlar / seçenekler	Yanıt artık yüzey kontrollerine (ör. Gmail, Shorts) dayalı dönüşüm oranı önerilerini destekleyen yüzeyleri içeriyor. Yalnızca Talep Yaratma kampanyalarında desteklenir.
LanguageDistribution	Yeni alan / tür	YouTube kanalı içeriğinde dil dağılımı ayrıntılarını sağlamak için YouTubeChannelInsights bölümüne eklendi.
BenchmarksService	Yeni hizmet	YouTube reklam verilerini sektör karşılaştırmalarıyla karşılaştırır.
AudienceInsightsService.GenerateAudienceDefinition	Yeni yöntem	Üretken yapay zekayı kullanarak hedef kitlenin serbest metin açıklamasını eşleşen kitle özelliklerine çevirir.
YouTubeChannelInsights.relevance_score	Yeni alan	Bir içerik üreticinin bir konuyla ne kadar alakalı olduğunu görüntüleme sayısına göre ağırlıklandırarak değerlendirir.
TrendInsightMetrics.trend_change_percent	Yeni alan	Bir trendin değerinde karşılaştırma dönemi boyunca gerçekleşen yüzde değişimini temsil eder.
Öneriler
GenerateRecommendationsRequest	Yeni alan	is_new_customer eklendi. CAMPAIGN_BUDGET önerileri için true olarak ayarlandığında yeni müşteriler için optimize edilmiş bir model kullanılır (yalnızca kampanyası olmayan müşteriler için önerilir).
Raporlar
AdGroupAdAssetView	Yeni özellik / metrik desteği	Artık RESPONSIVE_DISPLAY_AD için gösterim, performans ve dönüşüm metriklerini destekliyor.
ad_sub_network_type segmenti	Yeni segment	Bir reklam ağı içinde ayrıntılı performans dökümü sağlar. İlk olarak YouTube'daki Talep Yaratma kampanyalarında (yayın içi, feed içi, Shorts) kullanılabilir. ad_network_type ile birlikte seçilmelidir.
Maksimum Performans raporları	Yeni özellik	Maksimum Performans kampanyaları için reklam ağı türü dökümü etkinleştirildi.
UserLocationView GeographicView	Yeni segment desteği	Dönüşüm tarihine göre segmentlere ayrılmış destek metrikleri: 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 ve cross_device_conversions_value_by_conversion_date.
Dikey reklam segmentleri	Yeni segmentler	Şu segmentler eklendi: 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 ve vertical_ads_vertical.
PerStoreView MatchedLocationInterestView	Yeni raporlama kaynakları	Mağaza konumu ayrıntılarını sorgulamak için PerStoreView, ilgilenilen coğrafi konumlara göre performans metrikleri sağlamak için MatchedLocationInterestView (AI Max kampanyaları için) eklendi.
Alışveriş
ShoppingPerformanceView	Yeni metrik desteği	Artık dönüşüm tarihine göre segmentlere ayrılmış şu metrikleri destekliyor: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date ve value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date.
ShoppingPerformanceView	Yeni metrik desteği	search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share ve search_rank_lost_absolute_top_impression_share için destek eklendi.
ShoppingProduct.product_image_uri	Yeni alan	ShoppingProduct ekranına eklendi.
Dikey reklamlar
AdGroup.vertical_ads_format_setting	Yeni alan	Seyahat feed'leri kullanılarak Arama Ağı kampanyalarında hangi reklam biçimlerinin yayınlanabileceği kontrol edilebilir.
AdGroupCriterion SharedCriterion	Yeni alanlar / ölçütler	Seyahat feed'leri içeren Arama Ağı kampanyalarında öğe gruplarının hedeflenmesine izin vermek için AdGroupCriterion kampanyasına vertical_ads_item_group_rule_list ölçüt türü ve SharedCriterion kampanyasına vertical_ads_item_group_rule ölçüt türü eklendi.
Dikey reklamlar veri feed'i entegrasyonu	Yeni özellik	Artık tesis tanıtımı ve rezervasyon bağlantısı seyahat reklamlarını metin reklamlarla birlikte göstermek için dikey reklam veri feed'ini Maksimum Yapay Zeka kullanan bir Arama Ağı kampanyasına bağlayabilirsiniz. vertical_ads_format_setting ile biçimleri kontrol edin ve vertical_ads_item_group_rule kullanarak kuralları tanımlayın. Raporları AdFormatType ve dikey reklam veri feed'i boyutlarına göre segmentlere ayırma.
Videolar
AdVideoAssetInfo.ad_video_asset_feature_control	Yeni alan	Video reklam öğeleri için özellik kontrolü seçenekleri eklendi.
CampaignCriterionError	Yeni enum değeri / hata	INVALID_VIDEO_LINEUP_ID hata kodu eklendi.
YouTube işitilebilirlik metrikleri	Yeni metrikler	YouTube'daki işitsel reklamlar için işitilebilirlik metrikleri eklendi. Bu metrikler, bir reklamın işitilebilir olup olmadığını ve işitilebilirliğin kaç gösterimde ölçülebildiğini raporlar.

Arşivlenmiş sürüm notları

Arşivlenmiş sürüm notları için Desteği sonlandırılan sürümler başlıklı makaleye bakın.