Sürüm notları

Mevcut ve planlanan özelliklerin kullanımdan kaldırılmasıyla ilgili güncel bir liste için Özelliklerin kullanımdan kaldırılması başlıklı makaleyi inceleyin.

v25 ana ve alt sürümleri

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

25.2 sürümü (17.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ç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 tarama 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): Taslak kampanyayı oluşturmadan dönüşümü doğrulamak ve GeneratePMaxDraftCampaignResponse.validated_info bölümünde doğrulama uyarıları veya dönüşüm sorunları almak için GeneratePMaxDraftCampaignRequest.validate_only seçeneğini true olarak ayarlayın. (gbp_enabled ve image_enabled değerlerini ayarlamadan bırakın veya false olarak ayarlayın. 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, 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, bu dönüşüm işlemlerini alıp 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ünde bir AssetSet içindeki 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) birlikte 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 gösterilir. CustomerMetrics.percentile_metrics, yalnızca GenerateBenchmarksMetricsRequest içinde aşağıdaki koşulların her ikisi de karşılandığında doldurulur: PERCENTILE_DATA, supplemental_data içinde 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ş 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	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	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 amacıyla 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ı boyutu segmentleri	Yeni segmentler	Segments'e aşağıdaki Oteller 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 biçimlendirilmiş. Segments.start_day_of_week: Rezervasyonun haftanın başlangıç 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	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 vergiler ve ücretler dahil olmak üzere tıklama ağırlıklı ortalama günlük ücret (mikro cinsinden). Metrics.vertical_ads_potential_impressions: Sorgu bağlamında kullanılabilen, görüntüleme sınırı uygulanmış toplam uygun gösterim sayısı. Metrics.vertical_ads_price_difference_percentage: Reklamverenin sunduğu fiyatı aynı mülk için en düşük rakip fiyatla karşılaştıran yüzde farkı.
Dikey reklam segmentleri	Yeni segmentler	Otel ve seyahat sektöründeki reklamlarla ilgili Segments raporlarına aşağıdaki segmentler eklendi (campaign, ad_group ve customer ile seçilebilir): Segments.vertical_ads_price_tier: Reklamverenin fiyat katmanı (HotelPriceBucket) ile açık artırmadaki rakiplerin fiyat katmanı karşılaştırması. Segments.vertical_ads_rate_rule_id: Reklamverenin ücret kuralıyla ilişkili ücret kuralı kimliği. Segments.vertical_ads_rate_type: Otel rezervasyonunun fiyat 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 küçük 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	Yaklaşan otomatik taşıma işlemini AI Max'e kadar 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ış çalışması 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 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'ı eklendi.
LiftMeasurementFlight	Yeni kaynak	Ölçülen yayın başlangıç ve bitiş tarihleri (start_date ve end_date) dahil olmak üzere artış ölçümü yapılandırması için yayın ayrıntılarını temsil eden yeni bir salt okunur kaynak.
Genel
SmartCampaignError	Yeni enum değerleri	Maksimum Performans oluşturma kısıtlamaları için yeni 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 karşı istekte bulunmaya çalıştığında döndürülür.
Planlama
Marka duyarlılığı analizleri	Yeni özellikler	ContentCreatorInsightsService'de marka duyarlılığı analizleri için destek eklendi: BrandSentimentInsight, SentimentInsightDistribution ve SentimentInsightSummary mesajları eklendi. Sentiment enum'ı eklendi. ContentCreatorInsightsSupplementalData enum'ına BRAND_SENTIMENT_DATA değeri eklendi. InsightsKnowledgeGraphEntityCapabilities enum'ına BRAND değeri eklendi.
BenchmarksService geliştirmeleri	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 aşağıdaki ek metrikler de desteklenir: BenchmarksService.GenerateBenchmarksMetrics ve category_filter kullanılarak bir veya daha fazla Ürün ve Hizmet Kategorisi'nde reklam yayınlayan tüm reklamverenlere kıyaslama 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 planlamada ebeveynlik durumu hedefleme desteği eklendi. ReachPlanService.GenerateReachForecast hizmeti için Targeting'e parental_statuses, ReachPlanService.ListPlannableProducts hizmeti için PlannableTargeting'e parental_statuses yeni alanı eklendi.
Öneriler
Recommendation.campaign_specific_app_goal_recommendation	Yeni öneri	Kampanyaya özel 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 gösterir. 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	İstatistiklerin kullanıcı bağlılık üyeliği programı durumuna göre segmentlere ayrılması ve dönüşüm değeri kuralları için bağlılık üyeliği birincil boyutu desteği eklendi: Dönüşüm gerçekleştiren kullanıcının bağlılık programı katmanına göre rapor metriklerini segmentlere ayırmayı 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'a 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 önemli değişiklikler, ana sürüm olan Google Ads API v25'e eklendi.

Yol gösterici bilgiler 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ının yanı sıra sırasıyla value_adjustment ve high_lifetime_value_adjustment oneof'larının bir parçası	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ı, ilgili hizmetleri CustomerLifecycleGoalService ve CampaignLifecycleGoalService ve 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 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'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çindeki isteğe bağlı allowed_domain alanı	Bir reklamcılık iş ortağı için CreateProductLinkInvitation numarası arandığında 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 uygulamasındaki 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 içinde Metrics türünde customer_metrics alanı	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 (bozucu olmayan)

Özellikler ve güncellemeler	Tür	Açıklama
Reklamlar
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS	Yeni enum değeri / davranışı	DemandGenMultiAssetAds tarihine kadar geçerlidir. Etkinleştirilirse giriş olarak animasyonsuz resimleri kullanarak animasyonlu resimler oluşturur. Bu API sürümünden itibaren yeni DemandGenMultiAssetAds 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 programı üyesi tutma hedefi	Yeni özellikler / ayarlar	Reklamverenlerin kampanyaları bağlılık programı üyelerini elde tutacak şekilde optimize etmesine olanak tanıyan bağlılık programı üyelerini 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 ve elde tutma hedefi ayarlarını yapılandırmak için Goal.loyalty_retention_goal_settings simgesi 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ğı, campaign_new_customer_acquisition_settings alanı kullanılarak yeni müşteri edinme için kampanyaya özel geçersiz kılmaları destekleyecek şekilde genişletildi. Desteklenen hedef alt türlerini tanımlamak için yeni CustomerLifecycleOptimizationGoalSubType enum'ı eklendi. NEW_CUSTOMER_ACQUISITION, GoalType numaralandırmasına eklendi. GoalError bölümüne yeni doğrulama hatası nedenleri eklendi: NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS CampaignGoalConfigError'a 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şkilendirmesi	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ıyan 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 teklifi kullanma hataları için yeni 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ıdır ve teşviki kullanamaz) USER_SUSPENDED (müşteri hesabı askıya alındı) MAX_PENDING_INCENTIVES (Müşteri, bekleyen teşvikler için izin verilen üst sınıra ulaşmıştır) ACCOUNT_HAD_RECENT_SPEND (hesapta son zamanlarda harcama yapıldı ve hesap uygun değil) MAX_INCENTIVES_REDEEMED_FROM_OFFER (Müşteri, bu tekliften maksimum sayıda teşvik kullanmış) MISMATCHING_BILLING_COUNTRY_CODE (istekte belirtilen fatura adresinin bulunduğu ülke kodu, müşterinin hesap ülkesiyle eşleşmiyor)
Planlama
Trend olan analizlerdeki 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 atlanamayan yayın içi 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ında kullanıcı etkileşimini (yorumlar, beğeniler ve paylaşımlar) izlemesine yardımcı olmak için 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 önemli değişiklikleri içerir.

24.2 sürümü (24.06.2026)

Google Ads API v24.2'ye aşağıdaki yeni özellikler ve güncellemeler eklendi. v24.2 gibi küçük 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 etkileşim panelinde gösterilecek açılış sayfası metin bilgilerini oluşturur (bu API sürümünden itibaren varsayılan olarak etkinleştirilir).
Öğ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 Hizmet Maksimum Performans kampanyalarının belirlenmesini destekler.
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ının yerel hizmet reklamını tıkladığında ve reklamvereni aradığında, reklamverene mesaj gönderdiğinde veya reklamverenden rezervasyon yaptırdığı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 denemelerinde kullanılır.
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çermelidir. Bu özellik, v23 ve v22 sürümlerine geri taşındı. 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. 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 bulunursanız şu 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 ayarlanamaz). Bu alanlar, v25'ten itibaren tamamen değiştirilebilir hale gelecek. Sisteminizi v25 kullanıma sunulduğunda tam yazma özelliklerine hazır hale getirmek 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 yoruma 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 geri taşındı.
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 sorunsuz bir şekilde geri dönüyor.
Planlama
GenerateCreatorInsightsRequest.search_topics	Yeni alan	ContentCreatorInsightsService.GenerateCreatorInsights hizmetine eklendi. Bu seçenek, country_locations içinde belirtilen ülkede bir konu hakkında konuşan içerik üreticileri arar (yalnızca bir ülke için 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 içindeki 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. Konum verilerini paylaşmayı kabul eden ve seçilen ülkede görüntülenen veya bu ülkede yaşayan yerel içerik üreticileri gösterir.
GenerateTrendingInsightsRequest.sub_country_locations	Yeni alan	ContentCreatorInsightsService.GenerateTrendingInsights'a eklendi. Ülke konumu ve alt ülke konumları kullanılarak trend analizleri aranmasına olanak tanır.
Raporlar
PerformanceMaxPlacementView	Segment 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 dil hedeflenmeye ç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 öğ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: AI Max'in Google AI 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 nasıl performans gösterdiğini 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 deneysel 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ı için ayarlar.
Genel
CustomerUserAccess.passkey_enabled	Yeni alan	Kullanıcının geçiş anahtarının etkin olup olmadığını 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	VerticalAdsItemGroupRuleInfo'da SharedCriterion kaynağı için desteklenen filtreleme.
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 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 demografik hedeflemeler 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)

Aşağıdaki yeni özellikler, güncellemeler ve önemli değişiklikler, ana sürüm olan Google Ads API v24'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
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'de 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ı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	Türlenmiş istemci kitaplığı 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'daki is_brand_connect_creator alanı	Yok	Kaldırma	Bunun yerine, içerik üreticinin partnership_opportunities içinde CREATOR_PARTNERSHIPS özelliğini kullanıp kullanmadığı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'da anahtar kelime planı / tahmin alanlarının desteği sonlandırıldı	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	Segment, AdGroupAsset, CampaignAsset ve CustomerAsset görünümlerinden 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ş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 bilgisi 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 (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 bölümüne yeni GA4/Firebase dönüşüm işlemi türü numaralandırmaları 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 bölümündeki ProductCoreAttributes'ye 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'daki 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 olarak filtreleme özelliği eklendi: RETAIL_FILTER_BUNDLE ve RETAIL_FILTER ölçüt türleri eklendi. RETAIL_FILTER paylaşılan küme türü eklendi. AdGroupCriterion öğesine retail_filter_bundle alanı eklendi. SharedCriterion öğesine retail_filter alanı eklendi. RETAIL, ListingGroupFilterListingSource listesine eklendi. AssetGroupListingGroupFilter raporuna RetailFilter boyutu eklendi. CriterionError ve AssetGroupListingGroupFilterError'a 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 önemli değişiklikleri içerir.

23.3 sürümü (24.06.2026)

Google Ads API v23.3'e aşağıdaki yeni özellikler ve güncellemeler eklendi. v23.3 gibi küçük 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 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 bulunursanız şu 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 ayarlanamaz). Bu alanlar, v25'ten itibaren tamamen değiştirilebilir hale gelecek. Sisteminizi v25 kullanıma sunulduğunda tam yazma özelliklerine hazır hale getirmek 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 yoruma 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 v23.2'ye 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ındaki en iyi performans gösteren öğe kombinasyonları hakkında analizler sağlayan salt okunur kaynak.
CustomerAsset	Yeni özellik	field_type değeri 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	youtube_select_lineups uygulamasının yerini alacak olan ReachPlanService.ListPlannableProducts uygulamasına eklendi. Her iki alan da şu anda 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 kampanyaları 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. ShareablePreviewError albümüne UNSUPPORTED_AD_TYPE ve TOO_MANY_RESOURCES_IN_REQUEST 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 alanda 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 stratejisine sahip kampanyalar için temel 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 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 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 ile TrendInsights arasındaki 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 verileri feed'lerini desteklemek için VERTICAL_ADS_DATA_FEED eklendi.
YouTubeVideoUpload
YouTubeVideoUpload	Yeni hizmet / kaynak	YouTube'da video yükleme ve yönetme işlemlerini desteklemek için YouTubeVideoUpload hizmeti, yükleme durumunu ve meta verileri getirme işlemlerini 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)

Google Ads API v23'e (ana sürüm) aşağıdaki yeni özellikler, güncellemeler ve önemli 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
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 görüşmesi reklamları hakkında başlıklı Yardım Merkezi makalesine göz atın.
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üntüleme	Yeni alanlar	Şu metrikler eklendi: metrics.engagements, metrics.engagement_rate ve metrics.average_cpe.
asset_group_asset görüntüleme	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önlendirme 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 sunulan öğ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 müşteri mesajı öğeleri: Facebook Messenger ve Zalo sağlayıcı olarak desteklenmeye başladı. BusinessMessageProvider albümüne FACEBOOK_MESSENGER ve ZALO 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	ListInvoicesRequest içinde include_granular_level_invoice_details ayarlanarak artık Invoice içinde kampanya düzeyinde maliyet dökümü, ayrıntılı düzenleyici maliyetleri ve ayarlama bilgileri gibi daha ayrıntılı bilgiler döndürülebilir.
RegulatoryFeeType UnitOfMeasure	Yeni sıralamalar	Yasal ücretler ve ölçü birimleri için yardımcı numaralandırılmış değerler 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ı izleyip 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 Ödülünüzü Seçin (CYO) teşvikleri desteği eklendi: Kullanıcı için kullanılabilir kişiselleştirilmiş teşvikleri almak üzere FetchIncentive yöntemi eklendi. Seçilen 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 bölümlerine yeni hata kodları eklendi. Hataların daha ayrıntılı bir şekilde programatik olarak işlenmesini kolaylaştırmak için gelecekteki sürümlerde IncentivesService'ya 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öntemlerinde 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ğıtımıyla ilgili ayrıntıları 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	Hedef kitlenin serbest metin açıklamasını, üretken yapay zekayı kullanarak 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. true için CAMPAIGN_BUDGET önerileri 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 segment	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 etkinleştirilen reklam ağı türü dökümü.
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'leri kullanılarak 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 hedefleme öğe gruplarına izin vermek için vertical_ads_item_group_rule_list ölçüt türü AdGroupCriterion'ye, vertical_ads_item_group_rule ise SharedCriterion'e 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 verileri feed'ini AI Max'in 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 reklamlar veri feed'i boyutlarına göre segmentlere ayırın.
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'da duyulabilirlik metrikleri	Yeni metrikler	YouTube'daki işitsel reklamlar için duyulabilirlik metrikleri eklendi. Bu metrikler, bir reklamın duyulabilir olup olmadığını ve kaç gösterimde duyulabilirliğin ölçülebileceğini bildirir.

v22 ana ve alt sürümleri

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

22.2 sürümü (24.06.2026)

Google Ads API v22.2'ye aşağıdaki yeni özellikler ve güncellemeler eklendi. v22.2 gibi küçük 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. 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 bulunursanız şu 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 ayarlanamaz). Bu alanlar, v25'ten itibaren tamamen değiştirilebilir hale gelecek. Sisteminizi v25 kullanıma sunulduğunda tam yazma özelliklerine hazır hale getirmek 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 yoruma 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.

22.1 sürümü (25.02.2026)

Google Ads API v22.1'e aşağıdaki yeni özellik eklendi. v22.1 gibi alt sürümlerde zarar veren değişiklikler bulunmaz.

Özellikler ve güncellemeler	Tür	Açıklama
Hesap yönetimi
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.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.

v22 (15.10.2025)

Aşağıdaki yeni özellikler, güncellemeler ve önemli değişiklikler, ana sürüm olan Google Ads API v22'ye 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
Talep Yaratma
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros	minimum_budget_amount_micros	Yeniden adlandırma / yazım hatası düzeltme	Düzeltilmiş alan adını kullanmak için referansları yeniden adlandırın.
Genel
AddBatchJobOperations içinde işlem sınırı yok	İstek başına 10.000 işlem sınırı	Davranış değişikliği	Hiçbir AddBatchJobOperations isteğinin 10.000'den fazla işlem içermediğinden emin olun.
ListBatchJobResultsRequest'da sayfa boyutu 1.000 ile sınırlandırıldı.	İadeler INVALID_PAGE_SIZE hatası	Davranış değişikliği	Daha büyük bir sayfa boyutu istemek artık hataya neden olacağından ListBatchJobResultsRequest.page_size değerinin 1.000 veya daha az olduğundan emin olun.
Maksimum Performans
Öğe performansı etiketleri	Yok	Kaldırma	Öğe performans etiketleri desteği ve ilişkili performans etiketi numaralandırması, Maksimum Performans kampanyaları için kaldırıldı. Entegrasyonları buna göre güncelleyin.
Campaign.url_expansion_opt_out	AssetAutomationSetting içinde FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION şikayeti	Kaldırma / değiştirme	Nihai URL genişletmesi metin öğesi otomasyonu ayarını kullanın. Kampanya düzeyinde URL genişletme devre dışı bırakma alanı kaldırıldı.
Planlama
views	trueview_views	Kaldırma / değiştirme	views ile ilgili referansları ReachPlanService içindeki yeni trueview_views alanı ile değiştirin.
Videolar
average_cpv video_view_rate video_views video_view_rate_in_feed video_view_rate_in_stream video_view_rate_shorts	trueview_average_cpv video_trueview_view_rate video_trueview_views video_trueview_view_rate_in_feed video_trueview_view_rate_in_stream video_trueview_view_rate_shorts	Yeniden adlandırmalar	TrueView video görüntülemelerini temsil eden yeni metrik adlarını kullanmak için sorgu dizelerini ve entegrasyonları güncelleyin.

Özellikler ve güncellemeler (bozucu olmayan)

Özellikler ve güncellemeler	Tür	Açıklama
Öğeler
AssetFieldType.LANDING_PAGE_PREVIEW	Yeni enum değeri	Yeni bir resim öğesi alanı türü olarak eklenir.
AssetGenerationService	Yeni hizmet (Beta)	Üretken yapay zeka kullanarak metin ve resim öğeleri oluşturmaya olanak tanır: GenerateText: Nihai URL, istemler, anahtar kelimeler vb. temelinde metin oluşturur. GenerateImages: Nihai URL'ye, istemlere veya ürün resimlerini yeniden bağlama işlemine göre resimler oluşturur. Hatalar, AssetGenerationError kodlarıyla birlikte döndürülür. Başlangıçta yalnızca sınırlı sayıda kapalı beta katılımcısı tarafından kullanılabilir.
Kampanyalar
AppCampaignBiddingStrategyGoalType	Yeni enum değerleri	Hedef belirtmeden optimizasyon yapmak için yüklemelere yönelik uygulama kampanyalarına (ACI) yeni hedefler eklendi: OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: Standart dönüşümleri artırma stratejisiyle birlikte kullanılır. OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: Standart dönüşüm değerini artırma stratejisiyle birlikte kullanılır.
BiddingStrategyType	Yeni özellik	Sabit görünürlük payı teklif stratejisi türü için destek eklendi.
Campaign.feed_types	Yeni alan	Bir kampanyaya eklenen feed türlerini gösterir. Maksimum Performans kampanyalarında bu, perakende için MERCHANT_CENTER_FEED gibi bir iş kolunu gösterebilir.
Paylaşılan küme hedefleme	Yeni özellik	Paylaşılan negatif anahtar kelime kümelerinin çok kanallı (uygulama kampanyaları için) ve yerel kampanyalara eklenmesine izin verildi.
Talep Yaratma
Hedef TBM teklifi	Yeni özellik	Hedef TBM'de tıklamaları artırma teklif stratejisi eklendi: Campaign.target_cpc kullanarak kampanya düzeyinde hedef TBM belirleyin ve AdGroup.target_cpc_micros kullanarak reklam grubu düzeyinde geçersiz kılın.
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES	Yeni enum değeri	DemandGenMultiAssetAdInfo için etkinleştirilirse farklı en-boy oranlarına sahip yeni resim öğeleri oluşturmak üzere tasarım öğeleri eklenir ve metin öğeleri resim öğelerine yerleştirilir (varsayılan olarak etkindir).
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS	Yeni enum değeri	DemandGenMultiAssetAdInfo için etkinleştirilirse resim ve metin gibi diğer öğeleri kullanarak videolar oluşturur. Bu videolar daha sonra yeni DemandGenVideoResponsiveAdInfo örnekleri oluşturmak için kullanılabilir (varsayılan olarak etkindir).
Genel
ListBatchJobResultsRequest sayfa boyutu geri dönüşü	Davranış değişikliği	page_size ayarlanmamışsa veya 0 ise artık varsayılan olarak maksimum 1.000 (daha önce INVALID_PAGE_SIZE döndürülüyordu) olur.
QuotaError	Yeni enum değeri / hata	Ödeme profili etkinleştirme sıklığı sınırı aşıldığında gösterilecek PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED simgesi eklendi.
Maksimum Performans
Öğe otomasyonu ayarları	Yeni enum değerleri	Yeni Maksimum Performans öğe otomasyonu seçenekleri eklendi: GENERATE_IMAGE_ENHANCEMENT: Gelişmiş resimlerin (otomatik kırpma) otomatik olarak oluşturulmasını sağlar. Varsayılan olarak etkindir. GENERATE_IMAGE_EXTRACTION: Nihai URL'lerden alınan resimler. Varsayılan olarak hesap dinamik resim uzantısı ayarı kullanılır.
Maksimum Performans raporlama segmentleri	Yeni segmentler	Maksimum Performans kampanyalarına özel yeni segmentler eklendi: ad_using_product_data: Bir reklamın Google Merchant Center ürün verilerini kullanıp kullanmadığını gösterir. ad_using_video: Bir reklamın video öğesi kullanıp kullanmadığını gösterir.
Planlama
CRM iş ortağı veri listeleri	Yeni özellik / enum değeri	İş ortağı kitle doğrulama hata kodlarıyla (ör. hizmet şartlarının kabulü, bağlantı eksik vb.) birlikte CRM veri kaynaklarına THIRD_PARTY_PARTNER_DATA eklendi.
Canlı yayın içerik üretici metrikleri	Yeni alan	İçerik üretici analizleri tarafından döndürülen YouTubeMetrics.is_active_live_stream_creator simgesi eklendi. Bu simge, içerik üreticinin son 90 gün içinde canlı yayın yapıp yapmadığını gösterir.
Planlanabilir CRM kaynak meta verileri	Yeni mesaj	CRM veri kaynağı türlerini göstermek için ReachPlanService.ListPlannableUserLists tarafından döndürülen PlannableUserList içine PlannableUserListMetadata eklendi.
TrendAnaliz'de ilgili videolar ve içerik üreticiler için destek	Yeni alanlar	TrendInsight üzerinde related_videos ve related_creators özelliklerinin yanı sıra video_properties ve publish_date'deki saat özelliklerine destek eklendi.
InsightsFinder iyileştirmeleri	Yeni özellik	GenerateInsightsFinderReport artık parental_status, income_ranges ve daha karmaşık VE/VEYA hedefleme kombinasyonlarını destekliyor.
Raporlar
Yeni tıklama türleri	Yeni enum değerleri	CLICK_TO_MESSAGE_THIRD_PARTY_CLICK ve CLICK_TO_MESSAGE_LANDING_PAGE_CLICK eklendi.
AssetGroupAsset segmentasyonu	Yeni segment desteği	AssetGroupAsset artık device, conversion_action, conversion_action_name ve conversion_action_category'ye göre segmentlere ayrılabilir.
AdGroupAdAssetView'daki RSA'lar	Yeni özellik / metrik desteği	AdGroupAdAssetView artık RESPONSIVE_SEARCH_AD için performans ve dönüşüm metriklerini tam olarak destekliyor (daha önce yalnızca gösterimler döndürülüyordu).
Keşif sorgusu kümesi metrik segmentasyonları	Yeni segment desteği	clicks_unique_query_clusters, conversions_unique_query_clusters ve impressions_unique_query_clusters metrikleri artık tarih alanlarına göre segmentlenebilir.
TargetingExpansionView	Yeni raporlama kaynağı	Arama Ağı Kampanyaları İçin AI Max'te anahtar kelimesiz genişletme gibi manuel hedeflemenin üzerindeki genişletmeler için rapor metriklerine TargetingExpansionView eklendi.
Alışveriş
Alışveriş kapsamı düzeltmesi	Hata düzeltmesi	ShoppingProduct kaynağındaki metriklerin kampanya ve reklam grubu kapsamı düzeltildi.
Birleştirilmiş hedefler
Elde tutma hedefleri	Yeni özellik	Mevcut müşterilerle yeniden etkileşim kurmaya yönelik optimizasyon yapmak için müşteri elde tutma hedefleri desteği eklendi (ör. target_option ile TARGET_SPECIFIC veya TARGET_ALL kullanma).
Videolar
Video izlenme süresi metrikleri	Yeni alanlar	İzlenme süresi metrikleri eklendi: video_watch_time_duration_millis (toplam süre) ve average_video_watch_time_duration_millis (gösterim başına ortalama süre).

Arşivlenmiş sürüm notları

Arşivlenmiş sürüm notları için Desteklenmeyen sürümler'e bakın.