Search Ads 360 Reporting API anlamsal sürüm oluşturma kullanır.
Şu şekilde biçimlendirilmiş ana ve alt sürümler vardır:
vMAJOR_MINOR Örneğin v0_0,
İlk ana sürüm ve v0_1 ilk alt sürüm.
sürüm numarası sürüm türünü gösterir: ana sürümlerde her zaman sıfırdır,
alt sürümler için ise her zaman sıfırdan büyüktür.
Ana sürümler
Ana sürümler, zarar veren değişikliklere, yani geriye dönük uyumluluğa sahiptir.
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, kodunu girmeniz gerekir.
İstemci kitaplığı kullanıyorsanız en yeni sürüme yükseltmeniz gerekiyor. Yeni ana sürümler ihlal eden değişiklikleri düzeltmenize yardımcı olacak geçiş rehberini inceleyebilirsiniz.
Zarar veren değişikliklere örnek olarak şunlar verilebilir:
- Bir hizmeti, arayüzü, alanı, yöntemi veya sıralama 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.
- Çıktı biçimlerini değiştirme (ör.
0değerini varsayılan değer olarak--olarak değiştirme). - Döndürülen hata nedenini A'dan B'ye değiştirme.
Alt sürümler
Alt sürümlerde yalnızca geriye dönük olarak uyumlu değişiklikler bulunur.
Bir alt sürüm yayınlandığında, zaten kullanımda olan uç nokta otomatik olarak güncellenir. Bu, kodunuzun bozulmasına neden olmaz. Devam edebilirsiniz mevcut istemci kitaplığınızı kullanmanız gerekir.
Alt sürümler, mevcut öğelerinizi etkilemeyen yeni özellikler girin. Yeni özellikleri kullanmak istiyorsanız istemci kitaplığından en yeni sürüme sürümünü değil.
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 grubuna bildirim gönderme.