Semantik sürüm oluşturma
Google Ads API, büyük ve küçük sürümlerin bulunduğu anlamsal sürümlendirme yöntemini kullanır. Sürümün biçimi MAJOR.MINOR veya vMAJOR_MINOR olmalıdır. Örneğin, v18_0 ana sürüm, v18_1 ise alt sürümdür.
Geçmiş sürümler için sürüm notlarına bakın.
Ana sürümler
Büyük sürüm sürümleri, geriye dönük uyumsuz bazı değişiklikler içerir.
Sürüm, X ana sürüm numarasının olduğu vX_0 biçiminde sıfırla biter.
Her büyük sürümün ayrı bir uç noktası vardır. Bu, X ana sürüm numarasının olduğu URL'ye örnektir.
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 yapılması gerekebilir. İstemci kitaplıklarımızı kullanıyorsanız en yeni sürüme yükseltin. Yeni bir büyük sürüm yayınlandığında, kodunuzdaki önemli değişiklikleri düzeltmek için uygulamanız gereken bir taşıma kılavuzu sunarız.
Kullanıcıları etkileyen 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.
- Varsayılan değer olarak
0yerine--gibi çıkış biçimlerini değiştirme - 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. Küçük bir sürüm için vMAJOR_MINOR, sıfırdan büyük bir MINOR sayısına sahiptir.
Küçük bir sürüm yayınlandığında, halihazırda kullanılan uç nokta otomatik olarak güncellenir. Bu işlem, kodunuzun bozulmasına neden olmaz. Mevcut istemci kitaplıklarınızı kullanmaya devam edebilirsiniz.
Küçük sürümler, mevcut kodunuzu etkilemeyen yeni özellikler veya güncellemeler içerir. Bu yeni özellikleri kullanmak istiyorsanız istemci kitaplıklarınızı en yeni sürüme yükseltin.
Günbatımları
Eski Google Ads API sürümlerinin zaman zaman kullanımdan kaldırılması gerekir. Bir sürüm kullanımdan kaldırılmak üzereyken geliştirici blogunda bildirim yayınlayacağız. Desteği sonlandırma takvimi, gelecekteki kullanımdan kaldırma tarihleriyle güncellenir.