Kullanımdan kaldırma ve sonlandırma

Yeni bir sürümün yayınlanmasıyla birlikte, desteği sonlandırılan bir sürüme kullanımdan kaldırılma tarihi verilir. Bu tarihten sonra bu sürüm artık kullanılamayacaktır. Unutulmaması gereken diğer yönergelerden bazıları şunlardır:

  • Aynı anda en fazla üç ana sürüm kullanılabilir.
  • Ana sürümlerin kullanım ömrü yaklaşık 12 ay, küçük sürümler ise 10 aydır.
  • Yılda en fazla iki yükseltme yapmanız gerekir. Ayrıca, yükseltme işlemini katı bir sırayla yapmanız gerekmez. Örneğin, doğrudan (N) sürümünden (N+2) yükseltme yapabilirsiniz.
  • Tüm istemci kitaplıklarının en son sürüm için kullanıma sunulduğu tarih ile kullanımdan kaldırılacak sürümün tarihi 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, mevcut her sürüm için desteği sonlandırma ve kullanımdan kaldırma tarihlerinin yanı sıra gelecekteki sürümler için öngörülen yayın tarihleri listelenmiştir. Lansmandan sonra mümkün olan en kısa sürede en son sürüme yükseltme yapmanızı öneririz.

API sürümü Yayın tarihi Kullanımdan kaldırma tarihi Gün batımı tarihi Yükseltme kılavuzu
v18 Eylül/Ekim 2024 Ocak/Şubat 2025 Eylül 2025
v17.1 Tem/Ağustos 2024 Eylül/Ekim 2024 Mayıs 2025
v17 Mayıs/Haziran 2024 Eylül/Ekim 2024 Mayıs 2025
v16.1 24 Nisan 2024 Mayıs/Haziran 2024 Ocak 2025
v16 21 Şubat 2024 Mayıs/Haziran 2024 Ocak 2025
v15 18 Ekim 2023 21 Şubat 2024 25 Eylül 2024 15. sürümden 16. sürüme yükseltme
v14.1 9 Ağustos 2023 18 Ekim 2023 5 Haziran 2024
v14 7 Haziran 2023 18 Ekim 2023 5 Haziran 2024 14. sürümden 15. sürüme yükseltme

Projenizin kullandığı sürümleri görüntüleme

Google Cloud Console'u kullanarak projenizin yakın zamanda çağırdığı yöntem ve hizmetlerin listesini görebilirsiniz:

  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 isteklerinizi her bir grafikte gösterilmektedir. Hangi yöntemlere istek gönderdiğinizi Yöntemler tablosunda görebilirsiniz. Yöntem adı bir Google Ads API sürümü, bir hizmet ve google.ads.googleads.v17.services.GoogleAdsService.Mutate gibi bir yöntem adını içerir.
  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ılması arasındaki farklar

TerimKullanımdan KaldırmaGün batımı
Tanım Kullanımdan kaldı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. Kullanımdan kaldırılan sürüm artık kullanılamaz. Bu sürüme gönderilen istekler, kullanımdan kaldırılma tarihinde veya sonrasında başarısız olur.
Çıkarım Kullanımdan kaldırılmış sürümleri, kullanımdan kaldırılana kadar kullanmaya devam edebilirsiniz. Ancak kullanımdan kaldırılan sürümlerin referansları, artık bunların en yeni sürüm olmadıklarını göstermek için vurgulanı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 kullanımdan kaldırılan sürümlerden hemen yeni sürüme geçmeniz gerekir.

Yeni sürüme geçme kılavuzunu kullanarak en yeni sürüme yükseltmenizi kesinlikle öneririz.

Zamanlama Ortalama olarak 3-4 ayda bir yeni bir sürüm yayınlarız. Bu nedenle, ilgili sürümün desteği yaklaşık 3-4 ay sonra iptal edilir. 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ı her zamanki gibi çalışmaya devam eder.

API uç noktalarımıza istemci kitaplıklarımızı, REST vb. kullanarak erişebilirsiniz. Ancak, kullanımdan kaldırılan sürümlere yeni özellikler eklenmez.

Kullanımdan kaldırılan sürümlere ait 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ı Küçük istemci kitaplıkları sağlamak amacıyla, kullanımdan kaldırma tarihinden sonra kullanımdan kaldırılan API sürümlerini yeni bir istemci kitaplığı sürümüne dahil etmeyi durduracağız. Böylece istemci kitaplıklarımızı projelerinize dahil ederken alandan tasarruf edebilirsiniz. İstemci kitaplıkları, kullanımdan kaldırılma tarihinden sonra hiçbir yeni istemci kitaplığı sürümünde kullanımdan kaldırılan API sürümlerini desteklemez.
Destek Kullanımdan kaldırılan sürümler için düzenli destek sağlıyoruz. Kullanımdan kaldırılan sürümler, kullanımdan kaldırma tarihinden sonra artık desteklenmez.

Desteklenen istemci kitaplığı sürümleri

Tablo, hangi istemci kitaplıklarının hangi API sürümleriyle çalıştığını gösterir.

Java

Java için istemci kitaplığı
v16 Min: 30.0.0
Max:
v15 Min: 28.0.0
Max:
v14 Min: 26.0.0
Max: 30.0.0

C#

.NET için istemci kitaplığı
v16 Min: 18.1.0
Max:
v15 Min: 17.1.0
Max:
v14 Min: 16.1.0
Max: 19.0.1

PHP

PHP için istemci kitaplığı
v16 Min: 22.1.0
Max:
v15 Min: 21.1.0
Max:

Python

Python için istemci kitaplığı
v16 Min: 23.1.0
Max:
v15 Min: 22.1.0
Max:

Ruby

Ruby için istemci kitaplığı
v16 Min: 27.0.0
Max:
v15 Min: 25.0.0
Max:
v14 Min: 23.0.0
Max: 27.0.0

Perl

Perl için istemci kitaplığı
v16 Min: 21.0.0
Max:
v15 Min: 19.0.0
Max:
v14 Min: 17.0.0
Max: 21.0.0

Kullanımdan kaldırılan özellikler

Yakında kullanımdan kaldırılacak özellikleri ilk öğrenen siz olmak için Google Ads geliştirici blogunu düzenli olarak izleyin.

Aşağıdaki tabloda, Google Ads API için şu anda desteği sonlandırılan belirli özellikler listelenmektedir. Desteğin sonlandırılmasıyla ilgili daha fazla bilgiyi bağlantılı blog yayınlarında bulabilirsiniz.

Öne Çıkarın Açıklama Geçerlilik tarihi Ek notlar
Komisyon Teklif Stratejisi Google Ads API artık COMMISSION teklif stratejisiyle otel kampanyalarının oluşturulmasını desteklememektedir . 30 Nisan 2024 Yeni otel kampanyaları oluşturma veya COMMISSION teklif stratejisini mevcut kampanyalara uygulama istekleri, BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED hatasına neden olur. COMMISSION teklif stratejisine sahip mevcut kampanyalar 31 Ekim 2024 tarihine kadar yayınlanmaya devam edecek. Bu günden sonra, kampanyaların teklif stratejileri güncellenene kadar reklam yayını durdurulur.