Kullanımdan kaldırma ve kullanımdan kaldırma

Yeni bir sürüm yayınlandığında, desteği sonlandırılan sürüme bir sonlandırma tarihi verilir. Bu tarihten sonra ilgili sürüm artık kullanılamaz. Aşağıda, göz önünde bulundurmanız gereken diğer yönergeler verilmiştir:

  • Herhangi bir zamanda en fazla beş ana sürümün kullanılabilir olmasını sağlamaya çalışırız.
  • Ana sürümlerin kullanım ömrü yaklaşık 12 aydır. Alt sürümlerin kullanım ömrü ise 10 aydır.
  • Yılda en fazla iki yükseltme yapmanız gerekir ve yükseltmeleri kesinlikle sıralı bir şekilde yapmanız gerekmez. Örneğin, doğrudan (N) sürümünden (N+2) sürümüne yükseltebilirsiniz.

İstemci kitaplıklarımız, hizmetlerin mevcut tüm sürümlerini destekler. Bu nedenle, kullanılan hizmetlerin farklı sürümlerini belirterek kademeli olarak yükseltme yapabilirsiniz.

Zaman çizelgesi

Aşağıdaki tabloda, her sürümün kullanımdan kaldırılma ve desteğinin sonlandırılma tarihleri ile gelecekteki sürümlerin planlanan yayın tarihleri listelenmektedir. Yayınlandıktan sonra en kısa sürede en yeni sürüme geçmenizi öneririz. Geçici tarih, desteğin sonlandırılmasının o ay içinde herhangi bir zamanda gerçekleşebileceği ve tarihlerin değişebileceği anlamına gelir. API sürümünün kullanımdan kaldırılmasıyla ilgili duyuru hatırlatıcıları için bloga abone olun.

API sürümüYayın tarihiKullanımdan kaldırma tarihiYükseltme kılavuzu
Yayınlanan sürümler
v2215 Ekim 2025Ekim 202621. sürümden 22. sürüme yükseltme
v2328 Ocak 2026Şubat 2027v22'den v23'e yükseltme
v23.1 25 Şubat 2026 Şubat 2027 23 sürümünden 23.1 sürümüne yükseltme
v23.2 25 Mart 2026 Şubat 2027 v23.1'den v23.2'ye yükseltme
v24 22 Nisan 2026 Mayıs 2027 23.2 sürümünden 24 sürümüne yükseltme
v24.1 13 Mayıs 2026 Mayıs 2027 24 sürümünden 24.1 sürümüne yükseltme
v24.2 24 Haziran 2026 Haziran 2027 24.1 sürümünden 24.2 sürümüne yükseltme
v25 22 Temmuz 2026 Ağustos 2027 24.2 sürümünden 25 sürümüne yükseltme
v25.1 19 Ağustos 2026 Ağustos 2027 25. sürümden 25.1 sürümüne yükseltme
v25.2 23 Eylül 2026 Ağustos 2027 25.1 sürümünden 25.2 sürümüne yükseltme
Gelecek sürümler
v26 Ekim 2026 Kasım 2027  
v26.1 Ekim 2026 Kasım 2027  
v26.2 Kasım 2026 Kasım 2027  
v26.3* Aralık 2026 Kasım 2027  
v27 Ocak 2027 Şubat 2028  
v27.1 Şubat 2027 Şubat 2028  
v27.2 Şubat 2027 Şubat 2028  
v27.3 Mart 2027 Şubat 2028  
v27.4 Mart 2027 Şubat 2028  
v28 Nisan 2027 Mayıs 2028  
v28.1 Nisan 2027 Mayıs 2028  
v28.2 Mayıs 2027 Mayıs 2028  
v28.3 Mayıs 2027 Mayıs 2028  
v28.4 Haziran 2027 Mayıs 2028  
v28.5 Haziran 2027 Mayıs 2028  
v29 Temmuz 2027 Ağustos 2028  
v29.1 Temmuz 2027 Ağustos 2028  
v29.2 Ağustos 2027 Ağustos 2028  
v29.3 Ağustos 2027 Ağustos 2028  
v29.4 Eylül 2027 Ağustos 2028  
v29.5 Eylül 2027 Ağustos 2028  
v30 Ekim 2027 Kasım 2028  
v30.1 Ekim 2027 Kasım 2028  
v30.2 Kasım 2027 Kasım 2028  
v30.3* Aralık 2027 Kasım 2028  

* v26.3 ve v30.3, yıl sonu dönemine denk geldiği için isteğe bağlı sürümler olarak belirlenmiştir.

Projenizin kullandığı sürümleri görüntüleme

Projenizin son zamanlarda çağırdığı yöntem ve hizmetlerin listesini Google Cloud Console'u kullanarak görüntüleyebilirsiniz:

  1. Google Cloud Console'da API'ler ve Hizmetler'i açın.
  2. Tabloda Google Ads API'yi tıklayın.
  3. METRİKLER alt sekmesinde, son isteklerinizin her bir grafikte çizildiğini görürsünüz. Hangi yöntemlere istek gönderdiğinizi Yöntemler tablosunda görebilirsiniz. Yöntem adı, Google Ads API sürümünü, hizmeti ve yöntem adını (ör. google.ads.googleads.v25.services.GoogleAdsService.Mutate) içerir.
  4. (İsteğe bağlı) İstekleriniz için görüntülemek istediğiniz zaman aralığını seçin.

Desteği sonlandırma ve kullanımdan kaldırma arasındaki farklar

TerimKullanımdan kaldırmaGün batımı
Tanım Desteği sonlandırılan sürüm, en son sürüm olmayan bir sürümdür. Yeni bir sürüm yayınlandığında önceki tüm sürümler desteği sonlandırıldı olarak işaretlenir. Sonlandırılan sürüm artık kullanılamaz. Bu sürüme gönderilen istekler, sonlandırma tarihinde veya sonrasında başarısız olur.
Anlamı Kullanımdan kaldırılan sürümleri kullanımdan kaldırılana kadar kullanmaya devam edebilirsiniz. Ancak, kullanımdan kaldırılan sürümlerin referansları, artık en yeni sürüm olmadıklarını göstermek için vurgulanmaz.

Yeni özelliklerden yararlanmak için en kısa sürede en yeni sürüme geçmenizi öneririz.

Google Ads API'yi kullanmak için desteği sonlandırılan sürümlerden hemen yükseltme yapmanız gerekir.

Yükseltme kılavuzunu kullanarak en yeni sürüme yükseltmenizi kesinlikle öneririz.

Zamanlama Ortalama olarak her 3-4 ayda bir yeni bir sürüm yayınlıyoruz. Bu nedenle, belirli bir sürüm yaklaşık 3-4 ay sonra kullanımdan kaldırılır. Bir sürümü, yayınlandıktan 1 yıl sonra kullanımdan kaldırmayı planlıyoruz.
API Desteği sonlandırılan sürümlerin API uç noktaları her zamanki gibi çalışmaya devam eder.

İstemci kitaplıklarımızı ve REST'i kullanarak API uç noktalarımıza erişebilirsiniz. Ancak desteği sonlandırılan sürümlere yeni özellikler eklenmez.

Desteği sonlandırılan sürümlerin API uç noktaları, desteğin sonlandırıldığı tarihten sonra çalışmayı durdurur. Desteği sonlandırılan sürümlerin API uç noktalarına erişmeye çalışırsanız Google Ads API hata verir.
İstemci kitaplıkları Kompakt istemci kitaplıkları sağlamak amacıyla, desteği sonlandırılan API sürümlerini, desteğin sonlandırılma tarihinden sonra yeni bir istemci kitaplığı sürümüne dahil etmeyi durduracağız. Bu, istemci kitaplıklarımızı projelerinize dahil ederken yerden tasarruf etmenize yardımcı olur. İstemci kitaplıkları, kullanımdan kaldırılan API sürümlerini, kullanımdan kaldırılma tarihlerinden sonraki yeni istemci kitaplığı sürümlerinde artık desteklemez.
Destek Kullanımdan kaldırılan sürümler için düzenli destek sunarız. Sonlandırılan sürümler, sonlandırma tarihinden sonra artık desteklenmez.

Desteklenen istemci kitaplığı sürümleri

Tabloda, hangi istemci kitaplıklarının hangi API sürümleriyle çalıştığı gösterilmektedir.

Listelenen minimum istemci kitaplığı sürümü, Google Ads API'nin ana sürümü (ör. v25) için yeterlidir. Küçük sürümler için gerekli istemci kitaplığı sürümünü görmek istiyorsanız bağlı değişiklik günlüğüne bakın.

Java

Değişiklik günlüğü

Java için istemci kitaplığı
v25 Min: 44.0.0
Max: -
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -

C#

Değişiklik günlüğü

.NET için istemci kitaplığı
v25 Min: 26.1.0
Max: -
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -

PHP

Değişiklik günlüğü

PHP için istemci kitaplığı
v25 Min: 33.6.0
Max: -
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -

Python

Değişiklik günlüğü

Python için istemci kitaplığı
v25 Min: 31.2.0
Max: -
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -

Ruby

Değişiklik günlüğü

Ruby için istemci kitaplığı
v25 Min: 43.0.0
Max: -
v24 Min: 40.0.0
Max: -
v23 Min: 38.0.0
Max: -

Perl

Değişiklik günlüğü

Perl için istemci kitaplığı
v25 Min: 33.0.0
Max: -
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -

Desteği sonlandırılan özellikler ve değişiklikler

Bu sayfada API sürümü düzeyindeki yaşam döngülerine odaklanılsa da tek tek özelliklerin desteğinin sonlandırılması (ör. Akıllı Kampanyalar'ın desteğinin sonlandırılması) ve sürüm oluşturulmamış iş akışı değişiklikleri (ör. yeni Talep Yaratma kampanyası bütçe şartları) ayrı ayrı izlenir.

Etkin sürümlerdeki yaklaşan özellik yaşam döngülerini ve davranış değişikliklerini kontrol etmek için Özelliklerin kullanımdan kaldırılması ve sürüme bağlı olmayan değişiklikler kılavuzuna bakın.