Kullanımdan kaldırma ve kullanımdan kaldırma

Yeni bir sürümün yayınlanmasıyla birlikte, desteği sonlandırılan sürümler için bir 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, doğrudan (N) sürümünden (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. Böylece, 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 hatırlatıcı duyurular için bloga abone olun.

API sürümüÇıkış tarihiDesteği sonlandırma tarihiKullanımdan kaldırma tarihiYükseltme kılavuzu
v216 Ağustos 2025v20'den v21'e yükseltme
v20.16 Ağustos 2025Haziran 2026 (tahmini)v19'dan v20'ye yükseltme
v204 Haziran 2025Haziran 2026 (tahmini)v19'dan v20'ye yükseltme
v19.26 Ağustos 2025 Şubat 2026 (tahmini)v18'den v19'a yükseltme
v19.116 Nisan 2025 Şubat 2026 (tahmini)v18'den v19'a yükseltme
v1926 Şubat 2025 Şubat 2026 (tahmini)v18'den v19'a yükseltme
v1816 Ekim 2024Haziran 202520 Ağustos 2025

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:

  1. Google Cloud Console'da API'ler ve Hizmetler'i açın.
  2. Tabloda Google Ads API'yi tıklayın.
  3. 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ı içerir (ör. google.ads.googleads.v21.services.GoogleAdsService.Mutate).
  4. (İsteğe bağlı) İstekleriniz için görüntülemek istediğiniz zaman aralığını seçin.

Desteğin sonlandırılması ve kullanımdan kaldırılma arasındaki farklar

TerimKullanımdan KaldırmaGü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 kullanımdan kaldı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 sonlandırma tarihinden sonra başarısız olur.
İmplikasyon (İma) Kullanımdan kaldırılan sürümleri kullanımdan kaldırılana kadar kullanmaya devam edebilirsiniz. Ancak, artık en son sürüm olmadıklarını göstermek için, kullanımdan kaldırılan sürümlerin referanslarının vurgusu kaldırılır.

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 desteği sonlandı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ınlarız. Bu nedenle, belirtilen 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 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, kullanımdan kaldı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. Kullanımdan kaldı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 etmeyeceğiz. 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 Kullanımdan kaldı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

Java için istemci kitaplığı
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: -
v19 Min: 36.0.0
Max: -

C#

.NET için istemci kitaplığı
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -
v19 Min: 22.1.0
Max: -
v18 Min: 21.1.0
Max: 23.0.0

PHP

PHP için istemci kitaplığı
v21 Min: 31.0.0
Max: -
v20 Min: 28.0.0
Max: -
v19 Min: 26.1.0
Max: -
v18 Min: 25.0.0
Max: 30.0.0

Python

Python için istemci kitaplığı
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 25.2.0
Max: -

Ruby

Ruby için istemci kitaplığı
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -
v19 Min: 32.0.0
Max: -
v18 Min: 31.0.0
Max: -

Perl

Perl için istemci kitaplığı
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 26.0.0
Max: -
v18 Min: 25.0.1
Max: 28.0.0

Ö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 listelenmiştir. Her kullanımdan kaldırma işlemiyle ilgili daha fazla bilgiyi bağlantısı verilen blog yayınlarında bulabilirsiniz.

Özellik Açıklama Geçerlilik tarihi Ek notlar
Uygulama kampanyası performansını etkileyen dönüşüm ortamı 30 Eylül 2025'ten itibaren, teklif verme modellerinde kademeli olarak bir değişiklik yapmaya başlayacağız. Bu değişiklik, teklif verme modellerinin kampanya performansını optimize etmek için içe aktarılan dönüşümlere dahil edilen dönüşüm ortamı verilerini kullanmasını sağlayacak. 3 Ekim 2025 Daha fazla bilgi için blog yayınımızı inceleyin.
Dönüşümler hem "gclid" hem de "gbraid" değerlerini içerebilir. 3 Ekim 2025'ten itibaren, hem "gclid" hem de "gbraid" alanları ayarlanmışsa içe aktarılan dönüşümler artık "VALUE_MUST_BE_UNSET" hatası döndürmeyecek. 3 Ekim 2025 Daha fazla bilgi için blog yayınımızı inceleyin.