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ümlerde, geriye dönük uyumsuzluk oluşturan önemli değişiklikler yapılır. 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 yolda alt sürüm son eki bulunmaz. Aşağıdaki URL'de X, ana sürüm numarasıdır (ör. 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. Belirli bir ana sürüme yapılan tüm API çağrıları her zaman ilgili en son alt sürüme gider ve Google Ads API, belirli alt sürümlerin çağrılmasını desteklemez.
Uç nokta URL'lerinizdeki sürüm yolunu değiştirmeniz gerekmez ve mevcut kod, kesintiye uğramadan çalışmaya devam eder. Alt sürümlerin kullanım ömrü ayrı olarak izlenmez. Bunun yerine, alt sürümlerin desteği, karşılık gelen ana sürümle aynı tarihte sonlandırılır.
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
Google Ads API, her zaman birden fazla etkin ana sürüm bulundurur. Eski sürümler, belirli aralıklarla kullanımdan kaldırılır ve daha sonra tamamen sonlandırılır:
- Desteği sonlandırıldı: Bir sürümün desteğinin sonlandırıldığı, yalnızca açıkça desteği sonlandırıldı olarak işaretlenmişse kabul edilir. 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.
- 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 özelliklerin tarihleri için desteği sonlandırma ve kullanımdan kaldırma programını inceleyin.