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ı: 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: 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:
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
Ö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:
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:
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:
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üşü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:

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:
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):
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):
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):

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:
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:
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:
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:
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:
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ı: 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.
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:
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: 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:
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:
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: 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: 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 Çok Taraflı Yetkilendirme (MPA) incelemeleri için destek 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ı: 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: 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:
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: 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 Çok taraflı onay (MPA) incelemeleri için destek 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:
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:

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.