Search Ads 360 Reporting API anlamsal sürüm oluşturma özelliğini kullanır.
vMAJOR_MINOR
şeklinde biçimlendirilmiş ana ve alt sürümler vardır. Örneğin, v0_0
ilk ana sürüm, v0_1
ise ilk alt sürümdür. Sürüm numarasının son eki, sürüm türünü belirtir: Ana sürümlerde değer her zaman sıfırdır. Alt sürümler için ise sıfırdan büyüktür.
Ana sürümler
Önemli sürümler, zarar veren değişikliklere, yani geriye dönük uyumlu olmayan değişikliklere yol açar.
Her ana sürümün ayrı bir uç noktası vardır. Örneğin:
https://searchads360.googleapis.com/v0 https://searchads360.googleapis.com/v1
Bir ana sürümden diğerine geçiş yaparken yeni ana sürüm uç noktasına geçmeden önce kodunuzu değiştirmeniz gerekebilir.
İstemci kitaplığı kullanıyorsanız en yeni sürüme geçmeniz gerekir. Yeni ana sürümler, kodunuzdaki zarar veren değişiklikleri düzeltmenize yardımcı olacak bir taşıma kılavuzu sunar.
Zarar veren değişikliklere örnek olarak aşağıdakiler verilebilir:
- Bir hizmeti, arayüzü, alanı, yöntemi veya enum değerini kaldırma ya da yeniden adlandırma.
- Alanın türünü değiştirme.
- Kaynak adı biçimini değiştirme.
- HTTP tanımında URL biçimini değiştirme.
- Çıkış biçimlerini değiştirme (ör.
0
değerini--
olarak varsayılan değer olarak değiştirme). - Döndürülen hata nedeni A'dan B'ye değiştiriliyor.
Alt sürümler
Küçük sürümler yalnızca geriye dönük uyumlu değişiklikler sunar.
Küçük bir sürüm yayınlandığında, zaten kullanımda olan uç nokta otomatik olarak güncellenir. Bu, kodunuzun bozulmasına neden olmaz. Mevcut istemci kitaplığınızı kullanmaya devam edebilirsiniz.
Küçük sürümler, mevcut kodunuzu etkilemeyen yeni özellikler veya güncellemeler içerir. Yeni özellikleri kullanmak istiyorsanız istemci kitaplığınızı en son sürüme yükseltmeniz gerekir.
Günbatımları
Eski bir Search Ads 360 Reporting API sürümünün kullanımdan kaldırılması planlandığında, searchads-api-announcements Google grubunda bir bildirim yayınlarız.