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 kurallardan bazıları 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, mevcut her sürüm için belirli desteği sonlandırma ve kullanımdan kaldırma tarihleri ile gelecekteki sürümler için öngörülen yayın tarihleri listelenmiştir. 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 | Zarar veren değişiklikler ve yükseltme | Özellikler ve güncellemeler | Proto fark tablosu |
|---|---|---|---|---|---|
| Yayınlanan sürümler | |||||
| v23 | 28 Ocak 2026 | Şubat 2027 | Sürüm 23'teki zarar veren değişiklikler (yükseltme kılavuzu) | 23. sürümdeki özellikler ve güncellemeler | v22 ile v23 proto farkları |
| v23.1 | 25 Şubat 2026 | Şubat 2027 | Yok (küçük sürüm) | 23.1 sürümündeki özellikler ve güncellemeler | v22 ile v23 proto farkları |
| v23.2 | 25 Mart 2026 | Şubat 2027 | Yok (küçük sürüm) | 23.2 sürümündeki özellikler ve güncellemeler | v22 ile v23 proto farkları |
| v23.3 | 24 Haziran 2026 | Şubat 2027 | Yok (küçük sürüm) | 23.3 sürümündeki özellikler ve güncellemeler | v22 ile v23 proto farkları |
| v24 | 22 Nisan 2026 | Mayıs 2027 | 24. sürümdeki zarar veren değişiklikler (yükseltme kılavuzu) | 24. sürümdeki özellikler ve güncellemeler | v23 ile v24 proto farkları |
| v24.1 | 13 Mayıs 2026 | Mayıs 2027 | Yok (küçük sürüm) | 24.1 sürümündeki özellikler ve güncellemeler | v23 ile v24 proto farkları |
| v24.2 | 24 Haziran 2026 | Haziran 2027 | Yok (küçük sürüm) | 24.2 sürümündeki özellikler ve güncellemeler | v23 ile v24 proto farkları |
| v25 | 22 Temmuz 2026 | Ağustos 2027 | Sürüm 25'teki zarar veren değişiklikler (yükseltme kılavuzu) | 25. sürümdeki özellikler ve güncellemeler | v24 ve v25 proto farkları |
| v25.1 | 19 Ağustos 2026 | Ağustos 2027 | Yok (küçük sürüm) | 25.1 sürümündeki özellikler ve güncellemeler | v24 ve v25 proto farkları |
| v25.2 | 23 Eylül 2026 | Ağustos 2027 | Yok (küçük sürüm) | 25.2 sürümündeki özellikler ve güncellemeler | v24 ve v25 proto farkları |
| v26 (En yeni) | 14 Ekim 2026 | Kasım 2027 | 26. sürümdeki zarar veren değişiklikler (yükseltme kılavuzu) | 26. sürüm özellikleri ve güncellemeleri | v25 ve v26 proto farkları |
| 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 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
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ünü, hizmeti ve yöntem adını (ör.
google.ads.googleads.v26.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 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. | Desteği 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ı | Desteği sonlandırılan sürümleri kullanımdan kaldırılana kadar kullanmaya devam edebilirsiniz ancak desteği sonlandı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 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ı 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 bir istemci kitaplığı sürümüne dahil etmeyeceğiz. Bu sayede, istemci kitaplıklarımızı projelerinize dahil ederken yerden tasarruf edebilirsiniz. | İ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 | 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: - |
Desteği sonlandırılan özellikler ve değişiklikler
Bu sayfada API sürümü düzeyindeki yaşam döngüleri ele alınsa da, tek tek özelliklerin desteğinin sonlandırılması (ör. akıllı kampanyaların desteğinin sonlandırılması) ve sürüme bağlı olmayan iş akışı değişiklikleri (ör. yeni Talep Yaratma kampanyası bütçe şartları) ayrı olarak izlenir.
Etkin sürümlerdeki yaklaşan özellik yaşam döngülerini ve davranış değişikliklerini kontrol etmek için Özelliklerin desteğinin sonlandırılması ve sürüme bağlı olmayan değişiklikler kılavuzuna bakın.