Google Ads API v20 Kapatıldı: Desteklenen Sürümler ve v25'e Geçiş Rehberi

Google Ads API v20, 10 Haziran 2026'da kapatıldı; bu tarihten itibaren v20'ye gönderilen tüm istekler başarısız oluyor. v21 de 5 Ağustos 2026'da kapatıldı. Bugün kullanılabilen ana sürümler v22, v23, v24 ve v25; en güncel sürüm 23 Eylül 2026'da yayınlanan v25.2. Hâlâ v20 veya v21'e bağlı bir araç ya da yazılım varsa hemen güncellenmeli, v22 kullananların da Ekim 2026 için planlanan kapanıştan önce geçiş yapması gerekiyor.

Google Ads API; reklam oluşturma, teklif ve bütçe yönetimi, dönüşüm yükleme ve raporlama gibi işlemleri yazılım üzerinden yapmayı sağlayan arayüzdür. Üçüncü taraf araçlar, ajans panoları, CRM entegrasyonları ve özel yazılımlar bu API'ye belirli bir sürüm üzerinden bağlanıyor. Google, Haziran 2025'te duyurduğu v20'yi 10 Haziran 2026'da kapattı; bu tarihten itibaren v20'ye gönderilen tüm istekler başarısız oluyor. Bu yazıda kapanışın ne anlama geldiğini, bugün hangi sürümlerin desteklendiğini ve eski bir sürümde kalan entegrasyonları nasıl güncelleyeceğinizi anlatıyoruz.

Google Ads API v20 Ne Zaman Kapandı?

Google Ads API'de "kullanımdan kaldırılmış" (deprecated) ve "kapatılmış" (sunset) sürüm farklı anlamlara geliyor. Yeni bir sürüm yayınlandığında önceki sürümler kullanımdan kaldırılmış sayılır ama çalışmaya devam eder; yalnızca yeni özellik almaz. Kapatma tarihinde ise sürümün uç noktaları çalışmayı durdurur ve bu sürüme gönderilen istekler hata döndürür. Google, sürüm takviminde bir sürümü yayınlanmasından yaklaşık bir yıl sonra kapatmayı hedeflediğini ve yılda en fazla iki yükseltme yapmanız gerekeceğini belirtiyor.

Bu takvime göre v20, 10 Haziran 2026'da; v21 ise 5 Ağustos 2026'da kapatıldı. Bu iki sürümden biriyle çalışan bir entegrasyon artık kampanya oluşturamıyor, teklif ve bütçe güncelleyemiyor, rapor çekemiyor. Tek çözüm, desteklenen bir sürüme geçmek.

Bugün Hangi Google Ads API Sürümleri Destekleniyor?

Google'ın kullanımdan kaldırma ve kapatma takvimine göre bugün kullanılabilen sürümler ve kapanış tarihleri aşağıdaki gibi. Google, "tahmini" ifadesinin kapanışın o ay içinde herhangi bir gün olabileceği ve tarihlerin değişebileceği anlamına geldiğini belirtiyor.

Yükseltmeyi sırayla yapmak zorunda değilsiniz; Google, sürüm atlayarak daha yeni bir sürüme doğrudan geçilebileceğini belirtiyor. Yani v20'den doğrudan v25'e geçebilirsiniz, ancak atladığınız her ana sürümdeki kırıcı değişiklikleri (breaking changes) kodunuza uygulamanız gerekir. Google her zaman en yeni sürüme geçmeyi öneriyor. Kapanışı Ekim 2026'da planlanan v22'ye geçmek kısa süre içinde yeni bir yükseltme gerektireceği için bugün mantıklı hedef v25 ailesi.

Hangi Sistemler Etkilendi?

v20 veya v21'e bağlı her araç, bu sürümlerin kapanış tarihinden itibaren çalışmayı durdurdu. Bu; istemci kitaplığı uzun süredir güncellenmemiş özel yazılımları, ajans panolarını, teklif ve bütçe otomasyonlarını, dönüşüm yüklemelerini ve rapor aktarımlarını kapsıyor. Örneğin Google Ads Akıllı Teklif Stratejileri ile çalışan kampanyaların hedeflerini API üzerinden güncelleyen bir araç, eski sürümde kaldıysa hedef değişikliklerini artık uygulayamaz.

Müşteri listelerini API ile yükleyen entegrasyonlar da aynı durumda: kapatılmış bir sürümdeki yükleme işi başarısız olur ve Google Ads Yeniden Pazarlama için kullandığınız listeler güncellenmez. Kalite puanı gibi anahtar kelime metriklerini API'den çeken raporlar da veri almayı keser; Google Ads Kalite Puanınızı 8 Adımda Yükseltin yazımızda anlattığımız takibi sürdürmek için rapor kaynağınızın desteklenen bir sürüme bağlı olması gerekir.

Google Ads arayüzündeki betikler (Google Ads scripts) biraz farklı çalışıyor. AdsApp başvuru belgesine göre AdsApp.search ve AdsApp.mutate gibi yöntemlerde apiVersion belirtmezseniz betik desteklenen en yeni sürümü kullanıyor. Kapatılmış sürümlere izin verilmediği için betikte apiVersion değerini v20 ya da v21 olarak sabitlediyseniz bu değeri güncellemeniz gerekir.

Güncel Sürüme Geçiş Adımları

Google'ın yükseltme rehberi, ana sürüm değiştiğinde uç noktanın da değiştiğini hatırlatıyor; istemci kitaplığını güncellemeyi, her sürümün sürüm notlarını incelemeyi ve sürümler arasındaki proto farkı tablolarına bakmayı öneriyor. Süreci şu adımlarla yürütebilirsiniz:

• Envanter çıkarın: Google Cloud Console'da APIs & Services bölümünden Google Ads API'yi açın. Metrics sekmesindeki Methods tablosunda projenizin çağırdığı yöntemler sürüm numarasıyla birlikte görünür (ör. google.ads.googleads.v20.services.GoogleAdsService.Mutate). Böylece hangi aracın hangi sürümü kullandığını kesin olarak görürsünüz.

• İstemci kitaplığını güncelleyin: Google'ın kitaplık tablosuna göre v25 için gereken en düşük istemci kitaplığı sürümleri Java'da 44.0.0, .NET'te 26.1.0, PHP'de 33.6.0 ve Python'da 31.2.0. v25.1 ve v25.2 gibi ara sürümler için gereken kitaplık sürümünü ilgili değişiklik günlüğünden kontrol edin.

• Kırıcı değişiklikleri uygulayın: Sürüm notlarında kırıcı değişiklikler ayrı bir tabloda listeleniyor. Örneğin v25'te eski CustomerLifecycleGoal ve CampaignLifecycleGoal kaynakları kaldırıldı, yerine birleşik Goal şeması geldi; LocalServicesLead kaynağındaki müşteri e-posta alanı da kaldırıldı. Atladığınız her ana sürümün notlarını ayrı ayrı inceleyin.

• Test edin: Canlı kampanyalara dokunmadan önce değişiklikleri bir test hesabında deneyin. Değişiklik isteklerini validate_only seçeneğiyle uygulamadan doğrulayabilirsiniz.

• Yayına alın ve izleyin: Geçişten sonraki ilk günlerde teklif, bütçe ve rapor verilerinin Google Ads arayüzündeki değerlerle tutarlı olduğunu kontrol edin. Hatalı bir teklif ya da bütçe güncellemesi kampanya performansını hemen etkileyebilir.

Kendi yazılımınız yerine bir üçüncü taraf aracı kullanıyorsanız, sağlayıcıdan aracın hangi API sürümünü kullandığını ve bir sonraki kapanışa göre planını öğrenin. v24.2 ile gelen yenilikleri Google Ads API 24.2 sürümü yazımızda ayrıca ele aldık.

Sonraki Kapanışlara Nasıl Hazırlıklı Olursunuz?

Kapanış hatırlatmaları Google Ads Developer Blog'da yayınlanıyor ve Google, bu duyuruları kaçırmamak için bloga abone olmayı öneriyor. Güncel takvime göre sıradaki kapanış Ekim 2026'da v22; v26'nın da Ekim 2026'da yayınlanması planlanıyor. Sürüm takvimini düzenli kontrol etmek ve istemci kitaplığını her ana sürümde güncellemek, bir sonraki kapanışa hazırlıksız yakalanmamanın en kolay yolu.

Sonuç

Google Ads API v20, 10 Haziran 2026'da; v21 ise 5 Ağustos 2026'da kapatıldı; bu sürümlere bağlı entegrasyonlar artık çalışmıyor. Bugün desteklenen ana sürümler v22, v23, v24 ve v25; v22'nin kapanışı da Ekim 2026 için planlanıyor. v25 ailesinin kapanışı Ağustos 2027'de planlandığı için eski bir sürümde kalan araçları doğrudan v25'e taşımak, bir sonraki zorunlu yükseltmeyi en uzağa öteler. Güncel bir sürüme bağlı otomasyon, Google Ads kampanya optimizasyonu çalışmalarınızı da kesintisiz sürdürmenizi sağlar.