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 tarihi | Kullanımdan kaldırma tarihi | Yükseltme kılavuzu |
|---|---|---|---|
| Yayınlanan sürümler | |||
| v22 | 15 Ekim 2025 | Ekim 2026 | 21. sürümden 22. sürüme yükseltme |
| v23 | 28 Ocak 2026 | Şubat 2027 | v22'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:
- 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ünü, hizmeti ve yöntem adını (ör.
google.ads.googleads.v25.services.GoogleAdsService.Mutate) içerir. - (İ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ü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
Google Ads API |
Java için istemci kitaplığı |
v25 |
Min: 44.0.0Max: - |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
C#
Google Ads API |
.NET için istemci kitaplığı |
v25 |
Min: 26.1.0Max: - |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
PHP
Google Ads API |
PHP için istemci kitaplığı |
v25 |
Min: 33.6.0Max: - |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
Python
Google Ads API |
Python için istemci kitaplığı |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
Ruby
Google Ads API |
Ruby için istemci kitaplığı |
v25 |
Min: 43.0.0Max: - |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
Perl
Google Ads API |
Perl için istemci kitaplığı |
v25 |
Min: 33.0.0Max: - |
v24 |
Min: 32.0.0Max: - |
v23 |
Min: 31.0.0Max: - |
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.