Limity

Interfejs Content API for Shopping nakłada ścisłe limity na niektóre funkcje. Wszystkie limity i ograniczenia mogą zostać w dowolnym momencie zniesione, zmniejszone lub zmienione bez powiadomienia.

Zasady dotyczące limitów

Nie aktualizuj produktów więcej niż 2 razy dziennie, a subkont więcej niż raz dziennie.

Limity wywołań metod

Content API for Shopping automatycznie dostosowuje limity products i accounts na podstawie Twojego wykorzystania. Wykorzystanie accounts zależy od limitu subkont.

Tak śledzimy wykorzystanie limitu:

  • Limity dotyczą poszczególnych metod. Na przykład metoda get ma osobny limit od metody update.
  • patch wliczają się do limitów getupdate.
  • Każde wywołanie metody w ramach custombatch jest liczone oddzielnie w stosunku do limitu tej metody.
  • Połączenia są wliczane do limitu konta, na którym się uwierzytelniasz, gdy dzwonisz. Jeśli na przykład uwierzytelnienie nastąpi jako konto zaawansowane, wywołania będą wliczane do limitu tego konta. Jeśli uwierzytelnienie nastąpi jako jedno z Twoich kont podrzędnych, wywołania będą wliczane do limitu tego konta podrzędnego.

Sprawdzanie limitów

Aby sprawdzić bieżący limit i wykorzystanie konta, wywołaj funkcję quotas.list z parametrem merchantId konta.

Zalecamy okresowe sprawdzanie limitów, aby mieć pewność, że masz wystarczającą ilość limitów na potrzeby implementacji.

Automatyczny limit dotyczy tylko usług productsaccounts. Jeśli potrzebujesz zwiększonego limitu w przypadku innej usługi, wyczerpujesz dzienny limit usług products lub accounts albo potrzebujesz tymczasowego zwiększenia limitu usług accounts lub produktów services, skontaktuj się z nami i podaj te informacje:

  • Twój identyfikator w Merchant Center.
  • metody, w przypadku których osiągnięto limity.
  • Szacunkowa liczba połączeń dziennie, których potrzebujesz w przypadku tych metod.
  • Powód, dla którego potrzebujesz zwiększenia limitu.

Błędy

Jeśli przekroczysz limity Content API for Shopping, otrzymasz te błędy:

  • Za minutę: quota/request_rate_too_high
  • Dziennie: quota/daily_limit_exceeded

Aby wyświetlić limity i wykorzystanie oraz poprosić o zwiększenie limitu dziennego lub minutowego, zapoznaj się z artykułem Sprawdzanie limitów.

Poniższych błędów nie można rozwiązać przez automatyczne zwiększenie limitu. Wymagają one wysłania prośby o dodatkowy limit produktów, plików danych lub subkont:

  • too_many_items: Merchant quota exceeded
  • too_many_subaccounts: Maximum number of sub-accounts reached

Limity reprezentacji zasobów

Poniższe limity opisują istotne ograniczenia dotyczące niektórych wartości ciągów znaków i pól tablic w reprezentacjach zasobów używanych w Content API. Te limity są takie same w przypadku Content API i odpowiadających im funkcji w Merchant Center. Ta lista limitów może być niekompletna, a tych limitów nie można zwiększyć.

Zasób Pole Limit
shippingsettings

Usługi dostawy na kraj (services).

Grupy dostawy na usługę dostawy (rateGroups).

Etykiety na grupę dostawy (applicableShippingLabels).

Podtabele na grupę dostawy (subtables).

Liczba wierszy lub kolumn w pojedynczej tabeli stawek.

Długość etykiet wysyłki.

20

20

30

100

150

100

Liczba wierszy lub kolumn w tabeli stawek wpływa na te pola tablicy:

  • Pola tablicy w elementach rowHeaders lub columnHeaders:
    • prices[]
    • weights[]
    • numberOfItems[]
    • postalCodeGroupNames[]
    • locations[]
    • rows[]
    • cells[]