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.
v25 ana ve alt sürümleri
Google Ads API v25 aşağıdaki yeni özellikleri, güncellemeleri ve önemli değişiklikleri içerir.
25.1 sürümü (19.08.2026)
Google Ads API v25.1'e aşağıdaki yeni özellikler ve güncellemeler eklendi. v25.1 gibi küçük sürümlerde zarar veren değişiklikler bulunmaz.
| Özellikler ve güncellemeler | Tür | Açıklama |
|---|---|---|
| Öğeler | ||
AssetFieldType.TEXT_DISCLAIMER ServedAssetFieldType.TEXT_DISCLAIMER |
Yeni enum değerleri | Metin sorumluluk reddi beyanı öğeleri için destek eklendi. |
| Kampanyalar | ||
Campaign.aca_migration_date_time Campaign.broad_match_migration_date_time |
Yeni alanlar | Yaklaşan otomatik taşıma işlemini AI Max'e kadar takip edin. |
| Dönüşümler | ||
| Brand Lift ölçümleri | Yeni özellikler | Aşağıdaki güncellemelerle Brand Lift ölçümleri için destek eklendi:
|
| Dönüşüm Artışı ölçümleri | Yeni özellikler | Aşağıdaki güncellemelerle Dönüşüm Artışı ölçümleri için destek eklendi:
|
LiftMeasurementFlight |
Yeni kaynak | Ölçülen yayın başlangıç ve bitiş tarihleri (start_date ve end_date) dahil olmak üzere artış ölçümü yapılandırması için yayın ayrıntılarını temsil eden yeni bir salt okunur kaynak. |
| Genel | ||
SmartCampaignError |
Yeni enum değerleri | Maksimum Performans oluşturma kısıtlamaları için yeni hata kodları eklendi: |
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION |
Yeni enum değeri / hata | TEST erişim düzeyine sahip bir Google Cloud projesi, test hesabı olmayan bir hesaba karşı istekte bulunmaya çalıştığında döndürülür. |
| Planlama | ||
| Marka duyarlılığı analizleri | Yeni özellikler | ContentCreatorInsightsService bölümünde marka duyarlılığı analizleri için destek eklendi:
|
BenchmarksService geliştirmeler |
Yeni özellikler | Karşılaştırma analizinin kapsamını belirlemek için filtre olarak kategoriler için destek eklendi. Ayrıca, işletme için kritik öneme sahip ek metrikler de desteklenir:
|
| Ebeveynlik durumu hedefleme | Yeni özellik | Erişim planlamada ebeveynlik durumu hedefleme desteği eklendi. ReachPlanService.GenerateReachForecast hizmeti için Targeting'a parental_statuses, ReachPlanService.ListPlannableProducts hizmeti için PlannableTargeting'a parental_statuses adlı yeni alan eklendi. |
| Öneriler | ||
Recommendation.campaign_specific_app_goal_recommendation |
Yeni öneri | Kampanyaya özel uygulama dönüşümü hedefi eklemenizi önerir. Bu önerideki mevcut hedefleri temsil etmek için yeni EffectiveAutomaticGoal kaynağı kullanılır. |
| Raporlar | ||
Metrics.original_conversion_value |
Yeni alan | Teklif verilebilir dönüşümlerden elde edilen orijinal dönüşüm değerini gösterir. Bu, dönüşüm değeri kuralları veya yaşam döngüsü hedefleri ayarlamaları gibi değer kuralı ayarlamaları uygulanmadan önceki ayarlanmamış dönüşüm değeridir. |
| Bağlılık üyeliği istatistikleri | Yeni özellikler | İstatistiklerin kullanıcı bağlılık üyeliği programı durumuna göre segmentlere ayrılmasına yönelik destek eklendi ve dönüşüm değeri kuralları için bağlılık üyeliği birincil boyutu eklendi:
|
| Hedefleme | ||
vertical_ads_item_bid |
Yeni ölçüt türü | AdGroupCriterion.criterion'a yeni vertical_ads_item_bid ölçüt türü eklendi. |
v25 (22.07.2026)
Aşağıdaki yeni özellikler, güncellemeler ve zarar veren değişiklikler, ana sürüm olan Google Ads API v25'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 | |||
CustomerLifecycleOptimizationValueSettings içindeki bağımsız alanlar additional_value ve additional_high_lifetime_value |
Yeni value_multiplier ve high_lifetime_value_multiplier alanlarının yanı sıra sırasıyla value_adjustment ve high_lifetime_value_adjustment oneof'larının bir parçası |
Yapısal değişiklik | Bu alanlar artık oneof'ların bir parçası olduğundan bunlara yapılan referansları güncelleyin. |
Eski CustomerLifecycleGoal ve CampaignLifecycleGoal kaynakları, ilgili hizmetleri CustomerLifecycleGoalService ve CampaignLifecycleGoalService ve eski ayarlar/numaralandırmalar (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings) |
Yok | Kaldırma | Yenilenen birleştirilmiş hedefler şemasını kullanın:
|
| Genel | |||
Teşvik Hizmeti istek ve yanıt mesajlarındaki iç içe yerleştirilmiş enum alanları:
|
Bağımsız enum alanları: | Yeniden adlandırma / kaldırma | Eski type alanları yerine yeni bağımsız enum alanlarını kullanın. |
ApplyIncentiveRequest içindeki isteğe bağlı selected_incentive_id ve customer_id alanları |
Zorunlu alanlar | Davranış değişikliği | ApplyIncentive işlevini çağırırken her iki alanı da sağladığınızdan emin olun. |
LocalServicesLead kaynağındaki tüketici e-posta adresi alanı ContactDetails.email |
Yok | Kaldırma | Artık desteklenmediği için bu alana yapılan referansları kaldırın. |
AdvertisingPartnerLinkInvitationProperties içinde isteğe bağlı allowed_domain alanı |
Bir reklamcılık iş ortağı için CreateProductLinkInvitation aranırken zorunlu alan |
Davranış değişikliği | Bir reklamcılık iş ortağı için ürün bağlantısı daveti oluştururken allowed_domain sağladığınızdan emin olun. |
| Planlama | |||
GenerateCreatorInsightsRequest uygulamasındaki search_brand alanı |
Yok | Kaldırma | Bunun yerine search_topics kullanın. |
Targeting içindeki plannable_location_id alanı ve GenerateReachForecastRequest içindeki cookie_frequency_cap alanı |
Yok | Kaldırma | plannable_location_ids ve cookie_frequency_cap_setting kullanımına geçin. |
| Raporlar | |||
GenerateBenchmarksMetricsResponse ve BreakdownMetrics ürünlerindeki customer_metrics alanı, Metrics türünde |
CustomerMetrics türündeki alan |
Tür değişikliği / davranış değişikliği | Entegrasyonlarınızı, yalnızca müşterinin reklam performansını temsil eden metrikleri içeren yeni CustomerMetrics türünü kullanacak şekilde güncelleyin. |
Özellikler ve güncellemeler (bozucu olmayan)
| Özellikler ve güncellemeler | Tür | Açıklama |
|---|---|---|
| Reklamlar | ||
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS |
Yeni enum değeri / davranışı | DemandGenMultiAssetAds tarihine kadar kullanılabilir. Etkinleştirilirse giriş olarak animasyonsuz resimleri kullanarak animasyonlu resimler oluşturur. Bu API sürümünden itibaren yeni DemandGenMultiAssetAds varsayılan olarak etkinleştirilir. |
| Yapay içerik bilgilerinin değiştirilebilirliği | Davranış değişikliği | Asset.synthetic_content_info ve Ad.synthetic_content_info artık 25, 24 ve 23 sürümlerinde tamamen değiştirilebilir. |
| Kampanyalar | ||
| Bağlılığı Elde Tutma Hedefi | Yeni özellikler / ayarlar | Reklamverenlerin kampanyaları bağlılık programı üyelerini elde tutacak şekilde optimize etmesine olanak tanıyan bağlılık elde tutma hedefi için destek eklendi.
|
| Yeni Müşteri Edinme Hedefi | Yeni özellikler / ayarlar | Yenilenen birleştirilmiş hedefler şemasını yansıtmak için Google Ads API'de güncellenen yeni müşteri edinme hedefi desteği:
|
| Dönüşümler | ||
| YouTube üçüncü taraf dönüşüm ilişkilendirmesi | Yeni alanlar | Üçüncü taraf iş ortakları kullanılarak YouTube dönüşüm ilişkilendirme doğrulaması için destek eklendi:
|
| Genel | ||
ContactDetails.phone_number_extension |
Yeni alan | LocalServicesLead kaynağına eklendi. |
IncentiveError |
Yeni enum değerleri / hatalar | Teşvik kullanma hataları için yeni hata kodları eklendi:
|
| Planlama | ||
| Trend olan analizlerdeki YouTube kanalı ayrıntıları | Yeni alanlar | Trend analizleri aranırken ilgili videoların daha fazla YouTube kanalı ayrıntısı için destek eklendi. channel_id, channel_name ve channel_url adlı yeni alanlar YouTubeVideoAttributeMetadata'e eklendi. |
YouTubeChannelInsights.data_sharing_consent_given |
Yeni alan | YouTubeChannelInsights ekranına eklendi. İçerik üretici, herkese açık olmayan verileri paylaşmayı kabul ettiyse bu durum geçerlidir. Bu durumda aşağıdaki alanlar doldurulur:
|
| Raporlar | ||
ad_sub_format_type |
Yeni segment | YouTube yayın içi atlanamayan reklamlarının süreye göre dökümünü sağlar:
ad_format_type ile birlikte seçilmelidir. AdGroup, AdGroupAd, Campaign, Customer, Video ve VideoEnhancement ile seçilebilir.
|
| Videoya özel sosyal metrikler | Yeni alanlar / metrikler | Reklamverenlerin YouTube'daki Shorts reklamlarında kullanıcı etkileşimini (yorumlar, beğeniler ve paylaşımlar) izlemesine yardımcı olmak için videoya özel sosyal metrikler eklendi:
AdGroup, AdGroupAd, Asset, Campaign, Customer ve Video'de kullanılabilir.
|
v24 ana ve alt sürümleri
Google Ads API v24 aşağıdaki yeni özellikleri, güncellemeleri ve önemli değişiklikleri içerir.
24.2 sürümü (24.06.2026)
Google Ads API v24.2'ye aşağıdaki yeni özellikler ve güncellemeler eklendi. v24.2 gibi küçük sürümlerde zarar veren değişiklikler bulunmaz.
| Özellikler ve güncellemeler | Tür | Açıklama |
|---|---|---|
| Reklamlar | ||
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT |
Yeni enum değeri | DemandGenVideoResponsiveAd örnekleri için etkileşim panelinde gösterilecek açılış sayfası metin bilgilerini oluşturur (bu API sürümünden itibaren varsayılan olarak etkinleştirilir). |
| Öğeler | ||
AssetGroup.google_local_services_info |
Yeni alan | Maksimum Performans kampanyalarında Yerel Hizmet Reklamları bilgilerinin (kategori kimliği ve açıklama metinleri) desteklenmesi 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'ı dahil eder. |
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN |
Yeni enum değeri / hata | Tüm konumları bir yerel hizmet Maksimum Performans kampanyasından kaldırmaya çalışırken döndürülür. |
SmartCampaignErrorEnum.CREATION_FAILED |
Yeni enum değeri / hata | Yeni akıllı kampanyalar oluşturulmaya çalışıldığında döndürülür. |
| Dönüşümler | ||
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS |
Yeni enum değerleri | Bir kullanıcının Yerel 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_attestation (doğrudan reklamveren tarafından sağlanan beyanlar) ve system_attestation (sistem tarafından otomatik olarak algılanan veya sağlanan onaylar) olmak üzere ikiye ayrılmış, yapay/yapay zekayla üretilmiş içeriklere yönelik onaylar içerir.
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şiklik isteğinde bulunursanız şu hatalardan biri döndürülür: "The field attempted to be mutated is immutable" (Değiştirilmeye çalışılan alan değiştirilemez) veya "Field cannot be set" (Alan ayarlanamaz). Bu alanlar, v25'ten itibaren tamamen değiştirilebilir hale gelecek. 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 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. Seçilen ülkede görüntülenen veya bu ülkede yaşayan ve konum verilerini paylaşmayı kabul eden 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 öğesinin artık değiştirilebilir olduğunu unutmayın. |
| Kampanyalar | |||
Campaign.video_brand_safety_suitability |
Yok | Kaldırma | Kampanya düzeyinde uygunluk kontrolü kaldırıldı. Marka güvenliği uygunluğu, müşteri düzeyinde kullanılmaya devam etmektedir. Bunun yerine Customer.video_brand_safety_suitability kullanın. |
| Dönüşümler | |||
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS |
Yok | Kaldırma | Bağlılık programına kaydolan kullanıcı 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 | Birden fazla özdeş benzer kitle listesi oluşturulmaya çalışıldığında döndürülür. |
| Planlama | ||
ListPlannableProductsResponse içindeki ProductCoreAttributes alan |
Yeni alanlar | ListPlannableProductsResponse bölümündeki ProductCoreAttributes'ye planlanabilir ürün açıklaması, pazarlama hedefi, maliyet modeli ve satın alma yöntemi eklendi. |
| Raporlar | ||
CartDataSalesView |
Yeni raporlama kaynağı | Dönüşüm metriklerini, tıklanan ürünün yanı sıra satılan belirli ürüne (marka vb.) göre 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çerir.
25. sürüm için yaklaşan entegrasyon çalışmalarınızı planlamanıza yardımcı olmak amacıyla, reklamveren onay alanlarını değiştirme arayüzü 22. sürüm ve sonraki sürümlerde erken kullanıma sunuluyor. Arayüz bu sürümlerde görünür ancak Bu alanlardan birinde değişiklik isteğinde bulunursanız şu hatalardan biri döndürülür: "The field attempted to be mutated is immutable" (Değiştirilmeye çalışılan alan değiştirilemez) veya "Field cannot be set" (Alan ayarlanamaz). Bu alanlar, v25'ten itibaren tamamen değiştirilebilir hale gelecek. 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 v23.2'ye aşağıdaki yeni özellikler ve güncellemeler eklendi. v23.2 gibi küçük sürümlerde zarar veren değişiklikler bulunmaz.
| Özellikler ve güncellemeler | Tür | Açıklama |
|---|---|---|
| Öğeler | ||
VideoEnhancement |
Yeni kaynak | Google tarafından 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 olarak 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 uygulamalarına eklendi. |
| Raporlar | ||
biddable_indirect_install_first_in_app_conversion_micros |
Yeni alan | Campaign, Customer ve AdGroup kaynaklarına eklendi. |
| Videolar | ||
ShareablePreviewService |
Yeni özellik | preview_type değeri YOUTUBE_LIVE_PREVIEW olarak ayarlanarak YouTube canlı yayın önizlemeleri desteklenecek şekilde genişletildi. ShareablePreviewError 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 ve yapay zeka tarafından oluşturulan metin öğelerini programatik olarak kontrol etmenizi sağlayan metin kuralları için destek eklendi. text_guidelines içinde term_exclusions ve messaging_restrictions öğ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 | Talep Yaratma kampanyalarında dönüşümleri artırma hedefi için GOOGLE_DISPLAY_NETWORK, hedeflenebilir bir yüzey olarak eklendi. |
GenerateTrendingInsights |
Yeni alanlar | Konuya göre arama yaparken TrendInsightDataPoint ile TrendInsights arasındaki geçmiş trend çizgisi bilgileri eklendi. |
| Raporlar | ||
| Benzersiz kullanıcı sıklığı metrikleri | Yeni alanlar | Reklamınızı en az iki, üç, dört, beş veya on kez gören kullanıcı sayısını bildiren yeni metrikler eklendi: unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus ve unique_users_ten_plus. |
SearchTermMatchSource |
Yeni enum değeri | Seyahat reklamları 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ı desteği 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ğerinde karşılaştırma dönemi boyunca gerçekleşen yüzde değişimi gösterir. |
| Öneriler | ||
GenerateRecommendationsRequest |
Yeni alan | is_new_customer eklendi. CAMPAIGN_BUDGET önerileri için true olarak ayarlandığında yeni müşteriler için optimize edilmiş bir model kullanılır (yalnızca kampanyası olmayan müşteriler için önerilir). |
| Raporlar | ||
AdGroupAdAssetView |
Yeni özellik / metrik desteği | Artık RESPONSIVE_DISPLAY_AD için gösterim, performans ve dönüşüm metriklerini destekliyor. |
ad_sub_network_type segment |
Yeni segment | Bir reklam ağı içinde ayrıntılı performans dökümü sağlar. İlk olarak YouTube'daki Talep Yaratma kampanyalarında (yayın içi, feed içi, Shorts) kullanılabilir. ad_network_type ile birlikte seçilmelidir. |
| Maksimum Performans raporları | Yeni özellik | Maksimum Performans kampanyaları için etkinleştirilen reklam ağı türü dökümü. |
UserLocationView GeographicView |
Yeni segment desteği | Dönüşüm tarihine göre segmentlere ayrılmış metrikler: 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 verileri feed'ini AI Max'in kullanıldığı bir Arama Ağı kampanyasına bağlayabilirsiniz. vertical_ads_format_setting ile biçimleri kontrol edin ve vertical_ads_item_group_rule kullanarak kurallar tanımlayın. 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çerir.
25. sürüm için yaklaşan entegrasyon çalışmalarınızı planlamanıza yardımcı olmak amacıyla, reklamveren onay alanlarını değiştirme arayüzü 22. sürüm ve sonraki sürümlerde erken kullanıma sunuluyor. Arayüz bu sürümlerde görünür ancak Bu alanlardan birinde değişiklik isteğinde bulunursanız şu hatalardan biri döndürülür: "The field attempted to be mutated is immutable" (Değiştirilmeye çalışılan alan değiştirilemez) veya "Field cannot be set" (Alan ayarlanamaz). Bu alanlar, v25'ten itibaren tamamen değiştirilebilir hale gelecek. 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. |
v22 (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 olarak ayarlandığından emin olun. |
| Maksimum Performans | |||
| Öğe performans etiketleri | Yok | Kaldırma | Öğe performans etiketleri desteği ve ilişkili performans etiketi numaralandırması, Maksimum Performans kampanyaları için kaldırıldı. Entegrasyonları buna göre güncelleyin. |
Campaign.url_expansion_opt_out |
AssetAutomationSetting içinde FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION 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). |
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.