Ważne: 18 sierpnia 2026 r. wycofamy interfejs Content API for Shopping.

Poznaj Merchant API – oficjalną usługę, która zastąpi Content API for Shopping.

Najnowsze informacje o nowych funkcjach, poprawkach błędów i aktualizacjach interfejsu Merchant API.

Zacznij korzystać z Merchant API i uzyskaj dostęp do danych, statystyk i wyjątkowych możliwości na dużą skalę.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Typowe błędy

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 `price`w 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 `Products` lub `Inventory`. 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