Oto najczęstsze błędy:
notFound: nie znaleziono elementu.not_inserted: nie udało się wstawić elementu.[link] validation/invalid_value for <destinations>: Adresy URL nie należą do Twojej witryny.- quota/too_many_items: limit sprzedawcy został przekroczony.
Poniżej znajduje się lista błędów w porządku alfabetycznym.
uwierzytelnianie/odrzucenie_dostępu_do_konta
User cannot access account
<account_number> |
|
|---|---|
| Podsumowanie | Wysłano żądanie dotyczące konta, do którego uwierzytelniony użytkownik nie ma dostępu. |
| Typowe przyczyny | Błąd w docelowym identyfikatorze sprzedawcy lub zapomniano zarejestrować użytkownika w Merchant Center. |
| Zalecane wskazówki dotyczące obsługi | Sprawdź, czy kierujesz reklamy na właściwe konto, lub zarejestruj się jako użytkownik tego konta w Merchant Center (Ustawienia > Użytkownicy). |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
User is not an administrator of
account <account_number> |
|
| Podsumowanie | Zgłoszono prośbę o zmodyfikowanie konta, do którego uwierzytelniony użytkownik nie ma uprawnień administratora. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Ustaw uprawnienia administratora dla uwierzytelnionego użytkownika. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
konflikt
[productId] Product ID <product
id> is already modified by another entry in the same request for merchant
<merchant> and store code <store code> |
|
|---|---|
| Podsumowanie | Podjęto próbę wykonania kilku sprzecznych operacji jednocześnie. |
| Typowe przyczyny | Jedno żądanie zbiorcze zawiera wiele operacji powodujących konflikty dotyczące tego samego produktu lub w tym samym czasie do interfejsu Content API przesłano wiele operacji powodujących konflikt. |
| Zalecane wskazówki dotyczące obsługi | Zobacz wskazówki, jak im zapobiegać. |
| Wskazówki dotyczące profilaktyki | Zawierają wszystkie zmiany w ramach jednej operacji w ramach określonej usługi w zbiorczym zestawie żądań. Staraj się unikać wielu równoczesnych wywołań Content API dla tego samego sprzedawcy i tego samego kodu sklepu lub upewnij się, że nie zawierają one produktów o tych samych produktach. |
internalError
Internal error |
|
|---|---|
| Podsumowanie | Wystąpił problem z backendem Google. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Ponów prośbę. Jeśli błąd będzie się powtarzać, poinformuj nas o tym na forum. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
błąd
Invalid channel:
'<channel>' |
|
|---|---|
| Podsumowanie | Jako część identyfikatora produktu podano nieprawidłowy kanał.
Na przykład: not_a_channel:en:US:sku123. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Nie dotyczy |
| Wskazówki dotyczące profilaktyki | Upewnij się, że identyfikator produktu ma format
channel:languageCode:countryCode:offerId, np.
online:en:US:sku123. Więcej informacji znajdziesz w dokumentacji referencyjnej
Products.insert. |
[countrycode] Invalid country code:
'<country_code>' |
|
| Podsumowanie | Jako część identyfikatora produktu podano nieprawidłowy kod kraju.
Na przykład: online:en:not_a_country_code:sku123. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Nie dotyczy |
| Wskazówki dotyczące profilaktyki | Upewnij się, że identyfikator produktu ma format channel:languageCode:countryCode:offerId, a kod kraju jest prawidłowym kodem kraju zgodnym z normą
ISO 3166. |
[item id] Invalid item
id: '<id>' |
|
| Podsumowanie | Nieprawidłowy identyfikator produktu, np. sku123 zamiast online:en:US:sku123. |
| Typowe przyczyny | Podanie identyfikatora oferty zamiast identyfikatora produktu w żądaniu GET lub DELETE. |
| Zalecane wskazówki dotyczące obsługi | Nie dotyczy |
| Wskazówki dotyczące profilaktyki | Upewnij się, że identyfikator produktu ma format channel:languageCode:countryCode:offerId. |
[name] The term '<term>' is not
allowed |
|
| Podsumowanie | Nazwa zawiera niedozwolone słowo. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Użyj dozwolonej nazwy. Więcej informacji znajdziesz w artykule ze specyfikacją pliku danych. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
[price.currency] Please use a currency
that is supported in the target country |
|
| Podsumowanie | Podano walutę, która nie jest dostępna w kraju docelowym. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Sprawdź, czy waluta i kraj są prawidłowo określone. Więcej informacji znajdziesz w sekcji dotyczącej price w artykule w Centrum pomocy specyfikacji pliku danych. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
[storeCode] storeCode must be
'online' |
|
| Podsumowanie | Próbowałam zaktualizować cenę i dostępność produktu dostępnego online za pomocą pliku danych o asortymencie, ale w adresie URL jako identyfikator sklepu określono coś innego niż specjalną wartość online. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Zmień identyfikator sklepu na online w adresie URL żądania. |
| Wskazówki dotyczące profilaktyki | Pamiętaj, by podać atrybut online w przypadku produktów online oraz identyfikator sklepu w przypadku produktów dostępnych lokalnie we wszystkich zapytaniach o asortyment. |
[<attribute>] |
|
| Podsumowanie | Element podany w nawiasach kwadratowych jest nieprawidłowy. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Popraw specyfikację produktu, który sprawia problem. Więcej informacji znajdziesz w tym artykule w Centrum pomocy. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
notFound
Item not found |
|
|---|---|
| Podsumowanie | Element, który próbujesz pobrać, zaktualizować lub usunąć, nie istnieje. |
| Typowe przyczyny | Podjęto próbę usunięcia nieistniejącego produktu lub nieprawidłowe określenie jego identyfikatora w adresie URL do usunięcia. |
| Zalecane wskazówki dotyczące obsługi | Pobierz listę produktów, korzystając z
Products.list, i próbuj tylko pobierać, aktualizować lub usuwać produkty, które się w niej znajdują. Koniecznie podaj identyfikator produktu w formacie channel:languageCode:countryCode:offerId, np. online:ru:RU:277104-ekb, a nie w identyfikatorze oferty, który wygląda tak: 277104-ekb. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
not_inserted
The item could not be
inserted. |
|
|---|---|
| Podsumowanie | Z powodu innych błędów nie udało się wstawić produktu, ponieważ spowodowałoby to zastąpienie dotychczasowego prawidłowego wpisu. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Sprawdź inne błędy związane z tym samym wywołaniem i rozwiąż je przed próbą ponownego wstawienia informacji o nowym produkcie. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
limit
too_many_items: Merchant
quota exceeded |
|
|---|---|
| Podsumowanie | Zbyt wiele produktów zostało przesłanych do Zakupów Google. |
| Typowe przyczyny | Produkty, których nie uda się zweryfikować, mogą zostać dodane, jeśli nie zastępują istniejącego, prawidłowego produktu. Zastanów się nad użyciem flagi
includeInvalidInsertedItems do Productstatuses.list, aby mieć pewność, że na Twoim koncie nie ma zbyt wielu nieprawidłowych produktów. |
| Zalecane wskazówki dotyczące obsługi | Sprawdź i usuń nadmierną liczbę nieprawidłowych produktów zgodnie z opisem powyżej. Dodatkowo podczas przesyłania produktów określ daty ważności. Po upływie daty ważności produkt zostanie automatycznie usunięty. Pamiętaj, że domyślna i maksymalna data ważności to 30 dni po wstawieniu lub aktualizacji produktu. Uwaga: limit produktów na multikoncie klientów jest porównywany z łączną liczbą produktów na wszystkich subkontach. Jeśli ten błąd wystąpi na subkoncie, sprawdź, czy zarówno subkonto, jak i multikonto klientów mają wystarczający limit produktów. Jeśli skorzystasz z tych rozwiązań, a na Twoim koncie Merchant Center wciąż brakuje miejsca na nowe produkty, możesz poprosić o możliwość przesłania na koncie kolejnych produktów. |
| Wskazówki dotyczące profilaktyki | Zobacz Zalecane wskazówki dotyczące obsługi. |
too_many_subaccounts:
Maximum number of subaccounts reached |
|
| Podsumowanie | Masz już maksymalną liczbę subkont dozwolonych w ramach multikonta klientów. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Usuń przestarzałe subkonta. Jeśli wszystkie Twoje konta są aktywne, możesz poprosić o możliwość tworzenia dodatkowych subkont w MCA. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
request_rate_too_high:
Request rate too high. Please reduce your throughput |
|
| Podsumowanie | Żądania są wysyłane zbyt szybko. Zmniejsz ich częstotliwość. |
| Typowe przyczyny | Sprawdź limity na minutę wymienione w opublikowanych limitach. Jeśli przekroczysz te progi, zobaczysz ten błąd. Czasami przyczyną tego problemu jest gwałtowny wzrost ruchu lub serwer rozwija się do większej liczby wątków. |
| Zalecane wskazówki dotyczące obsługi | Zmniejsz łączną liczbę żądań wysyłanych na minutę. |
| Wskazówki dotyczące profilaktyki | Gdy pojawi się ten błąd, użyj strategii automatycznego wycofywania, aby zmniejszyć częstotliwość żądań do odpowiedniego poziomu zrównoważonego. |
daily_limit_exceeded:
merchant quota exceeded |
|
| Podsumowanie | Wysyłasz więcej żądań dziennie niż jest dozwolona dla danej metody usługi. |
| Typowe przyczyny | Zapoznaj się z limitami dziennymi wymienionymi w opublikowanych limitach. Jeśli przekroczysz te progi, zobaczysz ten błąd. |
| Zalecane wskazówki dotyczące obsługi | Zmniejsz łączną liczbę wysyłanych dziennie żądań, łącząc w miarę możliwości wiele zmian w jedno żądanie. Rozważ zbiorcze zmiany produktów we wskazanym okresie, aby uniknąć szybkiej, wielokrotnej zmiany usługi. W przypadku aktualizacji produktów, które mogą być reprezentowane w Twojej witrynie jako mikrodane, rozważ zastosowanie tej metody, aby ograniczyć liczbę wywołań usług Jeśli potrzebujesz jeszcze większej liczby dziennych wywołań danej metody, skontaktuj się z nami i podaj swój identyfikator w Merchant Center oraz metody, w których osiągasz limity, oraz szacowaną liczbę połączeń dziennie do wykorzystania w danej metodzie. Postaramy się też pomóc Ci zwiększyć limit. |
| Wskazówki dotyczące profilaktyki | Zobacz Zalecane wskazówki dotyczące obsługi. |
too_many_failed_auths:
Too many failed authentications. |
|
| Podsumowanie | Wysyłasz zbyt wiele żądań zbiorczych w przypadku kont, do których nie masz dostępu. |
| Typowe przyczyny | Zbiorcze przesyłanie żądań dotyczących usuniętych subkont lub nowo utworzonych subkont, zanim staną się dostępne. |
| Zalecane wskazówki dotyczące obsługi | Unikaj wykonywania połączeń, które wpływają na usunięte subkonto. |
| Wskazówki dotyczące profilaktyki | Zobacz Zalecane wskazówki dotyczące obsługi. |
request_too_large |
|
| Podsumowanie | Wysyłasz zbyt wiele typu entries na żądanie zbiorcze lub przekraczasz limit rozmiaru żądania custombatch. |
| Typowe przyczyny | Możesz uwzględnić maksymalnie 10 000 entries custombatch żądań, a limit rozmiaru skompresowanego transferu wynosi 32 MB. |
| Zalecane wskazówki dotyczące obsługi | Podziel wsad na kilka wsadów, których limity nie przekraczają limitów, a następnie spróbuj jeszcze raz. |
| Wskazówki dotyczące profilaktyki | Zalecamy wysyłanie nie więcej niż 1000 wpisów na wsad. |
wymagane
[price.value] Required parameter: price.value |
|
|---|---|
| Podsumowanie | Podano cenę bez wartości. Na przykład: { "currency": "USD" } zamiast { "value": 123, "currency": "USD" }. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Sprawdź, czy parametr w tym miejscu
price ma prawidłowy format. Na przykład pole price ma 2 wymagane pola: value i currency. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
[product] INSERT request must specify
product |
|
| Podsumowanie | Przesłano do interfejsu API niestandardowe żądanie zbiorcze zawierające wpis z wartością "method": "insert", ale bez produktu. |
| Typowe przyczyny | zapomnisz zmienić metodę na get lub delete; |
| Zalecane wskazówki dotyczące obsługi | Za pomocą pola product określ produkt do wstawienia. |
| Wskazówki dotyczące profilaktyki | Sprawdź, czy wpisy zbiorcze z metodą
insert wskazują produkt, a wpisy zbiorcze z metodą get
lub
delete określają identyfikator produktu. |
[productId] DELETE request must specify
productId |
|
| Podsumowanie | Przesłano do interfejsu API niestandardowe żądanie zbiorcze zawierające wpis z wartością "method": "delete", ale bez identyfikatora produktu. |
| Typowe przyczyny | Zapominam zmienić metodę na insert. |
| Zalecane wskazówki dotyczące obsługi | W polu productID wskaż produkt, który chcesz usunąć. |
| Wskazówki dotyczące profilaktyki | Sprawdź, czy wpisy zbiorcze z metodą
insert wskazują produkt, a wpisy zbiorcze z metodą get
lub
delete określają identyfikator produktu. |
userRateLimitExceeded
User Rate Limit
Exceeded |
|
|---|---|
| Podsumowanie | Żądania są wysyłane zbyt szybko. Zmniejsz ich częstotliwość. |
| Typowe przyczyny | Zapoznaj się z limitami żądań HTTP wymienionymi w limitach opublikowanych. Jeśli przekroczysz te progi, zobaczysz ten błąd. Czasami przyczyną tego problemu jest gwałtowny wzrost ruchu lub serwer rozwija się do większej liczby wątków. |
| Zalecane wskazówki dotyczące obsługi | Zmniejsz łączną liczbę żądań wysyłanych na minutę. Grupowanie wielu wywołań metody do tej samej usługi w jedno żądanie custombatch zmniejszy liczbę wysyłanych żądań HTTP. |
| Wskazówki dotyczące profilaktyki | Gdy pojawi się ten błąd, użyj strategii grupowania i automatycznego wycofywania, aby zmniejszyć częstotliwość żądań do odpowiedniego poziomu zrównoważonego. |
sprawdzanie
[adwords_redirect] |
|
|---|---|
| Podsumowanie | Przesłano produkt, którego pole adwords_redirect nie jest prawidłowym adresem URL. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Sprawdź, czy wartość pola
adwords_redirect jest prawidłowym adresem URL. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
[item] auth/frontend/not_claimed |
|
| Podsumowanie | Adres URL witryny sprzedawcy nie został zarezerwowany w Merchant Center. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Zgłoś prawa do adresu URL w Merchant Center. Szczegółową procedurę znajdziesz w Centrum pomocy. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
[energy_efficiency_class]
validation/feed |
|
| Podsumowanie | Określono zarówno energyEfficiencyClass, jak i
cenę jednostkową tego samego produktu. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Określ tylko klasę efektywności energetycznej lub cenę jednostkową, ale nie obie te wartości. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
[item] internal |
|
| Podsumowanie | Błąd wewnętrzny. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Ponów prośbę. Jeśli błąd będzie się powtarzać, poinformuj nas o tym na forum. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
[item_group_id] invalid_attribute |
|
| Podsumowanie | Przesłano produkt o wartości itemGroupId
i wielu wartościach atrybutu wersji (kolor, rozmiar, wzór lub materiał). |
| Typowe przyczyny | Można określić więcej niż jeden rozmiar produktu przy użyciu identyfikatora grupy produktów. |
| Zalecane wskazówki dotyczące obsługi | Prześlij inny produkt dla każdej wartości danego atrybutu wersji, np.
size. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
[additional_image_link]
invalid_attribute |
|
| Podsumowanie | Przesłano ponad 10 linków do dodatkowego zdjęcia. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Ogranicz liczbę linków do dodatkowych zdjęć do 10. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
[<attribute>] invalid_character |
|
| Podsumowanie | Przesłano markę, opis lub inny atrybut jako ciąg znaków, który nie jest analizowany z użyciem określonego kodowania żądania. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Sprawdź wiadomość, aby dowiedzieć się, który atrybut powoduje problem, a następnie przed ponownym przesłaniem zweryfikuj kodowanie tekstu odpowiedniej wartości. Interfejs API akceptuje tylko prawidłowe znaki UTF-8. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
[<attribute>] invalid_value |
|
| Podsumowanie | Przesłano nieprawidłowy atrybut kolor, opis lub inny nieprawidłowy atrybut. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Sprawdź, czy wszystkie atrybuty są zgodne ze specyfikacją pliku danych. Więcej informacji znajdziesz w tym artykule w Centrum pomocy. Informacje o problemach z numerami GTIN lub MPN znajdziesz w tym artykule w Centrum pomocy. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
[<attribute>]
missing_recommended / missing_required |
|
| Podsumowanie | Przesłano produkt bez wymaganego/zalecanego atrybutu. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Pamiętaj, aby dodać wszystkie zalecane / wymagane atrybuty produktu. Więcej informacji znajdziesz w artykule ze specyfikacją pliku danych w Centrum pomocy. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
[link] validation/invalid_value for
<destinations>: URLs do not belong to your website |
|
| Podsumowanie | Przesłano produkt z podstawowym adresem URL, który różni się od adresu URL zarezerwowanego na koncie Merchant Center. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Sprawdź, czy adresy URL przesłanych produktów są zgodne z witryną, do której zgłoszono prawa w Merchant Center. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |