Anlamsal sürüm oluşturma
Google Ads API, ana ve küçük sürüm numarasıyla anlamsal sürüm oluşturma yöntemini kullanır. Sürümler MAJOR.MINOR veya vMAJOR.MINOR olarak yazılır.
Örneğin, v25.0 (veya v25) ana sürüm, v25.1 ise alt sürümdür.
Mevcut ve önceki sürümlerle ilgili ayrıntılı bilgi için sürüm notlarına bakın.
Ana sürümler
Ana sürüm versiyonlarında, geriye dönük uyumsuz ve zarar veren değişiklikler yapılır. Ana sürümün ilk yayınlanması sıfırla biter (vX.0 veya vX, burada X ana sürüm numarasıdır).
Her ana sürümün, küçük sürüm son ekini içermeyen ayrı bir REST ve gRPC uç nokta yolu (vX) vardır. Aşağıdaki URL'de X, ana sürüm numarasıdır (örneğin, v25):
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 yeni ana sürümü destekleyen istemci kitaplığı sürümüne yükseltin. Ana sürüm yayınlandığında, kodunuzdaki değişiklikleri çözmenize yardımcı olmak için yükseltme kılavuzu sunarız.
Zarar veren 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.
- Varsayılan değerleri değiştirme gibi çıkış biçimlerini değiştirme
- 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. Alt sürüm için vMAJOR.MINOR, sıfırdan büyük bir MINOR numarasına sahiptir (örneğin, v25.1).
Küçük bir sürüm yayınlandığında mevcut ana sürüm uç noktası (https://googleads.googleapis.com/vX) otomatik olarak yerinde güncellenir. Uç nokta URL'lerinizdeki sürüm yolunu değiştirmeniz gerekmez ve mevcut kod, bozulmadan çalışmaya devam eder.
Alt sürümlerde, mevcut kodunuzu etkilemeyen özellikler veya güncellemeler eklenir. İstemci kitaplığı olan alt sürümdeki alanları veya özellikleri kullanmak için istemci kitaplığınızı alt sürüm tanımlarını içeren bir sürüme yükseltin.
Desteği sonlandırma ve kullanımdan kaldırma
Eski Google Ads API sürümlerinin desteği belirli aralıklarla sonlandırılır ve bu sürümler kullanımdan kaldırılır:
- Kullanımdan kaldırıldı: Ana sürüm (ör.
v25) yayınlandığında önceki tüm ana sürümler kullanımdan kaldırıldı olarak işaretlenir. Destek sonlandırma tarihine kadar, destek sonlandırılan sürümlere yapılan API çağrıları başarılı olmaya devam eder ve mevcut istemci kitaplığı sürümleri bu sürümleri desteklemeye devam eder. Ancak sonraki istemci kitaplığı sürümleri, paket boyutunu küçültmek için destek sonlandırılan API sürümlerini içermez. - Kullanımdan kaldırma: Bir sürüm, kullanımdan kaldırılma tarihinde devre dışı bırakılır ve uç noktasına yapılan tüm API çağrıları başarısız olur.
Sürüm desteğinin sonlandırılmasından önce geliştirici blogunda duyurular yayınlıyoruz. Etkin, desteği sonlandırılmış ve kullanımdan kaldırılması planlanan özelliklerin desteğinin sonlandırılma ve kullanımdan kaldırılma takvimini inceleyin.