Limity

Funkcje interfejsu Merchant API mają ścisłe limity.

Zaktualizuj zasadę

Interfejs Merchant API egzekwuje te zasady dotyczące aktualizacji:

  • Produkty możesz aktualizować maksymalnie 2 razy dziennie.
  • Subkonta możesz aktualizować tylko raz dziennie.

Limity wywołań metod

Interfejs Merchant API automatycznie dostosowuje limity wywołań products i accounts na podstawie Twojego wykorzystania.

W ten sposób śledzimy wykorzystanie limitu:

  • Limity są ustalane dla każdej metody. Na przykład metoda get ma osobną kwotę niż metoda update.
  • Każde żądanie jest liczone raz, niezależnie od jego typu. Na przykład żądanie list z 250 elementami jest zliczane tylko raz, a nie jako 250 żądań get.
  • Limity dotyczą grupy usług porównywania cen (CSS), usługi porównywania cen, konta lub podkont, na których dokonujesz uwierzytelniania podczas wywołania. Jeśli na przykład uwierzytelnisz się jako konto zaawansowane, połączenia będą liczone w ramach limitu konta zaawansowanego, ale jeśli uwierzytelnisz się jako jedno z podkont, połączenia będą liczone w ramach limitu podkonta.

Diagram pokazuje hierarchię grup usług porównywania cen, usług porównywania cen, kont i podkont.Ilustracja pokazująca, że grupa usług porównywania cen to ogólny poziom uwierzytelniania, z możliwością korzystania z poszczególnych usług porównywania cen w ramach tych kont i subkont jako najbardziej szczegółowego poziomu.

Sprawdzanie limitów

Aby sprawdzić bieżący limit i wykorzystanie na koncie, zadzwoń pod numer quotas.list, podając name konta.

Automatyczna kwota dotyczy tylko usług products i accounts. Jeśli potrzebujesz zwiększenia limitu dla jakiejkolwiek innej usługi, osiągasz dzienny limit dla usług products lub accounts albo potrzebujesz tymczasowego zwiększenia limitu dla usług accounts lub produktów services, skontaktuj się z nami i podaj te informacje:

  • Identyfikator w Merchant Center
  • Metody, w których przypadku osiągnięto limity dotyczące liczby wystąpień
  • szacunkowa liczba połączeń dziennie, których potrzebujesz do stosowania tych metod;
  • Powód, dla którego potrzebujesz zwiększenia limitu
  • czy jest to wzrost tymczasowy czy trwały;

Zalecamy okresowe sprawdzanie limitów, aby mieć pewność, że masz wystarczającą ilość limitów na potrzeby implementacji, lub jak Twój limit jest dostosowywany automatycznie.

Błędy

Jeśli przekroczysz limity, zobaczysz te błędy:

  • Za minutę: quota/request_rate_too_high
  • Na dzień: quota/daily_limit_exceeded

Aby wyświetlić limity i wykorzystanie oraz poprosić o zwiększenie limitu na dzień lub minutę, przeczytaj artykuł Sprawdzanie limitów.

Automatyczne zwiększanie limitów nie rozwiąże tych błędów. Musisz poprosić o dodatkowy limit produktów, dodatkowych 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ągu znaków i polów tablic w reprezentacjach zasobów używanych w interfejsie Merchant API. Te limity są takie same zarówno w przypadku Merchant API, jak i odpowiadającej mu funkcji w Merchant Center.

Pamiętaj, że ta lista limitów może być niekompletna. Nie przedłużymy tych limitów.

Zasób Pole Limit
shippingsettings

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

Grupy dostaw według usługi dostawy (rateGroups).

Etykiety na grupę dostawy (applicableShippingLabels).

Podtabele według grupy 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 rowHeaders lub columnHeaders:
    • prices[]
    • weights[]
    • numberOfItems[]
    • postalCodeGroupNames[]
    • locations[]
    • rows[]
    • cells[]