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 | 16 Ekim 2024 | 4 Haziran 2025 | 17 sürümünden 18 sürümüne yükseltme |
| v17 | 5 Haziran 2024 | 16 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:
- Google Cloud Console'da API'ler ve Hizmetler'i açın.
- Tabloda Google Ads API'yi tıklayın.
- 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.Mutategibi bir yöntem adını içerir. - (İ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.
Java
Google Ads API |
Java için istemci kitaplığı |
v18 |
Min: 34.0.0Max: - |
v17 |
Min: 32.0.0Max: - |
v16 |
Min: 30.0.0Max: - |
C#
Google Ads API |
.NET için istemci kitaplığı |
v18 |
Min: 21.1.0Max: - |
v17 |
Min: 20.1.0Max: - |
v16 |
Min: 18.1.0Max: - |
PHP
Google Ads API |
PHP için istemci kitaplığı |
v18 |
Min: 25.0.0Max: - |
v17 |
Min: 23.1.0Max: - |
v16 |
Min: 22.1.0Max: - |
Python
Google Ads API |
Python için istemci kitaplığı |
v18 |
Min: 25.1.0Max: - |
v17 |
Min: 24.1.0Max: - |
v16 |
Min: 23.1.0Max: - |
Ruby
Google Ads API |
Ruby için istemci kitaplığı |
v18 |
Min: 31.0.0Max: - |
v17 |
Min: 29.0.0Max: - |
v16 |
Min: 27.0.0Max: - |
Perl
Google Ads API |
Perl için istemci kitaplığı |
v18 |
Min: 25.0.0Max: - |
v17 |
Min: 23.0.0Max: - |
v16 |
Min: 21.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 |
|---|---|---|---|
| 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.
|