Sürüm oluşturma

Anlamsal sürüm oluşturma

Google Ads API, ana ve alt sürümlerin söz konusu olduğu anlamsal sürüm oluşturma yöntemini uygular. Sürümün biçimi MAJOR.MINOR veya vMAJOR_MINOR şeklindedir. Örneğin, v16_0 ana sürüm, v16_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 sürümlerinde geriye dönük olarak uyumsuz bazı değişiklikler bulunmaktadır. Sürüm, vX_0 biçiminde sıfır ile biter. Burada X ana sürüm numarasıdır.

Her ana sürümün ayrı bir uç noktası vardır. Bu, X ana sürüm numarasının olduğu bir URL örneğidir.

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 yapmanız gerekebilir. İstemci kitaplıklarımızı kullanıyorsanız en yeni sürüme geçin. Ana sürüm yayınlandığında, kodunuzdaki zarar veren değişiklikleri düzeltmek için uygulamanız gereken bir geçiş kılavuzu sağlarız.

Zarar veren değişikliklere örnek olarak aşağıdakiler verilebilir:

• Bir hizmeti, arayüzü, alanı, yöntemi veya numaralandırma 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ındaki URL biçiminin değiştirilmesi.
• Çıkış biçimlerini varsayılan değer olarak değiştirme (ör. 0 değerinden -- değerine değiştirme).
• Döndürülen hata nedeni A'dan B'ye değiştiriliyor.

Alt sürümler

Alt sürümler yalnızca geriye dönük uyumlu değişiklikler sunar. Bir alt 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, kullanımda olan uç nokta otomatik olarak güncellenir. Bu, 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 düzenli aralıklarla kullanımdan kaldırılması gerekir. Bir sürüm kullanımdan kaldırılmak üzereyken geliştirici blogunda bildirim yayınlayacağız. Kullanımdan kaldırma planı gelecekteki kullanımdan kaldırma tarihleriyle güncellenir.