Typowe błędy
Oto najczęstsze błędy:
Poniżej znajduje się lista błędów w porządku alfabetycznym.
uwierzytelnianie/odmowa_dostępu_do_konta
User cannot access account
<account_number> |
---|
Podsumowanie | Przesłano żądanie kierowane na konto, do którego uwierzytelniony użytkownik nie ma dostępu. |
Typowe przyczyny | Błąd w docelowym identyfikatorze sprzedawcy lub zapomniałeś 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 konta w Merchant Center (Ustawienia > Użytkownicy). |
Wskazówki dotyczące profilaktyki | Nie dotyczy |
User is not an administrator of
account <account_number> |
---|
Podsumowanie | Przesłano 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ę przeprowadzenia kilku sprzecznych operacji jednocześnie. |
Typowe przyczyny | Pojedyncze żądanie zbiorcze zawiera wiele operacji powodujących konflikt dotyczących tej samej usługi lub wiele operacji powodujących konflikt dotyczących tej samej usługi zostało przesłanych do interfejsu Content API jednocześnie. |
Zalecane wskazówki dotyczące obsługi | Zobacz wskazówki na temat zapobiegania. |
Wskazówki dotyczące profilaktyki | Zawierać wszystkie zmiany dotyczące danej usługi w pojedynczej operacji w zbiorze żądań. Unikaj wielu równoczesnych wywołań Content API dla tego samego kodu sprzedawcy i kodu sklepu lub upewnij się, że te wywołania nie zawierają 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 | Spróbuj ponownie.
Jeśli problem będzie się powtarzał, skontaktuj się z nami. |
Wskazówki dotyczące profilaktyki | Nie dotyczy |
błąd
Invalid channel:
'<channel>' |
---|
Podsumowanie | W identyfikatorze 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 | W identyfikatorze 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 | Pamiętaj, że 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 | 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 | Pamiętaj, że identyfikator produktu musi mieć format channel:languageCode:countryCode:offerId . |
[name] The term '<term>' is not
allowed |
---|
Podsumowanie | Nazwa zawiera zabronione 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 dotyczącym 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 | Sprawdź, czy waluta i kraj są prawidłowo określone. Więcej informacji znajdziesz w sekcji na temat price w artykule na temat specyfikacji pliku danych w Centrum pomocy. |
Wskazówki dotyczące profilaktyki | Nie dotyczy |
[storeCode] storeCode must be
'online' |
---|
Podsumowanie | Próbowaliśmy zaktualizować cenę i dostępność produktu online za pomocą pliku danych o asortymencie, ale w adresie URL podano coś innego niż wartość specjalna online . |
Typowe przyczyny | Nie dotyczy |
Zalecane wskazówki dotyczące obsługi | Zmień identyfikator sklepu w adresie URL żądania na online . |
Wskazówki dotyczące profilaktyki | Pamiętaj, aby określić online w przypadku produktów online i 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 | Napraw specyfikację problemu. Więcej informacji znajdziesz w artykule w Centrum pomocy ze specyfikacjami 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óbujesz usunąć produkt, który nie istnieje, lub nie podano poprawnego identyfikatora produktu w adresie URL do usunięcia. |
Zalecane wskazówki dotyczące obsługi | Uzyskaj listę produktów za pomocą atrybutu
Products.list i spróbuj tylko pobrać, zaktualizować lub usunąć elementy, które się w niej znajdują. Pamiętaj, aby podać identyfikator produktu w formularzu channel:languageCode:countryCode:offerId , np.: online:ru:RU:277104-ekb , a nie w postaci identyfikatora 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 istniejącego dobrego wpisu. |
Typowe przyczyny | Nie dotyczy |
Zalecane wskazówki dotyczące obsługi | Sprawdź inne błędy dla tego samego wywołania i rozwiąż je, zanim spróbujesz ponownie wstawić nowe informacje o produkcie. |
Wskazówki dotyczące profilaktyki | Nie dotyczy |
przydział
too_many_items: Merchant
quota exceeded |
---|
Podsumowanie | Przesłano zbyt wiele produktów do Zakupów Google. |
Typowe przyczyny | Produkty, których weryfikacja się nie powiodła, mogą zostać wstawione, jeśli nie zastępują istniejącego, prawidłowego produktu. Rozważ użycie flagi
includeInvalidInsertedItems do Productstatuses.list , aby mieć pewność, że na Twoim koncie nie ma nadmiernej liczby nieprawidłowych produktów. |
Zalecane wskazówki dotyczące obsługi | Sprawdź i usuń nadmierną liczbę nieprawidłowych produktów, jak opisaliśmy powyżej. Podczas przesyłania produktów określ też
daty ważności. Po osiągnięciu daty ważności usługa zostanie automatycznie usunięta. Pamiętaj, że domyślna i maksymalna data wygaśnięcia to 30 dni po wstawieniu lub zaktualizowaniu produktu.
Uwaga: porównujemy limit produktów na multikoncie klientów w stosunku do łą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 usług.
Jeśli po wypróbowaniu tych rozwiązań na koncie Merchant Center nadal kończy Ci się miejsce na nowe produkty, możesz
poprosić o możliwość przesłania większej liczby 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ą dozwoloną liczbę subkont na multikoncie klientów. |
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 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 częstotliwość ich wysyłania. |
Typowe przyczyny | Sprawdź limity na minutę wymienione w opublikowanych limitach. Jeśli przekroczysz te progi, pojawi się ten błąd. Czasami powoduje to nagłe zwiększenie 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 zobaczysz ten błąd, użyj strategii automatycznego ponawiania, aby zmniejszyć odsetek żądań do odpowiedniego, zrównoważonego poziomu. |
daily_limit_exceeded:
merchant quota exceeded |
---|
Podsumowanie | Przekraczasz dozwoloną liczbę żądań dziennie dla danej metody usługi. |
Typowe przyczyny | Sprawdź limity dzienne wymienione 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, gdy to możliwe, łącząc wiele zmian w 1 żądaniu. Rozważ wprowadzenie zmian w produktach w odpowiednim okresie, aby uniknąć wielokrotnej szybkiej zmiany produktu. W przypadku aktualizacji produktów, które mogą być reprezentowane w witrynie jako mikrodane, rozważ zastosowanie tej metody w celu ograniczenia liczby wywołań usług Products lub Inventory .
Jeśli nadal potrzebujesz więcej codziennych wywołań danej metody, skontaktuj się z nami i podaj swój identyfikator w Merchant Center, metody, w których osiągasz limity, oraz szacunkową liczbę połączeń dziennie, których potrzebujesz w przypadku tych metod, oraz przybliżoną liczbę połączeń dziennie. Pomożemy 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 dla 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ę one dostępne. |
Zalecane wskazówki dotyczące obsługi | Unikaj wykonywania połączeń, 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 | Wysyłasz za dużo elementów typu entries na żądanie zbiorcze lub przekraczasz limit rozmiaru żądania custombatch . |
Typowe przyczyny | Możesz uwzględnić maksymalnie 10 000 entries na żądanie custombatch , a limit rozmiaru skompresowanego transferu danych to 32 MB. |
Zalecane wskazówki dotyczące obsługi | Podziel wsad na kilka partii, które nie będą przekraczać limitów, i spróbuj jeszcze raz. |
Wskazówki dotyczące profilaktyki | Zalecamy wysyłanie nie więcej niż 1000 wpisów na grupę. |
wymagane
[price.value] Required parameter: price.value |
---|
Podsumowanie | Określono 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 (
price ) ma prawidłowy format. Na przykład price ma 2 wymagane pola: value i currency . |
Wskazówki dotyczące profilaktyki | Nie dotyczy |
[product] INSERT request must specify
product |
---|
Podsumowanie | Do interfejsu API przesłano niestandardowe żądanie zbiorcze zawierające wpis z "method": "insert" , ale bez produktu. |
Typowe przyczyny | Zapominasz zmienić metodę na get lub delete . |
Zalecane wskazówki dotyczące obsługi | W polu product określ usługę do wstawienia. |
Wskazówki dotyczące profilaktyki | Upewnij się, że wpisy zbiorcze z metodą
insert określają produkt, a wpisy zbiorcze z metodą get
lub
delete – identyfikator produktu. |
[productId] DELETE request must specify
productId |
---|
Podsumowanie | Do interfejsu API przesłano niestandardowe żądanie zbiorcze zawierające wpis z "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 do usunięcia. |
Wskazówki dotyczące profilaktyki | Upewnij się, że wpisy zbiorcze z metodą
insert określają produkt, a wpisy zbiorcze z metodą get
lub
delete – identyfikator produktu. |
userRateLimitExceeded
User Rate Limit
Exceeded |
---|
Podsumowanie | Żądania są wysyłane zbyt szybko; zmniejsz częstotliwość ich wysyłania. |
Typowe przyczyny | Zapoznaj się z limitami żądań HTTP podanymi w opublikowanych limitach. Jeśli przekroczysz te progi, pojawi się ten błąd. Czasami może to być spowodowane nagłym wzrostem 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ń metod do tej samej usługi w jedno żądanie custombatch zmniejsza liczbę wysyłanych żądań HTTP. |
Wskazówki dotyczące profilaktyki | Gdy zobaczysz ten błąd, użyj strategii grupowania i automatycznego ponawiania, aby zmniejszyć liczbę żądań do odpowiedniego, zrównoważonego poziomu. |
weryfikacja
[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 | W Merchant Center nie zgłoszono praw do adresu URL witryny sprzedawcy. |
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 atrybut energyEfficiencyClass , jak i
cena jednostkowa tego samego produktu. |
Typowe przyczyny | Nie dotyczy |
Zalecane wskazówki dotyczące obsługi | Określ tylko klasę efektywności energetycznej lub cenę jednostkową, a nie obie. |
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 | Spróbuj ponownie.
Jeśli problem będzie się powtarzał, skontaktuj się z nami. |
Wskazówki dotyczące profilaktyki | Nie dotyczy |
[item_group_id] invalid_attribute |
---|
Podsumowanie | Przesłano produkt, który zawiera zarówno atrybut itemGroupId , jak i wiele wartości atrybutu wersji (kolor, rozmiar, wzór lub materiał). |
Typowe przyczyny | Określ więcej niż jeden rozmiar dla produktu oraz identyfikator 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órego nie można przeanalizować za pomocą określonego kodowania żądania. |
Typowe przyczyny | Nie dotyczy |
Zalecane wskazówki dotyczące obsługi | Sprawdź komunikat, aby dowiedzieć się, który atrybut powoduje problem, a następnie sprawdź kodowanie tekstu odpowiedniej wartości i prześlij ją ponownie. 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 dotyczącym 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/zalecanego atrybutu. |
Typowe przyczyny | Nie dotyczy |
Zalecane wskazówki dotyczące obsługi | Pamiętaj, aby dodać wszystkie zalecane lub wymagane atrybuty. Więcej informacji znajdziesz w artykule na temat specyfikacji 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, którego podstawowy adres URL różni się od adresu URL zgłoszonego przez konto Merchant Center. |
Typowe przyczyny | Nie dotyczy |
Zalecane wskazówki dotyczące obsługi | Sprawdź, czy adresy URL przesłanych produktów są zgodne z witrynami, do których zgłoszono prawa w Merchant Center. |
Wskazówki dotyczące profilaktyki | Nie dotyczy |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2024-07-03 UTC.
[null,null,["Ostatnia aktualizacja: 2024-07-03 UTC."],[[["This guide outlines common errors when using the Google Merchant API, categorized for easier understanding."],["Errors can relate to authentication, data conflicts, invalid data, missing information, or exceeding usage limits."],["Solutions include verifying user permissions, correcting product data, and adjusting request frequency."],["Refer to linked resources for detailed specifications, usage limits, and account management."],["This guide aids in troubleshooting and preventing common issues when interacting with the Google Merchant API."]]],["The document details errors within the Merchant API, which is the future version of the Content API for Shopping. Key errors involve `notFound` (item does not exist), `not_inserted` (cannot insert due to conflicts), and `quota/too_many_items` (exceeded upload limits). Handling involves verifying product IDs, addressing conflicting entries, and managing quotas. Common causes include incorrect IDs, simultaneous conflicting operations, and exceeding item limits. Prevention focuses on formatting product IDs correctly, batching changes, reducing invalid products, and using product expiration dates. Other errors such as account access, internal issues, URL, currency, ID, and missing parameters are covered.\n"]]