Sürüm notları

Mevcut ve planlanan özellik kullanımdan kaldırmalarının güncel listesi için Özellik kullanımdan kaldırmaları başlıklı makaleyi inceleyin.

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 (bu API sürümünden itibaren varsayılan olarak etkinleştirilir) için etkileşim panelinde gösterilecek açılış sayfası metin bilgilerini oluşturur.
Öğeler
AssetGroup.google_local_services_info Yeni alan Maksimum Performans kampanyalarında Yerel Hizmet Reklamları bilgilerini (kategori kimliği ve açıklama metinleri) desteklemek için eklendi.
AssetGroupSignal.local_services_id Yeni alan Maksimum Performans kampanyalarında Yerel Hizmet Reklamları hizmet kimliği sinyallerini desteklemek için eklendi.
AssetGroupSignal.vertical_ads_item_group_rule_list Yeni alan Maksimum Performans kampanyalarında ekli dikey feed'lerden öğe seçmek için dikey reklam öğe grubu kurallarını desteklemek üzere eklendi. Bu özellik yalnızca izin verilenler listesindeki hesaplarda kullanılabilir.
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN Yeni enum değeri / hata Tüm öğe grupları bir kampanyadan 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'ı ekler.
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 Hizmetler reklamını tıklayıp reklamvereni aradığında, reklamverene mesaj gönderdiğinde veya reklamverenden randevu aldığı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_input (doğrudan reklamveren tarafından sağlanan beyanlar) ve system_input (sistem tarafından otomatik olarak algılanan veya sağlanan onaylar) olmak üzere ikiye ayrılmış, yapay/yapay zekayla üretilen içeriklere ilişkin onaylar içermelidir.

Bu özellik, 23 ve 22 numaralı sürümlere 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ştirme 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. Sisteminizin v25 kullanıma sunulduğunda tam yazma özelliklerine hazır olması için dahili mantığınızı oluşturup test etmek üzere arayüzü hemen kullanmaya başlamanı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 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ı vermek 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 bölümünde 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'e eklendi. Ülke konumu ve alt ülke konumları kullanılarak trend olan analizler aranabilir.
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ışı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 Ek duyarlı öğeler gerektirmeden sunulan, özel olarak yüklenmiş görüntülü reklam resimleri.
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 öğe 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 SharedCriterion kaynağı için VerticalAdsItemGroupRuleInfo'da 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üşümlerdeki 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'yi üçüncü taraf görüntülenebilirlik entegrasyonu iş ortağı olarak yayınladı.
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 zarar veren 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 konumunda 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 içinde 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 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ı 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 ürünlerindeki is_brand_connect_creator alanı Yok Kaldırma Bunun yerine, içerik üreticinin partnership_opportunities içinde CREATOR_PARTNERSHIPS 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 içinde 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 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: 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'e 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 Aynı görünüme sahip birden fazla liste 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 optimizasyon yapmadığı dönüşümleri gösteren metrikler) eklendi:
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: 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ış, sentetik/yapay zekayla üretilen içeriklerle ilgili onaylar içermelidir.

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ştirme 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. Sisteminizin v25 kullanıma sunulduğunda tam yazma özelliklerine hazır olması için dahili mantığınızı oluşturup test etmek üzere arayüzü hemen kullanmaya başlamanı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'nin 23.2 sürümüne aşağıdaki yeni özellikler ve güncellemeler eklenmiştir. 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 oluşturulup oluşturulmadığı veya reklamveren tarafından sağlanıp sağlanmadığı gibi geliştirmeye özel video reklam bilgilerini içerir. Daha fazla bilgi 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 almak için destek 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ş aralıkları eklendi.
youtube_select_lineup_targeting Yeni alan youtube_select_lineups yerine geçecek olan ReachPlanService.ListPlannableProducts'a 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 eklendi.
Forecast Yeni alan ReachPlanService.GenerateReachForecast bölümüne Talep Yaratma kampanyalarında tıklamaları artırma (TBM) için clicks eklendi.
partnership_opportunities Yeni alan ContentCreatorInsightsService.GenerateCreatorInsights ve ContentCreatorInsightsService.GenerateTrendingInsights listelerine eklendi.
Raporlar
biddable_indirect_install_first_in_app_conversion_micros Yeni alan Campaign, Customer ve AdGroup kaynaklarına eklendi.
Videolar
ShareablePreviewService Yeni özellik preview_type değeri YOUTUBE_LIVE_PREVIEW olarak ayarlanarak YouTube canlı yayın önizlemeleri desteklenecek şekilde genişletildi. ShareablePreviewError listesine 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, yapay zeka tarafından oluşturulan metin öğelerini programatik olarak kontrol etmenizi sağlayan metin kuralları desteği eklendi. text_guidelines içinde term_exclusions ve messaging_restrictions öğelerini tanımlayabilirsiniz.
CampaignPrimaryStatusReason Yeni enum değerleri FIXED_CPM teklif stratejisine sahip kampanyalar için temel durum nedenleri 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ı kanaldan bir video izleyen kullanıcıların izlenmesini destekler.
Genel
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED Yeni enum değeri / hata Yalnızca demografik boyutlardaki 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 GOOGLE_DISPLAY_NETWORK, Talep Yaratma kampanyalarında dönüşümleri artırma hedefi 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ı varlık hedefleme 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)

Aşağıdaki yeni özellikler, güncellemeler ve zarar veren değişiklikler, ana sürüm olan Google Ads API v23'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
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ı için destek kaldırıldı. Telefon araması 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 Şu metrikler eklendi: metrics.average_cpe, metrics.average_cpm, metrics.trueview_average_cpv, metrics.video_trueview_view_rate, metrics.video_trueview_views ve metrics.interaction_event_types.
Asset.orientation Yeni alan Resim ve video öğelerine salt okunur yö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:
Faturalandırma
InvoiceService.ListInvoices Yeni seçenekler ListInvoicesRequest içinde include_granular_level_invoice_details ayarlanarak artık Invoice içinde daha ayrıntılı bilgiler (ör. kampanya düzeyinde maliyet dökümü, ayrıntılı düzenleyici maliyetler ve ayarlama bilgileri) döndürülebilir.
RegulatoryFeeType
UnitOfMeasure
Yeni numaralandırmalar Yasal ücretler ve ölçü birimleri için yardımcı enum'lar eklendi.
Kampanyalar
CampaignError Yeni enum değerleri / hatalar DURATION_TOO_LONG_FOR_TOTAL_BUDGET ve END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET hata kodları eklendi.
Dönüşümler
ConversionActionCategory Yeni enum değeri Bir reklamı izledikten sonra aynı kanaldan bir video izleyen kullanıcıların izlenmesini desteklemek için YOUTUBE_FOLLOW_ON_VIEWS eklendi.
Talep Yaratma
DemandGenVideoResponsiveAdInfo.companion_banner Yeni alan Talep Yaratma duyarlı video reklamlarında tamamlayıcı banner'lar için destek eklendi.
Teşvikler
Kendi Ödülünüzü Seçin (CYO) ödülleri desteği eklendi:

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 Unutulmaz 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'ye 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ğerindeki 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 segment Yeni segment Bir reklam ağı içinde ayrıntılı performans dökümü sağlar. Başlangıçta YouTube'daki Talep Yaratma kampanyaları (yayın içi, feed içi, Shorts) için 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 kullanan arama ağı kampanyalarında hangi reklam biçimlerinin yayınlanabileceğini kontrol etmenizi sağlar.
AdGroupCriterion
SharedCriterion
Yeni alanlar / kriterler Seyahat feed'leri içeren Arama Ağı kampanyalarında öğe gruplarının hedeflenmesine izin vermek için vertical_ads_item_group_rule_list ölçüt türü AdGroupCriterion'ye, vertical_ads_item_group_rule ise SharedCriterion'ye 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 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. Raporlamayı AdFormatType ve dikey reklam verileri 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 işitilebilirlik 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'nin 22.2 sürümüne 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ış, sentetik/yapay zekayla üretilen içeriklerle ilgili onaylar içermelidir.

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ştirme 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. Sisteminizin v25 kullanıma sunulduğunda tam yazma özelliklerine hazır olması için dahili mantığınızı oluşturup test etmek üzere arayüzü hemen kullanmaya başlamanızı öneririz.

Çok taraflı onaylar Yeni özellikler Çok taraflı onay (MPA) incelemeleri için destek 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.

22. sürüm (15.10.2025)

Aşağıdaki yeni özellikler, güncellemeler ve zarar veren 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 içinde 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'daki FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION bayrağı 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 referanslarını 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 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 ile birlikte kullanılır.
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: Standart dönüşüm değerini artırma ile 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 hedef TBM'yi 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 oranı 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 olarak oluşturulmasını (otomatik kırpma) 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 reklamda video öğesi kullanılıp kullanılmadığı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.
TrendInsight'ta ilgili videolar ve içerik üreticiler için destek Yeni alanlar TrendInsight üzerinde related_videos ve related_creators, video_properties ve publish_date üzerinde ise saat özellikleri için 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 segmentlenebiliyor.
TargetingExpansionView Yeni raporlama kaynağı Arama Ağı kampanyaları için AI Max'te anahtar kelimesiz genişletme gibi manuel hedeflemenin üzerindeki genişletmelerin metriklerini raporlamak için 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).

v21 ana ve alt sürümleri

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

21.2 sürümü (24.06.2026)

Google Ads API'nin 21.2 sürümüne aşağıdaki yeni özellikler ve güncellemeler eklenmiştir. v21.2 gibi küçük sürümlerde zarar veren değişiklikler bulunmaz.

Özellikler ve güncellemeler Tür Açıklama
Genel
Çok taraflı onaylar Yeni özellikler Çok taraflı onay (MPA) incelemeleri için destek eklendi:

v21.1 (25.02.2026)

Google Ads API v21.1'e aşağıdaki yeni özellikler ve güncellemeler eklendi. v21.1 gibi küçük 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 EuPoliticalAdvertisingStatusEnum 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.

v21 (06.08.2025)

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

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

Zarar veren değişiklikler

İlk durum Yeni durum Değişiklik türü Uygulama kılavuzu
Kampanyalar
İadeler CriterionError.INVALID_LISTING_GROUP_HIERARCHY İadeler CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION Hata kodu değişikliği Kısmi hata etkinleştirilmiş isteklerde, orijinal hiyerarşi hata kodu yerine yeni hata kodunu işleyin.
Dönüşümler
ConversionUploadService'da debug_enabled moduna erişim Yok Kaldırma debug_enabled alanı kaldırılır. Bu parametreyi ayarlamamak veya sorgulamamak için ona referans veren kodu güncelleyin.
AB siyasi reklamcılığı ile ilgili değişiklikler
AB'de siyasi reklamcılık için isteğe bağlı kampanya beyanları Yeni kampanyalar için zorunlu contains_eu_political_advertising alan Doğrulama kuralı / davranış değişikliği Bu alan ayarlanmazsa yeni kampanya oluşturmaya yönelik API çağrıları FieldError.REQUIRED hatasıyla başarısız olur. 22 Eylül 2025'ten itibaren CONTAINS_EU_POLITICAL_ADVERTISING olarak beyan edilen kampanyalar AB'de yayınlanmayacak.
Beyan olmadan değiştirilebilen ölçütler CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION ile güncellemeler başarısız oluyor Doğrulama kuralı / davranış değişikliği Mevcut kampanyalar için kampanya veya reklam grubu düzeyinde yakınlık, konum ya da konum grubu hedefleme ölçütleri oluşturmaya veya güncellemeye çalışmadan önce kendi beyan durumunu ayarlayın.
Kendi kendine beyan şartı olmayan denemeler ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION ile güncellemeler başarısız oluyor Doğrulama kuralı / davranış değişikliği Denemenin kampanyalarında kendi beyanlarının tamamlandığından emin olun.
Maksimum Performans
brand_guidelines_enabled varsayılan olarak false değerine ayarlanır. Varsayılan olarak true değerine ayarlanır. Davranış değişikliği Yeni Maksimum Performans kampanyalarında marka kuralları varsayılan olarak etkindir. Devre dışı bırakılmaları gerekiyorsa alanı açıkça false olarak ayarlayın.
Planlama
AudienceInsightsService.GenerateTargetingSuggestionMetrics için orijinal giriş bağımsız değişkeni türü InsightsAudience türünde giriş Tür değişikliği Uygulamaları, kullanıcı ilgi alanlarının OR'ların AND'si kombinasyonunu destekleyen yeni giriş türünü iletecek şekilde güncelleyin. Bu sayede, özel kitle tanımları için potansiyel erişim metriklerine izin verilir.

Özellikler ve güncellemeler (bozucu olmayan)

Özellikler ve güncellemeler Tür Açıklama
Arama Kampanyaları için Maksimum Yapay Zeka
Campaign bölgesindeki ai_max_setting.enable_ai_max Yeni alan Arama terimi eşlemeyi genişletmek için AI Max'i etkinleştirir (devre dışı bırakılana kadar önceki metin öğesi otomasyonuna ve marka listelerine saygı gösterilir). Campaign.ai_max_setting.bundling_required alanı, bu ayarlara uymak/ayarları değiştirmek için AI Max'in etkinleştirilmesi gerekip gerekmediğini gösterir. AdGroup.ai_max_ad_group_setting.disable_search_term_matching ise reklam grubu düzeyinde eşleşmeyi devre dışı bırakabilir. Arama Ağı kampanyaları için AI Max ile performansınızı bir üst seviyeye taşıma başlıklı makaleyi inceleyin.
CampaignError.AI_MAX_MUST_BE_ENABLED Yeni enum değeri / hata Arama Ağı kampanyalarında AI Max'i etkinleştirmeden URL genişletme metin öğesi otomasyonunu etkinleştirdiğinizde oluşturulur.
Reklam grubu düzeyinde hedefleme Yeni özellik Arama Ağı kampanyaları için AI Max'te reklam grubu düzeyinde marka listeleri, konumlar ve web sayfaları (URL kuralları) için destek eklendi.
ai_max_search_term_ad_combination_view Yeni raporlama kaynağı Arama terimleri, başlıklar ve açılış sayfalarının kombinasyonlarının performansını raporlar.
search_term_match_type segment Yeni enum değeri AI_MAX, arama terimi eşleme türü seçeneği olarak eklendi.
Öğeler
PromotionAsset Yeni alanlar terms_and_conditions_text, terms_and_conditions_uri ve oneof promotion_trigger seçenekleri (promotion_barcode_info, promotion_qr_code_info) eklendi. Promosyon öğeleri hakkında başlıklı makaleyi inceleyin.
AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION Yeni enum değeri Arama Ağı kampanyalarındaki nihai URL'lerden otomatik metin ve açılış sayfası oluşturma işlemlerini kontrol etmek için AssetAutomationType eklendi.
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset Yeni hizmet / yöntem Otomatik olarak oluşturulmuş nihai URL genişletmesi öğelerinin kampanyalardan kaldırılmasına olanak tanır.
ServedAssetFieldType.DESCRIPTION_PREFIX Yeni enum değeri ad_group_ad_asset_combination_view içinde türün UNKNOWN olarak döndürüldüğü bir raporlama sorunu düzeltildi.
Kampanyalar
CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING Yeni enum değeri Konumla sınırlı kampanyalarda konum hedefleme olmadığında döndürülür (artık izin verilen alanın dışında hedeflenirse LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN hatası verilir).
Üçüncü taraf uygulama analizleri entegrasyonu Yeni alanlar VideoCustomer.third_party_integration_partners ve Campaign.third_party_integration_partners için destek eklendi. Üçüncü taraf uygulama analiziyle uygulama dönüşümlerini izleme başlıklı makaleyi inceleyin.
Campaign.advertising_partner_ids Yeni alan desteği Alan artık mevcut kampanyalar için ayarlanabilir (ayarlanmış alanlar değiştirilemez).
Yönetici düzeyinde negatif yerleşimler Yeni özellik CustomerNegativeCriterion kullanılarak yerleşim listelerinin ayrı reklamveren hesaplarında hariç tutulmasına olanak tanır.
Hedef ROAS stratejilerindeki tolerans yapılandırmaları Yeni alanlar MaximizeConversionValue ve TargetRoas'da TargetRoas.target_roas_tolerance_percent_millis (Arama Ağı kampanyası portföy stratejileri için) desteği eklendi.
LocationInterestView Yeni raporlama kaynağı Reklam grubu konum ilgisi ölçütlerinin performansını özetler.
Dönüşümler
conversion_attribution_event_type segment Yeni enum değeri Dönüşüm ilişkilendirme türü seçeneklerine ENGAGED_VIEW eklendi.
Talep Yaratma
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM Yeni enum değeri / hata Talep Yaratma kampanyaları için minimum günlük bütçelerin uygulanmasına hazırlık amacıyla eklendi. Ayrıntılar budgetDailyMinimumErrorDetails kullanılarak gösterilir.
Maksimum Performans
campaign_search_term_view Yeni raporlama kaynağı Arama terimi metriklerini kampanya düzeyinde toplar. Böylece Maksimum Performans için arama terimi analizi ve raporlama yapılabilir.
Planlama
ReachPlanService.ListPlannableUserInterests Yeni yöntem generateReachForecast için planlanabilir yakın ilgi alanlarını ve pazardaki ilgi alanlarını keşfetmeye olanak tanır.
AdditionalApplicationInfo Yeni alan ReachPlanService.ListPlannableUserLists'da isteğe bağlı giriş olarak eklendi.
AudienceInsights özelliklerinin listesi Yeni özellik AudienceInsightsService.ListAudienceInsightsAttributes artık kullanılabilir birinci taraf kullanıcı listelerini getiriyor.
KitleKompozisyonuAnalizleri, CRM listelerini hedefleme Yeni özellik AudienceInsightsService.GenerateAudienceCompositionInsights artık AudienceInsightsDimension boyutları için kullanıcı listesi dizin ayrıntılarını döndürüyor: AGE_RANGE, GENDER, AFFINITY_USER_INTEREST ve IN_MARKET_USER_INTEREST.
TrendInsightMetrics kitle payı Yeni alan Bir trendin kitle payını gösterir.
KnowledgeGraphAttributeMetadata kategoriler Yeni alanlar Bilgi Grafiği özelliklerini eşleşen kategorilere göre filtreler.
Raporlar
Öğe görüntüleme metrikleri Yeni özellikler / metrikler AssetGroupAsset, ChannelAggregateAssetView ve CampaignAggregateAssetView'a birden fazla yeni metrik eklendi. Maksimum Performans kampanyaları artık impressions için gerçek değerleri de raporluyor.
Seçici uzantıları Yeni özellik AssetSet ve CampaignAssetSet, ChangeStatus içinde birlikte sorgulanabilir hale getirildi.
search_term_targeting_status Yeni segment Kampanya arama terimi görünümünde seçilebilir segment.
final_url_expansion_asset_view Yeni raporlama kaynağı Nihai URL genişletmesi öğe performansıyla ilgili ayrıntıları raporlar.
Öğe grubu değeri ayarlamaları Yeni alanlar AssetGroup raporunda value_adjustment ve all_value_adjustment metrikleri için destek eklendi.
landing_page_source Yeni segment landing_page_view içinde bir açılış sayfası kaynağı segmenti sağlar.
search_term_match_source Yeni segment Arama terimi ve kampanya arama terimi görünümlerinde seçilebilir segment.
match_type Yeni segment Anahtar kelime görünümünde seçilebilir segment anahtarı.
Benzersiz sorgu amacı kümeleri raporlama Yeni alanlar Tekil sorgu amacı kümelerini bildirmek için clicks_unique_query_clusters, conversions_unique_query_clusters ve impressions_unique_query_clusters eklendi.
ClickType.VEHICLE_ASSETS Yeni enum değeri click_view raporunda özellikle araç reklamı biçimleriyle ilgili tıklamaları izleyin ve raporlayın.
Akıllı Teklif Fırsatı Keşfi
Arama Ağı stratejilerindeki tolerans yapılandırmaları Yeni alanlar / ayarlar target_roas_tolerance_percent_millis değerini 10.000 (%10) ile 30.000 (%30) arasında (bu değerler dahil) ayarlayarak Arama Ağı kampanyalarında Akıllı Teklif Araştırması'nın etkinleştirilmesine olanak tanır (Dönüşümleri artırma için target_roas ayarı gerekir). Akıllı Teklif Araştırması ile ilgili blog yayınımıza ve Yardım Merkezi makalemize göz atın.
Çeşitlilik raporlama uyumluluğu Yeni özellik Tekil sorgu amacı kümeleri için aşağıdaki metriklerde artık birleştirilmiş çeşitlilik raporlaması desteklenmektedir. Google Ads kullanıcı arayüzünde zamana göre segmentlere ayrılmış bir görünüm bulunur:
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
Videolar
YouTubeVideoListAsset Yeni kaynak / alan Asset.youtube_video_list_asset kullanılarak kampanyalar ve video listesi öğeleri arasında bağlantı oluşturulmasına olanak tanır. İlgili videoları kullanma başlıklı makaleyi inceleyin.
Analizler meta veri uzantıları Yeni alanlar YouTubeChannelInsights ve YouTubeVideoAttributeMetadata öğelerine yeni meta veriler eklendi.
Etkileşimli tıklama türleri Yeni enum değerleri Eklenen tıklama türleri: VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK ve PRODUCT_ASSETS.
VideoAdInventoryControl.allow_non_skippable_in_stream Yeni alan Atlanabilir ve atlanamayan biçimlerin karıştırıldığı kampanyalarda duyarlı video reklamların atlanamayan yayın içi reklamlar olarak yayınlanmasına olanak tanır.
Video sıralama ayarları Yeni alanlar Salt okunur sıralama yapılandırmaları eklendi: Campaign.VideoCampaignSettings.video_ad_sequence ve VideoAdSequenceStepSetting. Video reklam sıralaması hakkında başlıklı makaleyi inceleyin.
Video kanal listesi hedefleme Yeni ölçüt türü / alanı CampaignCriterion ve AdGroupCriterion'ya VIDEO_LINEUP ölçüt türü ve ilgili alan eklendi. Bu özellik yalnızca izin verilenler listesindeki hesaplarda kullanılabilir.
İçerik uygunluğu yerleşimlerinin görüntüleme sayısı Yeni raporlama kaynakları Hem ayrıntı (detail_content_suitability_placement_view) hem de grup (group_content_suitability_placement_view) düzeyleri için içerik uygunluğu raporu eklendi. "İçerik uygunluğu" raporu hakkında başlıklı makaleyi inceleyin.

Arşivlenmiş sürüm notları

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