Yeni bir sürüm yayınlandığında, kullanımdan kaldırılan bir sürüme kullanımdan kaldırılma tarihi verilir ve bu tarihten sonra bu sürüm artık kullanılamayacaktır. Unutulmaması gereken diğer bazı kurallar:
- Aynı anda en çok üç 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 ve katı sıralı bir sırayla yükseltmeniz gerekmez. Örneğin, (N) sürümünden (N+2) doğrudan sürüme 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ındaki çakışma en az 20 haftadır.
İstemci kitaplıklarımız bir hizmetin mevcut sürümlerini destekler. Bu sayede, kullanılan hizmetlerin farklı sürümlerini belirterek yükseltme işlemini kademeli olarak gerçekleştirebilirsiniz.
Zaman çizelgesi
Aşağıdaki tabloda, kullanılabilir her sürüm için spesifik kullanımdan kaldırma ve kullanımdan kaldırma tarihleri ile gelecek sürümler için öngörülen yayın tarihleri listelenmektedir. Bu sürüm yayınlandıktan sonra mümkün olan en kısa sürede en son sürüme geçmenizi öneririz.
| API sürümü | Yayın tarihi | Kullanımdan kaldırma tarihi | Son kullanma tarihi | Yükseltme kılavuzu |
|---|---|---|---|---|
| v18 | Eylül/Ekim 2024 | Ocak/Şubat 2025 | Eylül 2025 | |
| v17.1 | Tem/Ağu 2024 | Eylül/Ekim 2024 | Mayıs 2025 | |
| v17 | Mayıs/Haz 2024 | Eylül/Ekim 2024 | Mayıs 2025 | |
| v16.1 | Nis/Mayıs 2024 | Mayıs/Haz 2024 | Ocak 2025 | |
| v16 | 21 Şubat 2024 | Mayıs/Haz 2024 | Ocak 2025 | |
| v15 | 18 Ekim 2023 | 21 Şubat 2024 | 25 Eylül 2024 | v15'ten v16'ya yükseltme |
| v14.1 | 9 Ağustos 2023 | 18 Ekim 2023 | 5 Haziran 2024 | |
| v14 | 7 Haziran 2023 | 18 Ekim 2023 | 5 Haziran 2024 | v14'ten v15'e yükseltme |
Projenizin kullandığı sürümleri görüntüleyin
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 isteklerinizin her bir grafikte grafiğ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ünü, bir hizmeti ve
google.ads.googleads.v16.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.
Kullanımdan kaldırma ile 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ığı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, kullanımdan kaldırılma tarihinde veya bu tarihten sonra başarısız olacak. |
| Çıkarım | Kullanımdan kaldırılan sürümleri, kullanımdan kaldırılana kadar kullanmaya devam edebilirsiniz ancak kullanımdan kaldırılan sürümlerin referansları artık en son 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 gerekiyor.
Yeni sürüme geçiş kılavuzunu kullanarak en son sürüme yükseltmenizi kesinlikle öneririz. |
| Zamanlama | Ortalama olarak 3 ila 4 ayda bir yeni bir sürüm kullanıma sunuyoruz. Bu nedenle, belirtilen sürüm yaklaşık 3-4 ay sonra kullanımdan kaldırılacak. | 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.
İstemci kitaplıklarımızı, REST vb. kullanarak API uç noktalarımıza erişebilirsiniz ancak kullanımdan kaldırılan sürümlere yeni özellikler eklenmez. |
Kullanımdan kaldırılan sürümlerin API uç noktaları, kullanımdan kaldırılma 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ı | Kompakt istemci kitaplıkları sağlamak amacıyla, kullanımdan kaldırılma 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 tarihlerinden sonra yeni istemci kitaplığı sürümlerinde kullanımdan kaldırılan API sürümlerini artık desteklememektedir. |
| Destek | Kullanımdan kaldırılan sürümler için düzenli destek sağlıyoruz. | Kullanımdan kaldırma sürümleri, kullanımdan kaldırma tarihinden sonra artık desteklenmemektedir. |
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.0Max: - |
v15 |
Min: 28.0.0Max: - |
v14 |
Min: 26.0.0Max: - |
C#
Google Ads API |
.NET için istemci kitaplığı |
v16 |
Min: 18.1.0Max: - |
v15 |
Min: 17.1.0Max: - |
v14 |
Min: 16.1.0Max: - |
PHP
Google Ads API |
PHP için istemci kitaplığı |
v16 |
Min: 22.1.0Max: - |
v15 |
Min: 21.1.0Max: - |
v14 |
Min: 19.2.0Max: - |
Python
Google Ads API |
Python için istemci kitaplığı |
v15 |
Min: 22.1.0Max: - |
v14 |
Min: 21.2.0Max: - |
Ruby
Google Ads API |
Ruby için istemci kitaplığı |
v16 |
Min: 27.0.0Max: - |
v15 |
Min: 25.0.0Max: - |
v14 |
Min: 23.0.0Max: - |
Perl
Google Ads API |
Perl için istemci kitaplığı |
v16 |
Min: 21.0.0Max: - |
v15 |
Min: 19.0.0Max: - |
v14 |
Min: 17.0.0Max: - |
Kullanımdan kaldırılan özellikler
Yakında kullanımdan kaldırılacak olan özellikleri ilk öğrenenlerden biri olmak için Google Ads geliştirici blogunu düzenli olarak izleyin.
Aşağıdaki tabloda, Google Ads API için şu anda planlanan belirli özellikleri kullanımdan kaldırma işlemleri listelenmektedir. Her bir kullanımdan kaldırma süreciyle ilgili daha fazla bilgiyi bağlantılı blog yayınlarında bulabilirsiniz.
| Öne Çıkarın | Açıklama | Geçerlilik tarihi | Ek notlar |
|---|---|---|---|
| Komisyon Teklif Verme Stratejisi |
Google Ads API
artık COMMISSION teklif stratejisine sahip otel kampanyaları oluşturmayı
desteklememektedir
.
|
30 Nisan 2024 |
Yeni otel kampanyaları oluşturma veya COMMISSION teklif stratejisini mevcut kampanyalara uygulama istekleri BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED hatasıyla sonuçlanır. COMMISSION teklif stratejisinin kullanıldığı mevcut kampanyalar, 31 Ekim 2024 tarihine kadar yayınlanmaya devam edecek. Bu tarihten sonra kampanyaların yayını, teklif stratejisi güncellenene kadar durdurulur.
|