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

Yeni bir sürümün yayınlanmasıyla birlikte, desteği sonlandırılan sürümler için sonlandırma tarihi belirlenir. Bu tarihten sonra söz konusu sürüm kullanılamaz. Unutulmaması gereken diğer bazı kurallar aşağıda 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 ay, 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, bir hizmetin mevcut tüm sürümlerini destekler. Böylece, kullanılan hizmetlerin farklı sürümlerini belirterek kademeli olarak yükseltme yapabilirsiniz.

Zaman çizelgesi

Aşağıdaki tabloda, kullanımdan kaldırılma ve kullanımdan kalkma tarihleri ile gelecekteki sürümlerin planlanan yayın tarihleri listelenmektedir. Yayınlandıktan sonra en kısa sürede en son sürüme yükseltmenizi öneririz. Geçici tarih, desteğin sonlandırılmasının ilgili ay içinde herhangi bir zamanda gerçekleşebileceği ve tarihlerde değişiklik olabileceğ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ü	Çıkış tarihi	Kullanımdan kaldırma tarihi	Yükseltme kılavuzu
Yayınlanan sürümler
v21	6 Ağustos 2025	Ağustos 2026 (tahmini)	v20'den v21'e yükseltme
v22	15 Ekim 2025	Ekim 2026 (tahmini)	v21'den v22'ye yükseltme
v23	28 Ocak 2026	Şubat 2027	v22'den v23'e yükseltme
v23.1	25 Şubat 2026	Şubat 2027	v23'ten v23.1'e yükseltme
v23.2	25 Mart 2026	Şubat 2027	v23.1'den v23.2'ye yükseltme
v24	22 Nisan 2026	Mayıs 2027	v23.2'den v24'e yükseltme
v24.1	13 Mayıs 2026	Mayıs 2027	24. sürümden 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
Gelecek sürümler
v25	Temmuz 2026	Ağustos 2027
v25.1	Ağustos 2026	Ağustos 2027
v25.2	Eylül 2026	Ağustos 2027
v26	Ekim 2026	Kasım 2027
v26.1*	Kasım 2026	Kasım 2027

* v26.1, tatil sezonuyla çakıştığı için isteğe bağlı sürüm olarak belirlenmiştir.

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

Projenizin son zamanlarda çağırdığı yöntemlerin 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 grafikte gösterildiğ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ı içerir. Örneğin, google.ads.googleads.v24.services.GoogleAdsService.Mutate.
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

Terim	Kullanımdan kaldırma	Gün batımı
Tanım	Desteği sonlandırılan sürüm, en yeni sürüm olmayan bir sürümdür. Yeni bir sürüm yayınlandığında önceki tüm sürümler kullanımdan kaldı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 sonlandırma tarihinden sonra başarısız olur.
İmplikasyon	Kullanımdan kaldırılan sürümleri kullanımdan kaldırılana kadar kullanmaya devam edebilirsiniz. Ancak, artık en son sürüm olmadıklarını göstermek için, kullanımdan kaldırılan sürümlerin referanslarının vurgusu kaldırılır. Yeni özelliklerden yararlanmak için en kısa sürede en son sürüme yükseltmenizi ö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 son sürüme yükseltmenizi şiddetle tavsiye ederiz.
Zamanlama	Ortalama olarak 3-4 ayda bir yeni sürüm yayınlarız. Bu nedenle, belirtilen sürüm yaklaşık 3-4 ay sonra kullanımdan kaldırılır.	Sürümleri yayınlandıktan 1 yıl sonra kullanımdan kaldırmayı hedefliyoruz.
API	Kullanımdan kaldı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.	Kullanımdan kaldırılan sürümlerin API uç noktaları, kullanımdan kaldırma tarihlerinden sonra çalışmayı durdurur. Kullanımdan kaldı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 istemci kitaplığı sürümüne dahil etmeyi bırakacağız. Bu sayede, istemci kitaplıklarımızı projelerinize dahil ederken yerden tasarruf edebilirsiniz.	İstemci kitaplıkları, sonlandırma tarihlerinden sonraki yeni istemci kitaplığı sürümlerinde, sonlandırılan API sürümlerini 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 büyük sürümleri (ör. v24) için yeterlidir. Küçük sürümler için gerekli istemci kitaplığı sürümünü görmek istiyorsanız bağlantılı değişiklik günlüğüne bakın.

Kullanımdan kaldırılan ve değiştirilen özellikler

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 içermeyen iş akışı değişiklikleri (ör. yeni talep yaratma kampanyası bütçe koşulları) ayrı ayrı izlenir.

Yaklaşan özellik yaşam döngülerini ve etkin sürümlerdeki davranış değişikliklerini kontrol etmek için Özellik kullanımdan kaldırma ve sürüm oluşturulmamış değişiklikler rehberine bakın.