Anlamsal sürüm oluşturma
Google Ads API, anlamsal sürüm oluşturma yöntemini kullanır. Bu yöntemde ana ve alt sürümler bulunur. Sürümün biçimi MAJOR.MINOR veya vMAJOR_MINOR olmalıdır. Örneğin, v21_0 ana sürüm, v21_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
Ana sürüm versiyonlarında, eski sürümlerle uyumsuz ve zarar veren değişiklikler yapılır.
Sürüm, vX_0 biçiminde sıfırla biter. Burada X, ana sürüm numarasıdır.
Her ana sürümün ayrı bir uç noktası vardır. Bu örnek URL'de X, ana sürüm numarasıdır.
https://googleads.googleapis.com/vX
Daha 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 en yeni sürüme yükseltin. Ana sürüm yayınlandığında, kodunuzdaki uyumluluğu bozan değişiklikleri düzeltmek için kullanabileceğiniz bir taşıma kılavuzu sunarız.
Kullanıcıları etkileyen 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.
- 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.
- Çıkış biçimlerini değiştirme (ör. varsayılan değer olarak
0'dan--'ye geçme) - A'dan döndürülen hata nedenini 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 sürüm için vMAJOR_MINOR, sıfırdan büyük bir MINOR sayısına sahip olur.
Küçük bir sürüm yayınlandığında, halihazırda kullanımda olan uç nokta otomatik olarak güncellenir. Bu işlem, kodunuzun bozulmasına neden olmaz. Mevcut istemci kitaplıklarınızı kullanmaya devam edebilirsiniz.
Alt 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 belirli aralıklarla kullanımdan kaldırılması gerekir. Bir sürüm kullanımdan kaldırılmak üzere olduğunda geliştirici blogunda bildirimler yayınlarız. Kullanımdan kaldırma planı, gelecekteki kullanımdan kaldırma tarihleriyle güncellenir.