Znane problemy

Ta strona zawiera informacje o znanych problemach, które programiści zgłaszają w związku z interfejsem Merchant API.

Sporadyczne odpowiedzi INTERNAL_ERROR

Zgłoszone: 29 czerwca 2026 r. UTC

Otrzymujemy zgłoszenia dotyczące sporadycznych odpowiedzi INTERNAL_ERROR wpływających na różne metody interfejsu API. Współczynnik błędów wynosi zwykle około 0,1%, ale czasami może być nieco wyższy.

Aktywnie pracujemy nad rozwiązaniem tego problemu. Jeśli napotkasz te błędy, zalecamy ponowienie żądania. Jeśli zauważysz wysoki współczynnik błędów, skontaktuj się z zespołem pomocy.

Losowe błędy UnauthenticatedException

Zgłoszone: 30 marca 2026 r. UTC | Ostatnia aktualizacja: 17 kwietnia 2026 r. UTC

Wielu klientów napotyka sporadyczne błędy UnauthenticatedException podczas przesyłania produktów i uzyskiwania dostępu do innych interfejsów Merchant Center API. Błędy występują losowo, nawet w przypadku ponawiania prób, i dotyczą zarówno pierwszych wywołań, jak i kolejnych prób. Niektóre połączenia kończą się niepowodzeniem, a inne działają w krótkim czasie.

Wdrożyliśmy rozwiązanie tymczasowe i prowadzimy dalsze prace nad rozwiązaniem trwałym. Jeśli napotkasz ten błąd, zalecamy ponowienie wywołań interfejsu API.

Zwiększone opóźnienie, komunikaty DEADLINE_EXCEEDED i INTERNAL_ERROR w przypadku metod dotyczących produktów i asortymentu

Zgłoszone: 18 marca 2026 r. UTC | Ostatnia aktualizacja: 13 maja 2026 r. UTC

Niektórzy użytkownicy napotykali stałe opóźnienia i częste komunikaty DEADLINE_EXCEEDED lub INTERNAL_ERROR podczas korzystania z metod productInputs i regionalInventories. Główną przyczyną był incydent na poziomie backendu, który wpłynął na wydajność przetwarzania. Prace nad rozwiązaniem tego problemu są w toku.

Jeśli nadal występują duże opóźnienia, zalecamy zmniejszenie rozmiaru partii żądań. Jeśli otrzymujesz wspomniane komunikaty o błędach, możesz spróbować zwiększyć limity czasu po stronie klienta.

Problemy z przepustowością w przypadku metod insert dotyczących produktów i asortymentu

Zgłoszone: 28 stycznia 2026 r. UTC | Ostatnia aktualizacja: 31 marca 2026 r. UTC

Otrzymaliśmy zgłoszenia dotyczące problemów z wydajnością po stronie klienta podczas przesyłania dużych ilości danych do interfejsu Merchant API. Ten problem może wystąpić podczas korzystania z bibliotek klienta w przypadku tych metod:

Wprowadziliśmy ulepszenia, które zwiększają wydajność różnych systemów backendowych. Jeśli problem nadal występuje, może być konieczne skonfigurowanie puli kanałów, aby zmaksymalizować przepustowość. Pozwala to ominąć typowy limit 100 strumieni w jednym kanale gRPC, zarządzając wieloma połączeniami bazowymi. Więcej informacji znajdziesz w artykule Refaktoryzacja kodu pod kątem równoczesnych żądań: zwiększanie przepustowości za pomocą puli kanałów.

Identyfikatory produktów ze znakami specjalnymi

Zgłoszone: 3 października 2025 r. UTC | Ostatnia aktualizacja: 8 kwietnia 2026 r. UTC

Użytkownicy mogą napotykać problemy podczas zarządzania produktami, w przypadku których productId lub offerId nie są zgodne z wytycznymi dotyczącymi formatowania identyfikatorów produktów. Takie identyfikatory produktów mogą zawierać znaki specjalne, w szczególności ukośniki (/), dwukropki (:), tyldy (~) i znaki procenta (%). Powierzchnie takie jak Merchant Center, już teraz dopuszczają niektóre znaki specjalne w identyfikatorach produktów.

Ponieważ interfejs Merchant API włącza identyfikator produktu bezpośrednio do name zasobu jako część adresu URL (np. accounts/{account}/products/{productId}), te znaki mogą zakłócać standardowe routing i analizowanie adresów URL, co prowadzi do nieoczekiwanych błędów 404 Not Found lub 400 Bad Request podczas operacji GET, PATCH lub DELETE.

Aby bezpiecznie korzystać z produktów zawierających te znaki, musisz zakodować segment productId lub offerId w nazwie zasobu. Algorytm kodowania to kodowanie Base64URL bez dopełnienia. Więcej informacji znajdziesz w artykule accounts.productInputs.name.

Rozwiązane: wdrożyliśmy rozwiązanie, które ujednolica działanie w całym ekosystemie Merchant API. Do odpowiedzi interfejsu API dodaliśmy nowe pole base64_encoded_name, które zawiera wstępnie zakodowaną nazwę zasobu. Dzięki temu możesz używać danych wyjściowych wywołania list lub get bezpośrednio jako danych wejściowych do kolejnych aktualizacji bez ręcznego kodowania.

Opóźnienie po utworzeniu źródła danych

Zgłoszone: 10 kwietnia 2024 r. UTC | Ostatnia aktualizacja: 12 maja 2024 r. UTC

Występowało znane opóźnienie podczas próby wstawienia produktów, promocji lub opinii bezpośrednio po utworzeniu nowego elementu DataSource. Podczas próby wstawienia elementów w ciągu 5 minut od utworzenia źródła danych zwracany był błąd Data source not found.

Rozwiązane: to opóźnienie zostało wyeliminowane, co umożliwia natychmiastową interakcję z nowo utworzonymi źródłami danych.

Inny problem?

Jeśli masz inne problemy, odwiedź strony Uzyskiwanie pomocy dotyczącej Merchant API i Przesyłanie opinii.

Wstecz
Versioning
Dalej
Overview