Kullanımdan kaldırma ve sonlandırma

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 kullanılamaz. Unutulmaması gereken diğer kurallardan bazıları şunlardır:

• Aynı anda en fazla üç ana sürüm kullanılabilir.
• Büyük sürümlerin kullanım ömrü yaklaşık 12 ay, küçük sürümlerin kullanım ömrü ise 10 aydır.
• En fazla yılda iki yükseltme yapmanız gerekir. Yükseltme işlemini kesinlikle sıralı olarak yapmanız gerekmez. Örneğin, (N) sürümünden doğrudan (N+2) sürümüne yükseltme yapabilirsiniz.
• Tüm istemci kitaplıklarının en son sürüm için yayınlandığı tarih ile kullanımdan kaldırılacak sürüm arasında en az 20 haftalık bir çakışma olmalıdı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ün desteğinin sonlandırılacağı ve kullanımdan kaldırılacağı tarihler ile gelecekteki sürümlerin tahmini yayınlanma tarihleri listelenmiştir. En son sürümü, yayınlandıktan sonra mümkün olan en kısa sürede kullanmaya başlamanızı öneririz.

API sürümü	Yayın tarihi	Kullanımdan kaldırılma tarihi	Kullanımdan kaldırma tarihi	Yükseltme kılavuzu
v18	16 Ekim 2024	Şubat 2025	24 Eylül 2025
v17.1	7 Ağustos 2024	Eylül/Ekim 2024	4 Haziran 2025	17 sürümünden 18 sürümüne yükseltme
v17	5 Haziran 2024	Eylül/Ekim 2024	4 Haziran 2025	17 sürümünden 18 sürümüne yükseltme
v16.1	24 Nisan 2024	5 Haziran 2024	5 Şubat 2025	16 sürümünden 17 sürümüne yükseltme
v16	21 Şubat 2024	5 Haziran 2024	5 Şubat 2025	16 sürümünden 17 sürümüne yükseltme

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. METRICS alt sekmesinde, son isteklerinizin her grafikte noktayla gösterildiğini görürsünüz. 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.v18.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.

Destek sonu 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 bir sürümdür. Yeni bir sürüm yayınlandıktan sonra ö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 sonrasında başarısız olur.
Anlam	Desteği sonlandırılan sürümleri, desteği sonlandırılana kadar kullanmaya devam edebilirsiniz. Ancak desteği sonlandırılan sürümlerin artık en son sürüm olmadığını göstermek için bu sürümlere yapılan referansların vurgusu kaldırılır. Yeni özelliklerden yararlanmak için en kısa sürede en son sürüme geçmenizi ö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 geçmenizi önemle tavsiye ederiz.
Zamanlama	Ortalama olarak 3-4 ayda bir yeni sürüm yayınlarız. Bu nedenle, söz konusu sürümün desteği yaklaşık 3-4 ay sonra sonlandırılır.	Bir sürümü, kullanıma sunulduktan 1 yıl sonra sonlandırmayı hedefliyoruz.
API	Desteği sonlandırılan sürümlerin API uç noktaları normal şekilde çalışmaya devam etmektedir. API uç noktalarımıza istemci kitaplıklarımızı, REST'i vb. kullanarak erişebilirsiniz. Bununla birlikte, 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ışmaya son verir. 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ı sunmak amacıyla, desteği sonlandırılan API sürümlerini desteği sonlandırılma tarihinden sonra yeni bir istemci kitaplığı sürümüne eklemeyi durduracağız. Bu, istemci kitaplıklarımızı projelerinize dahil ederken alandan tasarruf etmenize yardımcı olur.	İstemci kitaplıkları, sonlandırma tarihinden sonra yayınlanan 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ğlarız.	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.

Özellik kullanımdan kaldırma işlemleri

Önümüzdeki dönemde kullanımdan kaldırılacak özelliklerle ilgili ilk haberi almak için Google Ads geliştirici blogunu düzenli olarak takip edin.

Aşağıdaki tabloda, şu anda Google Ads API için planlanan belirli özelliklerin desteğinin sonlandırılması listelenmiştir. 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
Google Ads API'de sayfa boyutunda yapılacak değişiklikler	16 sürümü kullanımdan kaldırıldığında, GoogleAdsService.Search isteklerinde bulunarak page_size alanını ayarlayamazsınız.	Şubat 2025	16 sürümü kullanımdan kaldırıldığında tüm GoogleAdsService.Search isteklerinde 10.000 satırlık sabit bir sayfa boyutu kullanılacak.
Geliştirilmiş TBM teklifi stratejisi	Google Ads API, artık Arama Ağı ve Görüntülü Reklam Ağı kampanyaları için GTBM'yi teklif stratejisi olarak ayarlamayı desteklemiyor.	Ekim 2024	Teklif stratejisinde enhanced_cpc_enabled alanına TRUE değerini ayarlama istekleri BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED hatasıyla sonuçlanır. GTBM teklif stratejisinin kullanıldığı mevcut kampanyalar 15 Mart 2025'e kadar yayınlanmaya devam edecek. Bu tarihten sonra, bu kampanyalar otomatik olarak manuel tıklama başına maliyet (TBM) stratejisine geçirilecek.