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 dört ana sürümün kullanılabilir olmasını sağlamaya çalışıyoruz.
- 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, (N) sürümünden doğrudan (N+2) sürümüne yükseltebilirsiniz.
- Tüm istemci kitaplıklarının en yeni sürüm için yayınlandığı tarih ile desteği sonlandırılacak sürüm arasındaki çakışma en az 20 haftadır.
İstemci kitaplıklarımız, bir hizmetin 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, kullanımdan kaldırılma ve kullanımdan kalkma 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 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 | |||
| v20 | 4 Haziran 2025 | Haziran 2026 (tahmini) | v19'dan v20'ye yükseltme |
| v20.1 | 6 Ağustos 2025 | Haziran 2026 (tahmini) | v19'dan v20'ye yükseltme |
| 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 |
| Gelecek sürümler | |||
| v23.1 | 25 Şubat 2026 | Şubat 2027 | v23'ten v23.1'e yükseltme |
| v23.2 | 25 Mart 2026 | Şubat 2027 | 23.1 sürümünden 23.2 sürümüne yükseltme |
| v24 | Nisan 2026 | Mayıs 2027 | |
| v24.1 | Mayıs 2026 | Mayıs 2027 | |
| v24.2 | Haziran 2026 | Mayıs 2027 | |
| 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, yıl sonuyla çakıştığı için isteğe bağlı bir 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:
- 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 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ü, hizmet ve yöntem adını (ör.
google.ads.googleads.v23.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ılmış sürüm, en son sürüm değildir. Yeni bir sürüm yayınlandığında önceki tüm sürümler desteği sonlandırılmış 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 (Implication) | 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 son sürüme yükseltmenizi öneririz. |
Google Ads API'yi kullanmak için kullanımdan kaldı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ınladığımız için belirtilen sürümün desteği yaklaşık 3-4 ay sonra sonlandırılır. | Bir sürümü yayınlandıktan 1 yıl sonra kullanımdan kaldırmayı hedefliyoruz. |
| API | Kullanımdan kaldırılan sürümlerin API uç noktaları normal şekilde çalışmaya devam eder.
İstemci kitaplıklarımızı, REST'i vb. 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. Google Ads API, kullanımdan kaldırılan sürümlerin API uç noktalarına erişmeye çalıştığınızda 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, 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.
Java
Google Ads API |
Java için istemci kitaplığı |
v23 |
Min: 42.1.0Max: - |
v22 |
Min: 41.1.0Max: - |
v21 |
Min: 39.0.0Max: - |
v20 |
Min: 38.0.0Max: - |
C#
Google Ads API |
.NET için istemci kitaplığı |
v23 |
Min: 25.1.0Max: - |
v22 |
Min: 24.1.0Max: - |
v21 |
Min: 24.0.0Max: - |
v20 |
Min: 23.0.0Max: - |
PHP
Google Ads API |
PHP için istemci kitaplığı |
v23 |
Min: 32.2.0Max: - |
v22 |
Min: 31.0.0Max: - |
v21 |
Min: 28.0.0Max: - |
v20 |
Min: 26.1.0Max: - |
Python
Google Ads API |
Python için istemci kitaplığı |
v23 |
Min: 29.2.0Max: - |
v22 |
Min: 28.1.0Max: - |
v21 |
Min: 28.0.0Max: - |
v20 |
Min: 27.0.0Max: - |
Ruby
Google Ads API |
Ruby için istemci kitaplığı |
v23 |
Min: 38.0.0Max: - |
v22 |
Min: 36.0.0Max: - |
v21 |
Min: 35.0.0Max: - |
v20 |
Min: 34.0.0Max: - |
Perl
Google Ads API |
Perl için istemci kitaplığı |
v23 |
Min: 31.0.0Max: - |
v22 |
Min: 29.0.0Max: - |
v21 |
Min: 28.0.0Max: - |
v20 |
Min: 27.0.0Max: - |
Özellik kullanımdan kaldırma işlemleri
Kullanımdan kaldırılacak özelliklerden ilk haberdar olmak için Google Ads geliştirici blogunu düzenli olarak takip edin.
Aşağıdaki tabloda, Google Ads API'de kullanımdan kaldırılması planlanan belirli özellikler listelenmektedir. Her desteğin sonlandırılmasıyla ilgili daha fazla bilgiyi bağlantısı verilen blog yayınlarında bulabilirsiniz.
| Özellik | Açıklama | Geçerlilik tarihi | Ek notlar |
|---|---|---|---|
| Müşteri Eşleştirme desteğinde yapılan değişiklikler |
1 Nisan 2026'dan itibaren, son zamanlarda Müşteri Eşleştirme isteği bulunmayan geliştirici jetonları, Müşteri Eşleştirme iş akışlarında Data Manager API'yi kullanmalıdır.
|
1 Nisan 2026 | Daha fazla bilgi için blog yayınımızı inceleyin. |
| IP adresi ve oturum özelliği desteğinde yapılan değişiklikler | Google Ads API, 2 Şubat 2026'dan itibaren dönüşüm içe aktarma işlemlerinin bir parçası olarak oturum özellikleri veya IP adresi verilerini kullanmaya başlamak isteyen yeni kullanıcıları kabul etmeyecek. Mevcut kullanıcılar Data Manager API'ye geçmelidir. | 2 Şubat 2026 | Daha fazla bilgi için blog yayınımızı inceleyin. |
| Yalnızca telefon araması üreten reklamların desteğinin sonlandırılması | Ocak 2026'dan itibaren yeni yalnızca telefon araması üreten reklamlar oluşturulamaz. Mevcut yalnızca telefon araması üreten reklamların yayını Şubat 2027'de durdurulacak ve API desteği kaldırılacak. Reklamverenler bunun yerine telefon öğeleri içeren duyarlı arama ağı reklamlarını kullanmalıdır. | Ocak 2026 | Daha fazla bilgi için blog yayınımızı inceleyin. |