Na tej stronie opisaliśmy znane problemy programistów związane z interfejsem Merchant API.
Problemy z przepustowością w przypadku metod insert dotyczących produktów i asortymentu
Zgłoszenie: 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 związanych z przepustowością podczas przesyłania dużych ilości danych do interfejsu Merchant API. Ten problem może wystąpić, gdy używasz bibliotek klienta w przypadku tych metod:
accounts.productInputs.insertaccounts.products.localInventories.insertaccounts.products.regionalInventories.insert
Wprowadziliśmy ulepszenia, które zwiększają wydajność różnych systemów backendu. Jeśli problem nadal występuje, może być konieczne skonfigurowanie puli kanałów, aby zmaksymalizować przepustowość. Pozwala to ominąć typowy limit 100 strumieni na pojedynczy kanał gRPC dzięki zarządzaniu wieloma połączeniami bazowymi. Więcej informacji znajdziesz w artykule Refaktoryzacja kodu pod kątem żądań równoczesnych: zwiększanie przepustowości za pomocą pul kanałów.
Identyfikatory produktów ze znakami specjalnymi
Zgłoszenie: 3 października 2025 r. UTC | Ostatnia aktualizacja: 8 kwietnia 2026 r. UTC
Użytkownicy mogą napotkać problemy podczas zarządzania produktami, w przypadku których productId lub offerId nie są zgodne z wytycznymi dotyczącymi formatowania identyfikatora produktu.
Takie identyfikatory produktów mogą zawierać znaki specjalne – przede wszystkim ukośniki (/), dwukropki (:), tyldy (~) i znaki procentu (%). Platformy takie jak Merchant Center zezwalają już na niektóre znaki specjalne w identyfikatorach produktów.
Ponieważ interfejs Merchant API zawiera identyfikator produktu bezpośrednio w zasobie name jako część adresu URL (na przykład accounts/{account}/products/{productId}), te znaki mogą zakłócać standardowe kierowanie i analizowanie adresów URL, co może prowadzić do nieoczekiwanych błędów 404 Not Found lub 400 Bad Request podczas operacji GET, PATCH lub DELETE.
Aby bezpiecznie korzystać z usług zawierających te znaki, musisz zakodować segment productId lub offerId nazwy zasobu. Algorytm kodowania to kodowanie Base64URL bez dopełnienia. Więcej informacji: accounts.productInputs.name.
Rozwiązanie: wprowadziliśmy rozwiązanie, które ujednolica działanie w całym ekosystemie Merchant API. Dodaliśmy do odpowiedzi interfejsu API 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 listy lub pobierania bezpośrednio jako danych wejściowych kolejnych aktualizacji bez konieczności ręcznego kodowania.
Opóźnienie po utworzeniu źródła danych
Zgłoszenie: 10 kwietnia 2024 r. (UTC) | Ostatnia aktualizacja: 12 maja 2024 r. (UTC)
Wystąpiło znane opóźnienie podczas próby wstawienia produktów, promocji lub opinii natychmiast po utworzeniu nowego elementu DataSource. Podczas próby wstawienia produktów w ciągu 5 minut od utworzenia źródła danych wystąpił błąd Data source not found.
Rozwiązanie: opóźnienie zostało wyeliminowane, co umożliwia szybszą interakcję z nowo utworzonymi źródłami danych.
Inny problem?
Jeśli masz inne problemy, odwiedź strony Pomoc dotycząca Merchant API i Przesyłanie opinii.