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:
- Google Cloud Console'da API'ler ve Hizmetler'i açın.
- Tabloda Google Ads API'yi tıklayın.
- 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. - (İ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
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ığı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
Google Ads API |
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#
Google Ads API |
.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
Google Ads API |
PHP için istemci kitaplığı |
v16 |
Min: 22.1.0 Max: |
v15 |
Min: 21.1.0 Max: |
Python
Google Ads API |
Python için istemci kitaplığı |
v16 |
Min: 23.1.0 Max: |
v15 |
Min: 22.1.0 Max: |
Ruby
Google Ads API |
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
Google Ads API |
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.
|