Yeni bir sürüm yayınlandığında, desteği sonlandırılan sürüme bir sonlandırma tarihi verilir. Bu tarihten sonra söz konusu 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 yükseltmenizi öneririz.
| API sürümü | Yayın tarihi | Kullanımdan kaldırılma tarihi | Kullanımdan kaldırma tarihi | Yükseltme kılavuzu |
|---|---|---|---|---|
| v19 | 26 Şubat 2025 | 18 sürümünden 19 sürümüne yükseltme | ||
| v18 | 16 Ekim 2024 | Haziran 2025 | Eylül 2025 | 17 sürümünden 18 sürümüne yükseltme |
| 17.1 | 7 Ağustos 2024 | 16 Ekim 2024 | 4 Haziran 2025 | |
| v17 | 5 Haziran 2024 | 16 Ekim 2024 | 4 Haziran 2025 |
Projenizin kullandığı sürümleri görüntüleme
Projenizin son ç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, her grafikte son isteklerinizin 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.v19.services.GoogleAdsService.Mutategibi bir yöntem adını içerir. - (İ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 | 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 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 alan tasarrufu yapmanıza 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.
Google Ads API |
Java için istemci kitaplığı |
v19 |
Min: 36.0.0Max: - |
v18 |
Min: 34.0.0Max: - |
v17 |
Min: 32.0.0Max: - |
Google Ads API |
.NET için istemci kitaplığı |
v19 |
Min: 22.1.0Max: - |
v18 |
Min: 21.1.0Max: - |
v17 |
Min: 20.1.0Max: - |
v16 |
Min: 18.1.0Max: 21.1.0 |
Google Ads API |
PHP için istemci kitaplığı |
v19 |
Min: 26.1.0Max: - |
v18 |
Min: 25.0.0Max: - |
v17 |
Min: 23.1.0Max: - |
Google Ads API |
Python için istemci kitaplığı |
v19 |
Min: 25.2.0Max: - |
v18 |
Min: 25.1.0Max: - |
v17 |
Min: 24.1.0Max: - |
v16 |
Min: 23.1.0Max: - |
Google Ads API |
Ruby için istemci kitaplığı |
v18 |
Min: 31.0.0Max: - |
v17 |
Min: 29.0.0Max: - |
v16 |
Min: 27.0.0Max: - |
Google Ads API |
Perl için istemci kitaplığı |
v19 |
Min: 26.0.0Max: - |
v18 |
Min: 25.0.1Max: - |
v17 |
Min: 23.0.0Max: - |
Ö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 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 |
|---|---|---|---|
| 3 Mart 2025'ten itibaren Google Ads API ve Google Ads komut dosyaları arama terimi analiz raporu güncellemesi | 3 Mart 2025'ten itibaren Google Ads API ve Google Ads komut dosyaları arama terimi analiz raporlarında tüm arama alt kategorilerini boş olarak döndürecek. Google Ads kullanıcı arayüzünde bu alan zaten kaldırıldı. API de Google Ads'de tutarlı olması için bu değişikliği kullanıma sunuyor. | 3 Mart 2025 | 3 Mart 2025'ten itibaren
segments.search_subcategory için tüm değerlerin boş olması beklenmektedir.
campaign_search_term_insight veya
customer_search_term_insight raporlarında segments.search_subcategory için sorgu gönderiyorsanız kodunuzun segments.search_subcategory'te boş bir değeri işleyip işleyemediğini kontrol edin.
Boş bir dize zaten her şeyi kapsar. Bu nedenle, kodunuz bu durumu zaten ele alıyor olmalıdır. Sorgunuzdan segments.search_subcategory değerini kaldırmanızı öneririz.
|
| 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ı ayarlayamayacaksı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. |
| Müşteri Eşleştirme üyeliği geçerlilik süresiyle ilgili güncelleme | 7 Nisan 2025'ten itibaren UserList.membership_life_span alanına 540'ten büyük değerler girilemeyecek. |
7 Nisan 2025 | 7 Nisan 2025 ile 15 Nisan 2025 arasında UserList.membership_life_span alanında kademeli olarak bir değişiklik yapacağız. Alanı 540'tan büyük bir değere ayarlama istekleri RangeError.TOO_HIGH hatası döndürür. Alan değeri 540'ten büyük olan mevcut kullanıcı listeleri, üyelik süresi en fazla 540 gün olacak şekilde otomatik olarak taşınır. Daha fazla bilgi için Müşteri Eşleştirme üyeliği süresinin sona ermesiyle ilgili güncelleme başlıklı makaleyi inceleyin.
|