Anlamsal sürüm oluşturma
Google Ads API, bir ana ve bir alt sürümün bulunduğu anlamsal sürüm oluşturma yöntemini uygular. Sürümün biçimi MAJOR.MINOR
veya vMAJOR_MINOR
şeklindedir. Örneğin, v17_0
ana sürümken v17_1
alt sürümdür.
Geçmiş sürümlere ait sürüm notlarına bakın.
Ana sürümler
Ana sürüm sürümlerinde bazı kırılan, geriye dönük uyumsuz değişiklikler ortaya çıkmaktadı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ı olan 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 yapılması gerekebilir. İstemci kitaplıklarımızı kullanıyorsanız en yeni sürüme yükseltin. Yayınlanan bir ana sürüm olduğunda, kodunuzdaki zarar veren değişiklikleri düzeltmek için incelemeniz gereken bir geçiş kılavuzu sağlarız.
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.
0
olan değeri--
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 uyumlu değişiklikler uygulanır. Alt sürüm için vMAJOR_MINOR
, sıfırdan büyük bir MINOR
sayısına sahip olur.
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ı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ı
Belirli aralıklarla, eski Google Ads API sürümlerinin kullanımdan kaldırılması gerekir. Bir sürüm kullanımdan kaldırılmak üzereyken geliştirici blogunda bildirimler yayınlayacağız. Kullanımdan kaldırma programı, gelecekteki kullanımdan kaldırma tarihleriyle güncellenir.