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 aşağıdaki yeni özellikleri, güncellemeleri ve zarar veren değişiklikleri içerir.

26 sürümü (14.10.2026)

Google Ads API v26'da (ana sürüm) aşağıdaki yeni özellikler, güncellemeler ve zarar veren değişiklikler eklendi.

Yönergeler 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'deki sektörden bağımsız ölçüt alanları: UserSetDatesInfo türünde 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ünde start_date_range	Yeniden adlandırma / kaldırma	Referansları, otellerin dışındaki seyahat sektörlerinde (ör. Aktivite Önerileri) hedeflemeyi destekleyen sektörden bağımsız ölçüt alanlarını kullanacak şekilde 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 içinde 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'da sektörden bağımsız 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 müşteri 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	OUTPUT_ONLY olan PmaxCampaignSettings.local_services_enabled, IMMUTABLE olarak güncellendi. Böylece harici API istemcileri, yeni Yerel Hizmetler Maksimum Performans kampanyaları oluştururken local_services_enabled = true belirtebilecek. Ayrıca, Yerel Hizmet Maksimum Performans kampanyasına bağlı Google İşletme Profili listeleme kimliğini (Yerel Hizmet Maksimum Performans kampanyası oluşturma sırasında ZORUNLU olarak işaretlenir) göstermek için LocalServicesPmaxCampaignSettings.listing_id eklendi ve CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID hata kodu eklendi.
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ğrulama	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 hizmetine demand_gen_info.minimum_budget_per_day_micros alanı eklendi. Bu alan, ilgili para biriminde 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'ın Alışveriş kampanyalarında daha fazla desteklenmesi.
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 kampanyası ö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 olmayan 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'daki değişikliklerle eşleşecek ş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. Kampanya içindeki herhangi bir kampanya düzeyinde ölçüt için (veya yükseltilmiş hedeflemeye sahip DEMAND_GEN kampanyalarındaki herhangi bir etkin reklam grubu düzeyinde ölçüt için) bu alan 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	Yeni EnhancedConversionsConfig enum'ı kullanılarak temsil edilen, 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.
ConversionActionCategory.MESSAGE_LEAD	Yeni enum değeri	Bir reklamverenin teklifine ilgi gösterildiğini belirten mesaj veya sohbet etkileşimlerini desteklemek için ConversionActionCategory'e eklendi.
ConversionAttributionEventType.CLICK	Yeni enum değeri	Daha önce UNKNOWN enum değerinde yer alan ve bir reklam tıklamasıyla ilişkilendirilen dönüşümleri temsil etmek için ConversionAttributionEventType'ye eklendi.
Genel
Yerel Hizmetler hizmet talebi güncellemeleri	Yeni alan ve enum değeri	Potansiyel müşteriyi ilişkili kampanyasına bağlamak için LocalServicesLead.campaign alanı LocalServicesLead kaynağına eklendi. Yerel Hizmetler için kupon hizmet talebi türlerini desteklemek üzere LocalServicesLeadType'a 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 (Campaign.lift_measurement_config kullanan kampanyalara bağlı) 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 (relative_search_lift, normalized_incremental_searches, search_lift_cost_micros ve search_lift_impressions gibi) eklendi. 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 üzerinde URL seçenekleri için destek eklendi. Bu sayede reklamverenler, öğe grubu düzeyinde izleme şablonları, özel parametreler ve nihai URL son ekleri belirleyebilir: 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çindeki URL özel parametre etiketlerini değiştirmek için 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	Campaign.AssetAutomationSetting hizmetine AssetAutomationType.AUTOMATED_VIDEO_CRAWL ile birlikte AutomatedVideoCrawlSetting eklendi. Bu sayede, Maksimum Performans kampanyası için otomatik video tarama ayarlarını belirtebilirsiniz. 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 (Akıllı kampanyaları Maksimum Performans kampanyalarına dönüştürme başlıklı makaleye bakın): 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 değerlerini ayarlamadan veya false olarak bırakın. Bunları true olarak ayarlamak 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, oluşturulan varlıkların (pmax_campaign, campaign_budget, asset_group ve assets) kaynak adlarını validated_info ile birlikte döndürür.
Dönüşümler
Firebase reklam gösterimleri	Yeni dönüşüm işlemi türleri ve kategorisi	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. Uygulama içi reklam para kazanma gelirini izlemek için ConversionActionCategory'da IN_APP_AD_REVENUE kategorisi de kullanıma sunuldu.
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 yüzdelik dilim biçiminde gösteren metrikler sağlamak 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 temsil edilir. 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 (bu da category_filter değerinin belirtilmesini gerektirir). 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ş kombinasyonu için metrik bulunamadığını belirten özel bir BenchmarksError.NO_METRICS_FOUND hata mesajı eklendi.
İçerik üreticilere yönelik analizler için YouTube kanalı herkese açık kullanıcı adları	Yeni özellik	YouTubeChannels.youtube_channel_handles kullanılarak YouTube kanalı herkese açık kullanıcı adlarına göre arama yapmayı desteklemek için ContentCreatorInsightsService.GenerateCreatorInsights güncellendi (Geçerli kanal herkese açık kullanıcı 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 analizleri içerir.
Öneriler
EBM ve ROAS teklifi önerileri	Yeni öneriler	Teklifler Arama Ağı kampanyalarının açık artırmalara girmesi için çok düşük olduğunda hedef EBM'yi yükseltmeyi veya hedef ROAS'ı düşürmeyi desteklemek için 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: RaiseTargetCpaPerformanceBidTooLowRecommendation, recommended_target_multiplier (1.0'dan büyük bir faktör) ve current_average_target_cpa_micros sağlar. target_cpa_multiplier ile birlikte 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 erken rezervasyon dönemi (gün cinsinden). 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 olmalıdır. Segments.start_day_of_week: Rezervasyonun başladığı gün (DayOfWeek). Segments.user_set_dates: Kullanıcı tarafından belirtilen tarihler seçilip seçilmediğini gösterir (HotelDateSelectionType).
Dikey reklam metrikleri	Yeni metrikler	Metrics için otel ve seyahat sektörü reklam raporlamasına aşağıdaki metrikler eklendi (campaign, ad_group ve customer ile seçilebilir): Metrics.vertical_ads_average_booking_value_micros: Otel rezervasyonları için toplam konaklama süresi boyunca vergiler ve ücretler dahil olmak üzere mikro cinsinden tıklama ağırlıklı ortalama günlük ücret. 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: Reklamverenin fiyat katmanı (HotelPriceBucket), açık artırmadaki rakiplerle karşılaştırılır. 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 25.1 sürümüne 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 ve yeni boyut kaynaklarıyla Brand Lift analizini desteklemek için yeni segmentler ve metrikler eklendi. Şu enum'lar 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ı metrikleri 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'ı 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'ına 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 için destek 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. Bu önerideki mevcut hedefleri temsil etmek için yeni EffectiveAutomaticGoal kaynağı 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 ü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 programı ü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)

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

Yönergeler 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 bunlara yapılan referansları güncelleyin.
Eski CustomerLifecycleGoal ve CampaignLifecycleGoal kaynakları, bunlara karşılık gelen CustomerLifecycleGoalService ve CampaignLifecycleGoalService hizmetleri ve eski ayarlar/enum'lar (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 istek 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 için 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 çağrısı yapılı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 içindeki 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ündeki 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 animasyonlu olmayan resimleri giriş olarak 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 artık v25, v24 ve v23'te 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. LOYALTY_RETENTION, GoalType enum'ına eklendi. Teklif ayarlamaları ve üyelik avantajlarını PLA biçiminde gösterme dahil olmak üzere kampanyaya özel bağlılık programı üyesi 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. CampaignGoalConfig kaynağını, campaign_new_customer_acquisition_settings alanı kullanılarak yeni müşteri edinme için kampanyaya özel geçersiz kılmaları destekleyecek şekilde genişletti. Desteklenen hedef alt türlerini tanımlamak için yeni CustomerLifecycleOptimizationGoalSubType enum eklendi. GoalType enum'una NEW_CUSTOMER_ACQUISITION eklendi. GoalError'e yeni doğrulama hatası nedenleri eklendi: NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS CampaignGoalConfigError'e 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: Müşteri düzeyinde entegrasyon iş ortaklarının yapılandırılmasına olanak tanıyan 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ınır.) MAX_PENDING_INCENTIVES (Müşteri, bekleyen teşvikler için izin verilen maksimum sayıya ulaştı.) ACCOUNT_HAD_RECENT_SPEND (Hesapta yakın zamanda harcama yapıldı ve hesap uygun değil.) MAX_INCENTIVES_REDEEMED_FROM_OFFER (Müşteri, bu tekliften maksimum sayıda teşvikten yararlanmıştır.) MISMATCHING_BILLING_COUNTRY_CODE (istekte sağlanan fatura adresinin bulunduğu ülke kodu, müşterinin hesap ülkesiyle eşleşmiyor)
Planlama
Trend analizlerinde YouTube kanalı ayrıntıları	Yeni alanlar	Trend analizleri aranırken ilgili videoların daha fazla YouTube kanalı ayrıntısı için destek eklendi. channel_id, channel_name ve channel_url adlı yeni alanlar YouTubeVideoAttributeMetadata'e 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 için (bu API sürümünden itibaren varsayılan olarak etkinleştirilir) etkileşim panelinde gösterilecek metin bilgilerini açılış sayfasından 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	Tüm konumları bir yerel hizmet Maksimum Performans kampanyasından kaldırmaya çalışırken döndürülür.
SmartCampaignErrorEnum.CREATION_FAILED	Yeni enum değeri / hata	Yeni akıllı kampanyalar oluşturulmaya çalışıldığında 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	Yapay zekayla üretilen/yapay içeriklere yönelik onaylar içerir. Bu onaylar advertiser_attestation (doğrudan reklamveren tarafından sağlanan beyanlar) ve system_attestation (sistem tarafından otomatik olarak algılanan veya sağlanan onaylar) olarak ikiye ayrılır. Bu özellik, 23 ve 22 sürümlerine de eklenmiştir. 25. sürüm için yaklaşan entegrasyon çalışmanı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 bulunursanız şu hatalardan biri döndürülür: "Değiştirilmeye çalışılan alan değiştirilemez" veya "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. 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. Bu özellik v23.3, v22.2 ve v21.2 sürümlerine de eklenmiştir.
IncentiveService.FetchIncentive	Davranış değişikliği	İstekle geçersiz bir e-posta adresi sağlandığında yöntem artık AuthenticationError.INVALID_EMAIL_ADDRESS hatası oluşturmak yerine varsayılan teşvik tekliflerini döndürmeye geri döner.
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 varlıkları belirtmek üzere InsightsKnowledgeGraphEntityCapabilities 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öntemlerine 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ğruysa Alışveriş reklamları için marka hariç tutmaları yoksayılır. Yalnızca Alışveriş kampanyalarında desteklenir.
Hedefleme
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE	Yeni enum değeri / hata	İzin verilmeyen bir dili hedeflemeye çalışırken 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 öğesini içerir.

24.1 sürümü (13.05.2026)

Google Ads API v24.1'e 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: Optimize Öğeler 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 döndürülür (yalnızca son 37 ay için kullanılabilir).
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.), işlem 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.

Yönergeler 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 sağlayın.
VideoResponsiveAdInfo'da 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 sağlayın. VideoResponsiveAdInfo artık değiştirilebilir.
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 eder. Bunun yerine Customer.video_brand_safety_suitability kullanın.
Dönüşümler
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	Yok	Kaldırma	Bağlılık programına kaydolan kullanıcılar kategorisi kaldırıldı. Bu öğeye yönelik kod referanslarını 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	Yazılan 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'daki kadroları kullanmaya geçin.
ContentCreatorInsightsService.GenerateCreatorInsights ve GenerateTrendingInsights içinde 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	İsteklerdeki kimliklerden herhangi biri doğrulanmazsa istekler başarısız olur ve hata verir.
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ştirilir. Doğrulama yakalama mantığını güncelleyin.

Özellikler ve güncellemeler (bozucu olmayan)

Özellikler ve güncellemeler	Tür	Açıklama
Reklamlar
VideoResponsiveAdInfo öğesinin değişkenliği	Davranış değişikliği	Duyarlı video reklam bilgi nesneleri artık değiştirilebilir.
Öğeler
AssetSet alt bölgesinde travel_feed_data	Yeni alan	Seyahat feed'i öğeleri ö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 etkinleştirilmesine olanak tanır (varsayılan false).
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
Olası satış yaratma 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 özdeş benzer kitle listesi oluşturulmaya ç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	Teklif verilemeyen metrikler (kampanyaların optimize edilmediği dönüşümleri gösteren metrikler) tüm eşleşen kaynaklara 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 ifadelerini dinamik olarak kullanarak 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. retail_filter alanı SharedCriterion öğesine 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 23.3 sürümüne 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 bulunursanız şu hatalardan biri döndürülür: "Değiştirilmeye çalışılan alan değiştirilemez" veya "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. v23.2 gibi küçük 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 özel 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ında 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'inin devre dışı bırakılmasına 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 uygulamalarına 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 değeri YOUTUBE_LIVE_PREVIEW olarak ayarlanarak YouTube canlı yayın önizlemeleri desteklenecek şekilde genişletildi. UNSUPPORTED_AD_TYPE ve TOO_MANY_RESOURCES_IN_REQUEST, ShareablePreviewError listesine eklendi. Bu özellik yalnızca bazı reklam türlerinde desteklenir.

v23.1 (25.02.2026)

Google Ads API v23.1'e aşağıdaki yeni özellikler ve güncellemeler eklendi. v23.1 gibi küçük 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	Hesap düzeyinde, AB'yi hedefleyen siyasi reklamlar içerip içermediğine dair beyan durumunu alır ve EuPoliticalAdvertisingStatus döndürür.
Kampanyalar
Campaign.text_guidelines	Yeni alan	Yapay zeka tarafından üretilen metin öğelerini programatik olarak kontrol etmek için Maksimum Performans ve Arama Ağı kampanyalarında kullanılabilen 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'ye yönelik siyasi reklamcılık içerip içermediğine dair beyanların eksik olduğu kampanyaların sorgulanmasını ve filtrelenmesini 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	Yalnızca demografi boyutlarındaki belirsiz 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 sonrasında 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	Talep Yaratma kampanyalarında dönüşümleri artırma hedefi için GOOGLE_DISPLAY_NETWORK, hedeflenebilir bir yüzey olarak eklendi.
GenerateTrendingInsights	Yeni alanlar	Konuya göre arama yaparken TrendInsightDataPoint bölümüne TrendInsights için geçmiş trend çizgisi bilgileri 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üklemeyi 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ı desteği 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	Aşağıdaki 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 parametresi HEADLINE ve DESCRIPTION olarak ayarlanmışken 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: Sağlayıcı olarak Facebook Messenger ve Zalo için destek 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 ListInvoicesRequest içinde include_granular_level_invoice_details ayarını yaparak Invoice'da kampanya düzeyinde maliyet dökümü, ayrıntılı yasal maliyetler ve düzenleme bilgileri gibi daha ayrıntılı bilgiler 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ı izleyen ve daha 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 Teşvikinizi Seçin (CYO) desteği eklendi: Kullanıcı için kullanılabilir kişiselleştirilmiş teşvikleri almak üzere 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'ye ek hata kodları ekleyeceğiz. Uygulamalarınızın bu yeni hata modlarını yönetebildiğinden emin olmak için bu yeni hata kodlarıyla ilgili duyuruları ve sürüm notlarını takip etmenizi öneririz.
Planlama
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST	Yeni enum değeri	GenerateAudienceCompositionInsights, GenerateSuggestedTargetingInsights, GenerateInsightsFinderReport ve GenerateCreatorInsights'de 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ğindeki 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şimi gösterir.
Ö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 metrikler destekleniyor: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, 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'lerini kullanan Arama Ağı kampanyalarında hangi reklam biçimlerinin yayınlanabileceğini kontrol etmenizi sağlar.
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 mülk tanıtımı ve rezervasyon bağlantısı seyahat reklamlarını metin reklamlarla birlikte göstermek için bir dikey reklam veri feed'ini Maksimum Yapay Zeka'nın kullanıldığı 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.