Semantik sürüm oluşturma
Google Ads API, ana ve alt sürüm numarasıyla anlamsal sürüm oluşturma yöntemini kullanır. Sürümler MAJOR.MINOR veya vMAJOR.MINOR olarak yazılır.
Örneğin, v26.0 (veya v26) ana sürümdür, v26.1 ise alt sürümdür.
Mevcut ve geçmiş sürümlerle ilgili ayrıntılar için sürüm notlarına bakın.
Ana sürümler
Ana yayınlanan sürüm sürümleri, geriye dönük uyumsuz değişiklikler içerir. Bir ana sürümün ilk sürümü sıfırla biter (vX.0 veya vX; burada X, ana sürüm numarasıdır).
Her ana sürümün ayrı bir REST ve gRPC uç nokta yolu (vX) vardır. Bu yol, alt sürüm son ekini içermez. Aşağıdaki URL'de X, ana sürüm numarasıdır (örneğin, v26):
https://googleads.googleapis.com/vX
Eski bir ana sürümden yükseltme yapıyorsanız yeni ana sürüm uç noktasına geçtiğinizde kodunuzda değişiklik yapmanız gerekebilir. İstemci kitaplıklarımızı kullanıyorsanız yeni ana sürümü destekleyen istemci kitaplığı sürümüne geçin. Ana sürüm yayınlandığında, kodunuzdaki zarar veren değişiklikleri çözmenize yardımcı olacak bir yükseltme kılavuzu sunarız.
Zarar veren değişikliklere örnek olarak şunlar verilebilir:
- Bir hizmeti, arayüzü, alanı, yöntemi veya enum değerini kaldırma ya da yeniden adlandırma
- Bir alanın türünü değiştirme
- Kaynak adı biçimini değiştirme
- HTTP tanımındaki URL biçimini değiştirme
- Varsayılan değerleri değiştirme gibi çıkış biçimlerini değiştirme
- Döndürülen hata nedeni A'dan B'ye değiştiriliyor.
Alt sürümler
Alt sürümler yalnızca geriye dönük uyumlu değişiklikler içerir. Alt sürümde vMAJOR.MINOR, sıfırdan büyük bir MINOR numarasına sahiptir (ör. v26.1).
Bir alt sürüm yayınlandığında mevcut ana sürüm uç noktası (https://googleads.googleapis.com/vX) otomatik olarak güncellenir. Uç nokta URL'lerinizdeki sürüm yolunu değiştirmeniz gerekmez ve mevcut kod kesintisiz çalışmaya devam eder.
Alt sürümler, mevcut kodunuzu etkilemeyen özellikler veya güncellemeler ekler. Bir alt sürümdeki alanları veya özellikleri istemci kitaplığı ile kullanmak için istemci kitaplığınızı alt sürüm tanımlarını içeren bir sürüme yükseltin.
Desteği sonlandırma ve kullanımdan kaldırma
Eski Google Ads API sürümleri belirli aralıklarla kullanımdan kaldırılır ve daha sonra tamamen sonlandırılır:
- Desteği sonlandırıldı: Bir ana sürüm (ör.
v26) yayınlandığında, önceki tüm ana sürümler "desteği sonlandırıldı" olarak işaretlenir. Desteği sonlandırılan sürümlere yapılan API çağrıları, kullanımdan kaldırılma tarihine kadar başarılı olmaya devam eder ve mevcut istemci kitaplığı sürümleri bunları desteklemeye devam eder. Ancak sonraki istemci kitaplığı sürümleri, paket boyutunu azaltmak için desteği sonlandırılan API sürümlerini atlar. - Kullanımdan kaldırma: Bir sürüm, kullanımdan kaldırılma tarihinde devre dışı bırakılır ve uç noktasına yapılan tüm API çağrıları başarısız olur.
Sürümler kullanımdan kaldırılmadan önce geliştirici blogunda duyurular yayınlarız. Etkin, desteği sonlandırılmış ve desteği sonlandırılacak sürümlerin tarihlerini öğrenmek için desteği sonlandırma ve kullanımdan kaldırma takvimini inceleyin.