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:
|
| 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 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:
|
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:
|
| 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:
|
| 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:
|
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 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 |
||
| 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, |
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 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:
|
| Kampanyalar | ||
AppCampaignBiddingStrategyGoalType |
Yeni enum değerleri | Hedef belirtmeden optimizasyon yapmak için yüklemelere yönelik uygulama kampanyalarına (ACI) yeni hedefler eklendi:
|
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:
|
| Maksimum Performans raporlama segmentleri | Yeni segmentler | Maksimum Performans kampanyalarına özel yeni segmentler eklendi:
|
| 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:
|
| 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.