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. 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 durumda olmasını sağlamaya çalışıyoruz.
- 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 tam olarak sıralı bir şekilde yapmanız gerekmez. Örneğin, (N) sürümünden doğrudan (N+2) sürümüne yükseltebilirsiniz.
İstemci kitaplıklarımız bir hizmetin mevcut tüm sürümlerini destekler. Bu sayede, 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 mümkün olan en kısa sürede en yeni sürüme yükseltmenizi öneririz. Geçici tarih, desteğin sonlandırılmasının o 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 hatırlatıcılar için bloga abone olun.
| API sürümü | Yayın tarihi | Kullanımdan kaldırma tarihi | Yükseltme kılavuzu |
|---|---|---|---|
| Yayınlanan sürümler | |||
| v23 | 28 Ocak 2026 | Şubat 2027 | 22. sürümden 23. sürüme 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 | 23.1 sürümünden 23.2 sürümüne 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 |
| v26 | 14 Ekim 2026 | Kasım 2027 | v25.2'den v26'ya yükseltme |
| Gelecek sürümler | |||
| 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 tatil sezonuyla çakıştığı için isteğe bağlı sürümler olarak belirlenmiştir.
Projenizin kullandığı sürümleri görüntüleme
Google Cloud Console'u kullanarak projenizin yakın zamanda çağırdığı yöntemlerin ve hizmetlerin listesini görüntüleyebilirsiniz:
- Google Cloud Console'da API'ler ve Hizmetler'i açın.
- Tabloda Google Ads API'yi tıklayın.
- 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ü, hizmet ve yöntem adını içerir. Örneğin,
google.ads.googleads.v26.services.GoogleAdsService.Mutate. - (İ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 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ümleri hemen yükseltmeniz gerekir.
Yükseltme kılavuzunu kullanarak en son sürüme yükseltmenizi şiddetle tavsiye ederiz. |
| 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ı hedefliyoruz. |
| API | Desteği sonlandırılan sürümlerin API uç noktaları normal şekilde ç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 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ı, sonlandırma tarihlerinden sonraki yeni istemci kitaplığı sürümlerinde sonlandırılan API sürümlerini artık desteklemez. |
| Destek | Desteği sonlandırılan sürümler için düzenli destek sunuyoruz. | 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ü, ana Google Ads API sürümü (ör. v26) için yeterlidir. Alt sürümler için gereken istemci kitaplığı sürümünü görmek üzere bağlantılı Değişiklik günlüğüne bakın.
Java
Google Ads API |
Java için istemci kitaplığı |
v26 |
Min: 48.0.0Max: - |
v25 |
Min: 44.0.0Max: - |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
C#
Google Ads API |
.NET için istemci kitaplığı |
v26 |
Min: 27.5.0Max: - |
v25 |
Min: 26.1.0Max: - |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
PHP
Google Ads API |
PHP için istemci kitaplığı |
v26 |
Min: 35.2.0Max: - |
v25 |
Min: 33.6.0Max: - |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
Python
Google Ads API |
Python için istemci kitaplığı |
v26 |
Min: 34.0.0Max: - |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
Ruby
Google Ads API |
Ruby için istemci kitaplığı |
v26 |
Min: 46.0.0Max: - |
v25 |
Min: 43.0.0Max: - |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
Perl
Google Ads API |
Perl için istemci kitaplığı |
v26 |
Min: 36.0.0Max: - |
v25 |
Min: 33.0.0Max: - |
v24 |
Min: 32.0.0Max: - |
v23 |
Min: 31.0.0Max: - |
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 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.