Oto najczęstsze błędy:
notFound: Nie znaleziono produktu.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: przekroczono limit sprzedawcy.
Poniżej znajdziesz listę błędów w porządku alfabetycznym.
auth/account_access_denied
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 identyfikatorze sprzedawcy docelowego lub brak rejestracji 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 konta w Merchant Center (Ustawienia > Użytkownicy). |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
User is not an administrator of
account <account_number> |
|
| Podsumowanie | Wysłano prośbę o zmodyfikowanie konta, do którego uwierzytelniony użytkownik nie ma uprawnień administracyjnych. |
| 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 wielu sprzecznych operacji w tym samym czasie. |
| Typowe przyczyny | Pojedyncze żądanie zbiorcze zawiera wiele sprzecznych operacji dotyczących tego samego produktu lub wiele sprzecznych operacji dotyczących tego samego produktu zostało przesłanych do Content API w tym samym czasie. |
| Zalecane wskazówki dotyczące obsługi | Zobacz wskazówki dotyczące zapobiegania. |
| Wskazówki dotyczące profilaktyki | Zawierają wszystkie zmiany dotyczące danego produktu w ramach jednej operacji w zestawie żądań zbiorczych. Staraj się unikać wielu jednoczesnych wywołań interfejsu Content API dla tego samego sprzedawcy i kodu sklepu lub zadbaj o to, aby te wywołania nie zawierały nakładających się produktów. |
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 problem nadal występuje, skontaktuj się z nami. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
błąd
Invalid channel:
'<channel>' |
|
|---|---|
| Podsumowanie | Nieprawidłowy kanał podany jako część identyfikatora produktu.
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 | Nieprawidłowy kod kraju podany w identyfikatorze produktu.
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 | Sprawdź, czy identyfikator produktu ma format channel:languageCode:countryCode:offerId, a kod kraju jest prawidłowym kodem kraju w formacie
ISO 3166. |
[item id] Invalid item
id: '<id>' |
|
| Podsumowanie | Nieprawidłowy identyfikator produktu, np. sku123 zamiast online:en:US:sku123. |
| Typowe przyczyny | Określanie 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 w Centrum pomocy na temat specyfikacji pliku danych. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
[price.currency] Please use a currency
that is supported in the target country |
|
| Podsumowanie | Określono walutę, która nie jest dostępna w kraju docelowym. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Upewnij się, że waluta i kraj są podane prawidłowo. Więcej informacji znajdziesz w sekcji pricew artykule w Centrum pomocy dotyczącym specyfikacji pliku danych. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
[storeCode] storeCode must be
'online' |
|
| Podsumowanie | Podczas próby zaktualizowania ceny i dostępności produktu online za pomocą pliku danych o asortymencie podano w adresie URL inny identyfikator sklepu niż wartość specjalna 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 | Upewnij się, że w przypadku produktów online w zapytaniach o asortyment podajesz online, a w przypadku produktów dostępnych lokalnie – identyfikator sklepu. |
[<attribute>] |
|
| Podsumowanie | Element podany w nawiasach kwadratowych jest nieprawidłowy. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Popraw specyfikację problematycznego produktu. Więcej informacji znajdziesz w artykule w Centrum pomocy na temat specyfikacji pliku danych. |
| 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 | Próba usunięcia produktu, który nie istnieje, lub nieprawidłowe podanie identyfikatora produktu w adresie URL przeznaczonym do usunięcia. |
| Zalecane wskazówki dotyczące obsługi | Pobierz listę produktów za pomocą metody
Products.list i spróbuj pobrać, zaktualizować lub usunąć tylko elementy, które się na niej znajdują. Upewnij się, że w formularzu podajesz identyfikator produktu, np. channel:languageCode:countryCode:offerId, a nie identyfikator oferty, który wygląda tak: 277104-ekb.online:ru:RU: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 można było wstawić produktu, ponieważ spowodowałoby to zastąpienie istniejącego prawidłowego wpisu. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Sprawdź inne błędy dotyczące tego samego wywołania i rozwiąż je, zanim spróbujesz ponownie wstawić nowe informacje o produkcie. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
limit
too_many_items: Merchant
quota exceeded |
|
|---|---|
| Podsumowanie | Przesłano zbyt wiele produktów do Zakupów Google. |
| Typowe przyczyny | Produkty, których nie udało się zweryfikować, mogą nadal zostać wstawione, jeśli nie zastępują istniejącego, prawidłowego produktu. Rozważ użycie flagi includeInvalidInsertedItems, aby Productstatuses.list i mieć pewność, że na Twoim koncie nie ma zbyt wielu nieprawidłowych produktów. |
| Zalecane wskazówki dotyczące obsługi | Sprawdź, czy nie ma zbyt wielu nieprawidłowych produktów, i usuń je, jak opisano powyżej. Podczas przesyłania produktów podaj też daty ważności. Po osiągnięciu daty ważności produkt jest automatycznie usuwany. Pamiętaj, że domyślna i maksymalna data ważności to 30 dni od wstawienia lub aktualizacji produktu. Uwaga: limit liczby produktów na multikoncie klientów jest sprawdzany na podstawie łącznej liczby produktów na wszystkich subkontach. Jeśli ten błąd pojawi się na subkoncie, sprawdź, czy zarówno subkonto, jak i MCA mają wystarczający limit produktów. Jeśli po wypróbowaniu tych rozwiązań nadal brakuje Ci miejsca na nowe produkty na koncie Merchant Center, możesz poprosić o możliwość przesyłania większej liczby produktów na koncie. |
| 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ę kont podrzędnych dozwolonych na Twoim koncie klienta zbiorczego. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Usuń nieaktualne subkonta. Jeśli wszystkie Twoje konta są aktywne, możesz poprosić o możliwość utworzenia na multikoncie klientów dodatkowych subkont. |
| 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 częstotliwość żądań. |
| Typowe przyczyny | Zapoznaj się z limitami na minutę podanymi w opublikowanych limitach. Jeśli przekroczysz te progi, pojawi się ten błąd. Czasami jest to spowodowane nagłym wzrostem natężenia ruchu lub zwiększeniem liczby wątków na serwerze. |
| Zalecane wskazówki dotyczące obsługi | Zmniejsz łączną liczbę żądań wysyłanych na minutę. |
| Wskazówki dotyczące profilaktyki | Gdy otrzymasz ten błąd, użyj strategii wycofywania programowego, aby zmniejszyć częstotliwość wysyłania żądań do odpowiedniego, zrównoważonego poziomu. |
daily_limit_exceeded:
merchant quota exceeded |
|
| Podsumowanie | Wysyłasz więcej żądań dziennie, niż jest to dozwolone w przypadku danej metody usługi. |
| Typowe przyczyny | Zapoznaj się z limitami dziennymi podanymi w opublikowanych limitach. Jeśli przekroczysz te progi, pojawi się ten błąd. |
| Zalecane wskazówki dotyczące obsługi | Zmniejsz łączną liczbę żądań wysyłanych dziennie, łącząc w miarę możliwości kilka zmian w jedno żądanie. Rozważ wprowadzanie zmian w produktach w odpowiednim okresie, aby uniknąć szybkiego zmieniania produktu wiele razy. W przypadku aktualizacji produktów, które można przedstawić jako mikrodane w witrynie, rozważ użycie tego podejścia, aby ograniczyć liczbę wywołań usług Jeśli nadal potrzebujesz więcej wywołań dziennie danej metody, skontaktuj się z nami i podaj nam swój identyfikator Merchant Center, metody, w przypadku których osiągasz limity, szacunkową liczbę wywołań dziennie, których potrzebujesz w przypadku tych metod, oraz powód, dla którego ich potrzebujesz. Postaramy się zwiększyć Twój 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 dotyczących kont, do których nie masz dostępu. |
| Typowe przyczyny | Wysyłanie próśb w przypadku usuniętych subkont lub nowo utworzonych subkont, zanim staną się dostępne. |
| Zalecane wskazówki dotyczące obsługi | Unikaj wywoływania funkcji, które mają wpływ na usunięte subkonto. |
| Wskazówki dotyczące profilaktyki | Zobacz zalecane wskazówki dotyczące obsługi. |
request_too_large |
|
| Podsumowanie | W żądaniu zbiorczym wysyłasz zbyt wiele entries lub przekraczasz limit rozmiaru żądania custombatch. |
| Typowe przyczyny | Możesz dodać maksymalnie 10 tys. entries na custombatch żądanie, a limit skompresowanego rozmiaru transferu wynosi 32 MB. |
| Zalecane wskazówki dotyczące obsługi | Podziel partię na kilka partii, które nie przekraczają limitów, a potem spróbuj jeszcze raz. |
| Wskazówki dotyczące profilaktyki | Zalecamy wysyłanie nie więcej niż 1000 wpisów w jednej partii. |
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 przypadku
price, jest prawidłowo sformatowany. Na przykład tag price ma 2 pola wymagane: 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 | Zapomnienie o zmianie metody na get lub delete. |
| Zalecane wskazówki dotyczące obsługi | Wskaż produkt, który chcesz wstawić, w polu product. |
| Wskazówki dotyczące profilaktyki | Upewnij się, że wpisy w partii z metodą
insert określają produkt, a wpisy w partii 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 parametrem "method": "delete", ale bez identyfikatora produktu. |
| Typowe przyczyny | Zapomnienie zmiany metody na insert. |
| Zalecane wskazówki dotyczące obsługi | Określ produkt do usunięcia za pomocą pola productID. |
| Wskazówki dotyczące profilaktyki | Upewnij się, że wpisy w partii z metodą
insert określają produkt, a wpisy w partii z metodą
get
lub
delete określają identyfikator produktu. |
userRateLimitExceeded
User Rate Limit
Exceeded |
|
|---|---|
| Podsumowanie | Żądania są wysyłane zbyt szybko. Zmniejsz częstotliwość żądań. |
| Typowe przyczyny | Zapoznaj się z limitami żądań HTTP wymienionymi w opublikowanych limitach. Jeśli przekroczysz te progi, pojawi się ten błąd. Czasami jest to spowodowane nagłym wzrostem natężenia ruchu lub zwiększeniem liczby wątków na serwerze. |
| 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 jednym żądaniu custombatch zmniejszy liczbę wysyłanych żądań HTTP. |
| Wskazówki dotyczące profilaktyki | Gdy otrzymasz ten błąd, użyj strategii grupowania i programowego wycofywania, aby zmniejszyć częstotliwość wysyłania żądań do odpowiedniego, zrównoważonego poziomu. |
walidacja
[adwords_redirect] |
|
|---|---|
| Podsumowanie | przesłano produkt, którego pole adwords_redirect nie zawiera prawidłowego adresu 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 | Nie zgłoszono praw do adresu URL witryny sprzedawcy w Merchant Center. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Zgłoś prawa do adresu URL w Merchant Center. Szczegółowa procedura jest dostępna 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ą dla 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 oba te atrybuty. |
| 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 problem nadal występuje, skontaktuj się z nami. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
[item_group_id] invalid_attribute |
|
| Podsumowanie | Przesłano produkt z atrybutem itemGroupId
i wieloma wartościami atrybutu wersji (kolor, rozmiar, wzór lub materiał). |
| Typowe przyczyny | określanie więcej niż jednego rozmiaru produktu przy jednoczesnym podawaniu 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 więcej niż 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 przy użyciu 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 sprawdź 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 kolor, opis lub inny atrybut, który jest nieprawidłowy. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Upewnij się, że wszystkie atrybuty są zgodne ze specyfikacją pliku danych. Więcej informacji znajdziesz w artykule w Centrum pomocy na temat specyfikacji pliku danych. W przypadku problemów z numerem GTIN lub MPN zapoznaj się z tym artykułem w Centrum pomocy. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |
[<attribute>]
missing_recommended / missing_required |
|
| Podsumowanie | Przesłano produkt bez wymaganego lub zalecanego atrybutu. |
| Typowe przyczyny | Nie dotyczy |
| Zalecane wskazówki dotyczące obsługi | Pamiętaj, aby uwzględnić wszystkie zalecane i wymagane atrybuty produktu. Więcej informacji znajdziesz w artykule w Centrum pomocy na temat specyfikacji pliku danych. |
| 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ą zgłoszoną w Merchant Center. |
| Wskazówki dotyczące profilaktyki | Nie dotyczy |