Google Ads API, her zaman birden fazla etkin ana sürümü destekler ve bir sürüm yalnızca açıkça "desteği sonlandırıldı" olarak işaretlenmişse desteği sonlandırılmış olarak kabul edilir. Yükseltmeleri planlamanıza yardımcı olmak için yayın ve kullanımdan kaldırma tarihlerini önceden yayınlarız. Bir sürümün desteği sonlandırıldıktan sonra o sürüm artık kullanılamaz. Sürüm oluşturma ile ilgili dikkat etmeniz gereken bazı önemli kurallar şunlardır:
- Herhangi bir zamanda en fazla beş ana sürümü kullanılabilir durumda tutmaya çalışıyoruz.
- Ana sürümlerin kullanım ömrü yaklaşık 12 aydır. Küçük API sürümlerinin kullanım ömrü ayrı olarak izlenmez. Bunun yerine, alt sürümler, karşılık gelen ana sürümle aynı kullanımdan kaldırılma tarihini paylaşır.
- Her alt sürüm, karşılık gelen ana sürümü kademeli olarak günceller.
- Belirli bir ana sürüme yapılan tüm API çağrıları her zaman ilgili en son alt sürüme gider. Google Ads API, belirli alt sürümlerin çağrılmasını desteklemez.
- 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.
- Google Ads API'yi kullanmaya yeni başladıysanız 26. sürümle başlamanızı öneririz.
İ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ün yayınlanma ve kullanımdan kaldırılma tarihleri ile gelecekteki sürümlerin tahmini yayınlanma 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 | 23 sürümündeki zarar veren değişiklikler (yükseltme kılavuzu) | 23. sürüm özellikleri ve güncellemeleri | 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ümdeki özellikler ve güncellemeler | v25 ve v26 proto farkları |
| v26.1 | 28 Ekim 2026 | Kasım 2027 | Yok (küçük sürüm) | 26.1 sürümündeki özellikler ve güncellemeler | v25 ve v26 proto farkları |
| v26.2 | 11 Kasım 2026 | Kasım 2027 | Yok (küçük sürüm) | 26.2 sürümündeki özellikler ve güncellemeler | v25 ve v26 proto farkları |
| Gelecek sürümler | |||||
| 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 son zamanlarda ç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 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 (ör.
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 | Bir sürüm, yalnızca açıkça desteği sonlandırıldı olarak işaretlenmişse desteği sonlandırılmış kabul edilir. Google Ads API'nin her zaman birden fazla etkin ana sürümü vardır. | 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. |
| Çıkarım | 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 yükseltmenizi ö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 | Kullanımdan kaldırma tarihleri önceden yayınlanır ve bir sürüm yalnızca açıkça "desteği sonlandırıldı" olarak işaretlenmişse desteği sonlandırılmış olarak kabul edilir. | 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. |
Sonlandırılan sürümlerin API uç noktaları, sonlandırma tarihlerinden 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 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 | Desteği sonlandırılan sürümler için düzenli destek sağlıyoruz. | 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 takip edilir.
Etkin sürümlerdeki yaklaşan özellik yaşam döngülerini ve davranış değişikliklerini kontrol etmek için Özellik desteğinin sonlandırılması ve sürüme bağlı olmayan değişiklikler kılavuzuna bakın.