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.
• Ana sürümlerin kullanım ömrü 12 ay kadardır. 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 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	Gün batımı 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ümden 17. sürüme 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

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 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ı) İsteklerinizde 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	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ı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 kullanımdan kaldırılan sürümlerden hemen yeni sürüme geçmeniz 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	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'i vb. kullanarak 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ış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ı sağlamak 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, Google Ads API için şu anda planlanan desteğin sonlandırılması süreci listelenmektedir. Kullanımdan kaldırma ile ilgili daha fazla ayrıntıyı bağlantılı 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.	Ocak 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 teklif 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 tarihine kadar yayınlanmaya devam edecek. Bu tarihten sonra, bu kampanyalar otomatik olarak manuel tıklama başına maliyet (TBM) stratejisine geçirilecek.