Limity

W Content API for Shopping obowiązują ścisłe limity dotyczące niektórych funkcji. Wszystkie limity mogą zostać usunięte, zmniejszone lub zmienione w dowolnym momencie bez powiadomienia.

Zasady dotyczące limitów

Nie aktualizuj produktów częściej niż 2 razy dziennie i nie aktualizuj subkont częściej niż raz dziennie.

Limity wywołań metody

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

Oto jak śledzimy wykorzystanie limitu:

  • Limity dotyczą poszczególnych metod. Na przykład metoda get ma inny limit niż metoda update.
  • patch metod wlicza się do limitu get i update.
  • Każde wywołanie metody w obiekcie custombatch jest wliczane do limitu tej metody oddzielnie.
  • Połączenia są wliczane do limitu uwierzytelnionego konta. Jeśli na przykład uwierzytelnisz się jako konto zaawansowane, wywołania wliczają się do limitu konta zaawansowanego, ale jeśli uwierzytelnisz się jako jedno z subkont, połączenia te wliczają się do limitu subkonta.

Sprawdzanie limitów

Aby sprawdzić bieżący limit i wykorzystanie na koncie, wywołaj funkcję quotas.list przy użyciu merchantId konta.

Zalecamy okresowe sprawdzanie limitów, aby mieć pewność, że ilość miejsca na implementację jest wystarczająca.

Automatyczny limit dotyczy tylko usług products i accounts. Jeśli potrzebujesz zwiększonego limitu na jakąkolwiek inną usługę, przekraczasz dzienny limit usług products lub accounts albo potrzebujesz tymczasowego zwiększenia limitu liczby accounts lub produktów (services), skontaktuj się z nami i podaj te informacje:

  • Twój identyfikator w Merchant Center.
  • metody, które osiągnęły limit.
  • szacowaną dzienną liczbę połączeń potrzebnych w przypadku tych metod;
  • Powody zwiększenia limitu.

Błędy

Jeśli przekroczysz limity Content API for Shopping, wystąpią 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 dziennego lub minutowego limitu, zobacz Sprawdzanie limitów.

Tych błędów nie można usunąć za pomocą automatycznego zwiększania limitu i wymagają zażądania dodatkowego limitu produktów, plików danych lub subkont:

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

Ograniczenia reprezentacji zasobów

Poniższe limity opisują ważne ograniczenia dotyczące niektórych wartości ciągów i pól tablicy w reprezentacjach zasobów używanych w Content API. Te limity są takie same w przypadku Content API i odpowiadającej im funkcji w Merchant Center. Ta lista limitów może być niekompletna i nie można ich zwiększać.

Zasób Pole Limit
shippingsettings

Usługi dostawy według kraju (services).

Liczba grup dostawy na usługę dostawy (rateGroups).

Liczba etykiet 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 obrębie rowHeaders lub columnHeaders:
    • prices[]
    • weights[]
    • numberOfItems[]
    • postalCodeGroupNames[]
    • locations[]
    • rows[]
    • cells[]