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 |