Pembuatan Versi
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Panduan ini menjelaskan cara Merchant API menangani pembuatan versi, rilis, dan siklus proses berbagai versinya.
Skema pembuatan versi
Merchant API menggunakan strategi pembuatan versi di tingkat sub-API. Artinya, setiap API, misalnya Produk dalam Merchant API, akan memiliki siklus proses versinya sendiri.
Versi sub-API stabil: Jika sub-API berada dalam versi stabil, semua
metodenya berada dalam versi stabil. Versi sub-API stabil ditampilkan
sebagai vX (misalnya, v1, v2). Ini adalah versi utama yang siap produksi.
Versi sub-API alfa: Jika sub-API dalam versi alfa, maka semua
metodenya dalam versi alfa. Versi sub-API alfa ditampilkan sebagai
vXalpha (misalnya, v1alpha, v2alpha). Fitur ini berisi fitur akses awal eksperimental yang ditujukan untuk pengujian dan iterasi cepat. Versi alfa tidak memiliki jaminan stabilitas, tidak memiliki masa aktif yang ditentukan, dan dapat diubah atau dihentikan dengan periode pemberitahuan 30 hari.
Perubahan versi
Peningkatan versi utama (misalnya, v1 ke v2): Peningkatan ini menandakan
perubahan yang tidak kompatibel dengan versi sebelumnya dan perubahan yang menyebabkan gangguan, yang memerlukan tindakan developer.
Hanya perubahan yang menyebabkan gangguan pada sub-API stabil yang akan memiliki nomor versi baru. Misalnya, v1 ke v2.
Perubahan kecil: Penambahan atau perbaikan yang kompatibel dengan versi sebelumnya ditampilkan sebagai
perubahan pada versi utama yang ada. Perubahan tersebut akan dijelaskan dalam catatan rilis untuk versi utama tersebut. Penambahan yang tidak merusak pada sub-API akan dirilis ke saluran alfa versi stabil terbaru atau langsung ke versi stabil terbaru.
Kebijakan penghentian
Kami secara berkala menghentikan penggunaan versi sub-API Merchant yang lebih lama. Kami berkomitmen pada periode penghentian penggunaan selama 12 bulan untuk versi utama stabil (vX), mulai dari pengumuman penghentian penggunaan resmi.
Misalnya, jika kami menghentikan penggunaan sub-API Produk v1 pada 15 Januari 2026, sub-API tersebut
akan dihentikan paling cepat pada 15 Januari 2027. Setelah tanggal ini, versi sub-API sebelumnya tidak akan tersedia lagi untuk digunakan.
Versi sub-API dan status siklus proses
Tabel berikut mencantumkan versi terbaru setiap sub-API Merchant API:
| Sub-API |
Versi |
Status |
| Akun |
v1
v1beta |
Aktif
Akan dihentikan pada 28 Februari 2026 |
| Konversi |
v1
v1beta |
Aktif
Akan dihentikan pada 28 Februari 2026 |
| Sumber data |
v1
v1beta |
Aktif
Akan dihentikan pada 28 Februari 2026 |
| Inventaris |
v1
v1beta |
Aktif
Akan dihentikan pada 28 Februari 2026 |
| Penyelesaian masalah |
v1
v1beta |
Aktif
Akan dihentikan pada 28 Februari 2026 |
| Kemitraan feed lokal |
v1
v1beta |
Aktif
Akan dihentikan pada 28 Februari 2026 |
| Notifikasi |
v1
v1beta |
Aktif
Akan dihentikan pada 28 Februari 2026 |
| Pelacakan pesanan | v1
v1beta |
Aktif
Akan dihentikan pada 28 Februari 2026 |
| Produk |
v1
v1beta |
Aktif
Akan dihentikan pada 28 Februari 2026 |
| Product Studio |
v1alpha |
Aktif |
| Promosi
|
v1
v1beta |
Aktif
Akan dihentikan pada 28 Februari 2026 |
| Kuota |
v1
v1beta |
Aktif
Akan dihentikan pada 28 Februari 2026 |
| Pelaporan |
v1
v1beta |
Aktif
Akan dihentikan pada 28 Februari 2026 |
| Ulasan |
v1alpha
v1 beta |
Aktif
Akan dihentikan pada 28 Februari 2026 |
Praktik terbaik
- Periksa catatan rilis dan update terbaru secara rutin untuk mengetahui versi baru, update penting, peningkatan, dan pengumuman tentang peluncuran dan penghentian penggunaan sub-API.
- Jika sub-API memiliki dua atau lebih versi stabil, sebaiknya gunakan versi terbaru setiap saat.
- Desain aplikasi Anda untuk menangani berbagai error sub-API dengan baik, termasuk masalah jaringan, batas frekuensi, dan kode atau pesan error baru yang mungkin diperkenalkan dengan versi sub-API yang lebih baru.
- Jangan menunggu hingga versi sub-API akan dihentikan untuk mulai merencanakan upgrade. Mulai evaluasi dan uji versi baru segera setelah tersedia.
- Untuk permintaan fitur atau masalah terkait peta jalan sub-API, hubungi kami
untuk mengajukan pertanyaan atau memberikan masukan. Untuk
mengetahui informasi tentang cara menghubungi tim Merchant API untuk mendapatkan
dukungan teknis, lihat Mendapatkan bantuan terkait Merchant API.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-22 UTC.
[null,null,["Terakhir diperbarui pada 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)."]]
