Obsługa wersji
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Z tego przewodnika dowiesz się, jak Merchant API obsługuje wersjonowanie, wydania i cykl życia różnych wersji.
Schemat wersji
Interfejs Merchant API stosuje strategię wersji na poziomie interfejsu API. Oznacza to, że każdy interfejs API, np. Produkty w Merchant API, będzie miał własny cykl życia wersji.
Stabilne wersje podrzędnych interfejsów API: jeśli podrzędny interfejs API jest w stabilnej wersji, wszystkie jego metody są w stabilnej wersji. Stabilna wersja podrzędna interfejsu API jest oznaczana jako vX (np. v1, v2). Są to główne wersje gotowe do wdrożenia w środowisku produkcyjnym.
Wersje alfa interfejsów API: jeśli interfejs API jest w wersji alfa, wszystkie jego metody są w wersji alfa. Wersja alfa interfejsu API jest oznaczana jako vXalpha (np. v1alpha, v2alpha). Zawierają one eksperymentalne funkcje w ramach wcześniejszego dostępu, które są przeznaczone do testowania i szybkiego wprowadzania zmian. Wersje alfa nie mają gwarancji stabilności, nie mają określonego okresu użytkowania i mogą zostać zmienione lub wycofane z 30-dniowym wyprzedzeniem.
Zmiany wersji
Zwiększenie numeru wersji głównej (np. z wersji 1 na wersję 2): sygnalizuje to zmiany powodujące niezgodności wsteczne i zmiany, które wymagają działania dewelopera.
Tylko zmiany powodujące niezgodność w stabilnych interfejsach API będą miały nowy numer wersji. Na przykład z wersji 1 na wersję 2.
Drobne zmiany: dodatki lub poprawki zgodne wstecznie są prezentowane jako zmiany w istniejącej wersji głównej. Szczegółowe informacje o takich zmianach znajdziesz w informacjach o wersji głównej. Niepowodujące przerw w działaniu dodatki do podrzędnego interfejsu API będą publikowane na kanale alfa najnowszej stabilnej wersji lub bezpośrednio w najnowszej stabilnej wersji.
Zasady wycofywania
Okresowo wycofujemy starsze wersje interfejsów API Merchant. W przypadku stabilnych wersji głównych (vX) zobowiązujemy się do 12-miesięcznego okresu wycofywania, który rozpoczyna się od oficjalnego ogłoszenia o wycofaniu.
Jeśli na przykład 15 stycznia 2026 r. wycofamy interfejs API produktów w wersji 1, zostanie on wyłączony najwcześniej 15 stycznia 2027 r. Po tej dacie starsza wersja interfejsu API nie będzie już dostępna.
Wersja interfejsu API i stan cyklu życia
W tabeli poniżej znajdziesz najnowsze wersje każdego interfejsu API Merchant:
| Sub-API |
Wersje |
Stan |
| Konta |
v1
v1beta |
Aktywny
Wycofany 28 lutego 2026 r. |
| Konwersje |
v1
v1beta |
Aktywny
Wycofany 28 lutego 2026 r. |
| Źródła danych |
v1
v1beta |
Aktywny
Wycofany 28 lutego 2026 r. |
| Zapasy |
v1
v1beta |
Aktywny
Wycofany 28 lutego 2026 r. |
| Rozwiązywanie problemów |
v1
v1beta |
Aktywny
Wycofany 28 lutego 2026 r. |
| Program partnerski danych o asortymencie lokalnym |
v1
v1beta |
Aktywny
Wycofany 28 lutego 2026 r. |
| Powiadomienia |
v1
v1beta |
Aktywny
Wycofany 28 lutego 2026 r. |
| Śledzenie zamówień | v1
v1beta |
Aktywny
Wycofany 28 lutego 2026 r. |
| Produkty |
v1
v1beta |
Aktywny
Wycofany 28 lutego 2026 r. |
| Product Studio |
v1alpha |
Aktywne |
| Promocje
|
v1
v1beta |
Aktywny
Wycofany 28 lutego 2026 r. |
| Limit |
v1
v1beta |
Aktywny
Wycofany 28 lutego 2026 r. |
| Raportowanie |
v1
v1beta |
Aktywny
Wycofany 28 lutego 2026 r. |
| Opinie |
v1alpha
v1 beta |
Aktywny
Wycofany 28 lutego 2026 r. |
Sprawdzone metody
- Regularnie sprawdzaj informacje o wersji i najnowsze aktualizacje, aby być na bieżąco z nowymi wersjami, ważnymi aktualizacjami, ulepszeniami i ogłoszeniami dotyczącymi wprowadzenia i wycofania interfejsów API.
- Jeśli podrzędny interfejs API ma co najmniej 2 stabilne wersje, zalecamy korzystanie zawsze z najnowszej wersji.
- Zaprojektuj aplikację tak, aby prawidłowo obsługiwała różne błędy interfejsu API, w tym problemy z siecią, limity szybkości i nowe kody lub komunikaty o błędach, które mogą zostać wprowadzone w nowszych wersjach interfejsu API.
- Nie czekaj, aż wersja podrzędna interfejsu API zostanie wycofana, aby rozpocząć planowanie uaktualnienia. Rozpocznij ocenianie i testowanie nowych wersji, gdy tylko będą dostępne.
- Jeśli masz prośby o dodanie funkcji lub uwagi dotyczące planu rozwoju interfejsu API, skontaktuj się z nami. Informacje o tym, jak skontaktować się z zespołem Merchant API w celu uzyskania pomocy technicznej, znajdziesz w artykule Uzyskiwanie pomocy dotyczącej Merchant API.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-22 UTC.
[null,null,["Ostatnia aktualizacja: 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)."]]
