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.
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.
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.
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.
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.
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.
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["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."]]],[]]