Sürüm oluşturma
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu kılavuzda, Merchant API'nin sürüm oluşturma, yayınlama ve farklı sürümlerinin yaşam döngüsünü nasıl yönettiği açıklanmaktadır.
Sürüm oluşturma şeması
Merchant API, alt API düzeyinde bir sürüm oluşturma stratejisi kullanır. Bu, Merchant API'deki Ürünler gibi her API'nin kendi sürüm yaşam döngüsüne sahip olacağı anlamına gelir.
Kararlı alt API sürümleri: Bir alt API kararlı sürümdeyse tüm yöntemleri kararlı sürümde olur. Kararlı bir alt API sürümü vX (ör. v1, v2) olarak gösterilir. Bunlar, üretime hazır ana sürümlerdir.
Alfa alt API sürümleri: Bir alt API alfa sürümündeyse tüm yöntemleri alfa sürümündedir. Bir alfa alt API sürümü vXalpha (örneğin, v1alpha, v2alpha) olarak gösterilir. Bu sürümlerde, test ve hızlı yineleme için tasarlanmış deneysel erken erişim özellikleri bulunur. Alfa sürümleri kararlılık garantisi içermez, tanımlanmış bir kullanım ömrü yoktur ve 30 günlük bildirim süresiyle değiştirilebilir veya kullanımdan kaldırılabilir.
Sürüm değişiklikleri
Ana sürüm artışları (örneğin, v1'den v2'ye): Bunlar, geriye dönük uyumsuz ve zarar veren değişiklikleri gösterir. Bu değişiklikler için geliştirici tarafından işlem yapılması gerekir.
Yalnızca kararlı alt API'lerin uyumluluğu bozan değişiklikleri yeni bir sürüm numarasına sahip olur. Örneğin, v1'den v2'ye.
Küçük değişiklikler: Geriye dönük uyumlu eklemeler veya düzeltmeler, mevcut ana sürümde yapılan değişiklikler olarak sunulur. Bu tür değişiklikler, söz konusu ana sürümün
sürüm notlarında ayrıntılı olarak açıklanır. Bir alt API'ye yapılan, mevcut işlevleri bozmayan eklemeler, en son kararlı sürümün alfa kanalında veya doğrudan en son kararlı sürümde yayınlanır.
Desteği sonlandırma politikası
Eski Merchant alt API sürümlerini belirli aralıklarla kullanımdan kaldırırız. Kararlı ana sürümler (vX) için, resmi kullanımdan kaldırma duyurusundan itibaren 12 aylık bir kullanımdan kaldırma aralığı sunmayı taahhüt ediyoruz.
Örneğin, Products alt API'sinin v1 sürümünün desteğini 15 Ocak 2026'da sonlandırırsak bu sürüm en erken 15 Ocak 2027'de kullanımdan kaldırılır. Bu tarihten sonra, alt API'nin önceki sürümü artık kullanılamayacak.
Alt API sürümü ve yaşam döngüsü durumu
Aşağıdaki tabloda, Merchant API'nin her bir alt API'sinin en son sürümleri listelenmektedir:
| Sub-API |
Sürümler |
Durum |
| Hesaplar |
v1
v1beta |
Etkin
28 Şubat 2026'da kullanımdan kaldırılacak |
| Dönüşümler |
v1
v1beta |
Etkin
28 Şubat 2026'da kullanımdan kaldırılacak |
| Veri kaynakları |
v1
v1beta |
Etkin
28 Şubat 2026'da kullanımdan kaldırılacak |
| Envanterler |
v1
v1beta |
Etkin
28 Şubat 2026'da kullanımdan kaldırılacak |
| Sorun çözümü |
v1
v1beta |
Etkin
28 Şubat 2026'da kullanımdan kaldırılacak |
| Yerel feed'ler iş ortaklığı |
v1
v1beta |
Etkin
28 Şubat 2026'da kullanımdan kaldırılacak |
| Bildirimler |
v1
v1beta |
Etkin
28 Şubat 2026'da kullanımdan kaldırılacak |
| Sipariş takibi | v1
v1beta |
Etkin
28 Şubat 2026'da kullanımdan kaldırılacak |
| Ürünler |
v1
v1beta |
Etkin
28 Şubat 2026'da kullanımdan kaldırılacak |
| Product Studio |
v1alpha |
Etkin |
| Tanıtımlar
|
v1
v1beta |
Etkin
28 Şubat 2026'da kullanımdan kaldırılacak |
| Kota |
v1
v1beta |
Etkin
28 Şubat 2026'da kullanımdan kaldırılacak |
| Raporlama |
v1
v1beta |
Etkin
28 Şubat 2026'da kullanımdan kaldırılacak |
| Yorumlar |
v1alpha
v1 beta |
Etkin
28 Şubat 2026'da kullanımdan kaldırılacak |
En iyi uygulamalar
- Yeni sürümler, önemli güncellemeler, iyileştirmeler ve alt API'lerin kullanıma sunulması ile desteğinin sonlandırılmasıyla ilgili duyurular için sürüm notlarını ve en son
güncellemeleri düzenli olarak kontrol edin.
- Bir alt API'nin iki veya daha fazla kararlı sürümü varsa her zaman en son sürümü kullanmanızı öneririz.
- Uygulamanızı, ağ sorunları, sıklık sınırları ve yeni alt API sürümleriyle kullanıma sunulabilecek yeni hata kodları veya mesajlar da dahil olmak üzere çeşitli alt API hatalarını sorunsuz bir şekilde işleyecek şekilde tasarlayın.
- Alt API sürümünün desteği sonlandırılmak üzereyken yükseltme planlamaya başlamayın. Yeni sürümler kullanıma sunulur sunulmaz değerlendirmeye ve test etmeye başlayın.
- Özellik istekleri veya alt API yol haritasıyla ilgili endişeleriniz için sorularınız ya da geri bildirimlerinizle bize ulaşın. Merchant API ekibiyle teknik destek için nasıl iletişime geçeceğiniz hakkında bilgi edinmek istiyorsanız Merchant API ile ilgili yardım alma başlıklı makaleyi inceleyin.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-22 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-22 UTC."],[],[],null,["# Versioning\n\nThis guide explains how Merchant API handles versioning, releases, and the\nlifecycle of its different versions.\n\nVersioning scheme\n-----------------\n\nMerchant API employs a versioning strategy at the sub-API level. This means that\neach API, for example Products within the Merchant API, will have its own\nversion lifecycle.\n\n### Versioning format and presentation\n\n- **Stable sub-API versions:** If a sub-API is in a stable version then all\n its methods are in a stable version. A stable sub-API version is represented\n as **vX** (for example, **v1** , **v2**). These are production-ready major\n versions.\n\n- **Alpha sub-API versions:** If a sub-API is in an alpha, then all its\n methods are in alpha. An alpha sub-API version is represented as\n **vXalpha** (for example, **v1alpha** , **v2alpha**). They contain\n experimental, early access features intended for testing and rapid\n iteration. Alpha versions come with no stability assurance, have no defined\n lifespan and can be changed or discontinued with a notice period of 30 days.\n\n### Version changes\n\n- **Major version increments** (for example, v1 to v2): These signal\n backward-incompatible and breaking changes, which require developer action.\n Only breaking changes of stable sub-APIs will have a new version number. For\n example, v1 to v2.\n\n- **Minor changes:** Backward compatible additions or fixes are presented as\n changes to the existing major version. Such changes will be detailed in the\n release notes for that major version. Non-breaking additions to a sub-API will\n be released to the alpha channel of the latest stable version or directly to\n the latest stable version.\n\nSunset policy\n-------------\n\nWe periodically sunset older Merchant sub-API versions. We commit to a 12-month\ndeprecation window for stable major versions (vX), starting from the official\ndeprecation announcement.\n\nFor example, if we deprecate v1 of the Products sub-API on January 15, 2026, it\nwill sunset no earlier than January 15, 2027. Beyond this date, the earlier\nversion of the sub-API will no longer be available for use.\n\nSub-API version and lifecycle status\n------------------------------------\n\nThe following table lists the latest versions of each sub-API of Merchant API:\n\n| Sub-API | Versions | Status |\n|-------------------------|----------------|-------------------------------------------|\n| Accounts | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Conversions | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Data sources | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Inventories | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Issue resolution | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Local feeds partnership | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Notifications | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Order tracking | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Products | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Product Studio | v1alpha | Active |\n| Promotions | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Quota | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Reporting | v1 v1beta | Active To be discontinued on Feb 28, 2026 |\n| Reviews | v1alpha v1beta | Active To be discontinued on Feb 28, 2026 |\n\nBest practices\n--------------\n\n- Regularly check the release notes and [latest\n updates](/merchant/api/latest-updates) for new versions, major updates, improvements, and announcements about sub-API launches and deprecations.\n- If a sub-API has two or more stable versions, we suggest using the latest version at all times.\n- Design your application to gracefully handle various sub-API errors, including network issues, rate limits, and the new error codes or messages that might be introduced with newer sub-API versions.\n- Don't wait until a sub-API version is about to be sunset to start planning your upgrade. Begin evaluating and testing new versions as soon as they are available.\n- For feature requests or concerns about a sub-API roadmap, [reach out to us\n with questions or feedback](/merchant/api/support/give-feedback). For information about how to contact the Merchant API team for technical support, see [Get help with Merchant API](/merchant/api/support/get-help)."]]
