Search Ads 360 Reporting API, anlamsal sürümleme kullanır.
vMAJOR_MINOR biçiminde ana ve alt sürümler vardır. Örneğin, v0_0 ilk ana sürüm, v0_1 ise ilk ikincil sürümdür. Sürüm numarasının son eki, sürüm türünü belirtir: Ana sürümler için her zaman sıfır, alt sürümler için ise her zaman sıfırdan büyüktür.
Ana sürümler
Büyük sürümlerde, önceki sürümlerle uyumlu olmayan değişiklikler (büyük değişiklikler) yapılır.
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 yükseltme 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 yükseltmeniz gerekir. Yeni büyük sürümlerde, kodunuzdaki önemli değişiklikleri düzeltmenize yardımcı olacak bir taşıma kılavuzu sağlanır.
Zarar veren değişikliklere örnek olarak şunlar verilebilir:
- Bir hizmeti, arayüzü, alanı, yöntemi veya enum değerini kaldırmak ya da yeniden adlandırmak.
- Bir 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. varsayılan değer olarak
0yerine--). - Döndürülen hata nedenini A yerine B olarak değiştirme.
Alt sürümler
Alt sürümlerde yalnızca geriye dönük uyumlu değişiklikler yapılır.
Bir alt 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 yeni 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.