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.

Zmiany dotyczące limitów między interfejsem Merchant API a Content API for Shopping

  • Limit będzie liczony dla każdego zasobu, a nie metody. Oznacza to, że niektóre usługi są teraz połączone.
  • Brak niestandardowego grupowania nie ma wpływu na obliczanie limitu. Na przykład żądanie zbiorcze zawierające 500 żądań wstawiania będzie obciążone opłatą za 500 osobnych żądań metody wstawiania.
  • Automatyzacja limitów w przypadku kont i usług pozostaje w obowiązku.
  • Aby określić bieżące wykorzystanie limitów i limity, w tym automatyzację i zastąpienia, użyj metody Quota.list.

Limity wywołań metod

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

W ten sposób śledzimy wykorzystanie limitu:

  • Limity są ustalane dla każdej metody. Na przykład metoda get ma osobną pulę niż metoda update.
  • Każde żądanie jest zliczane raz, niezależnie od jego typu. Na przykład żądanie list z 250 elementami liczymy tylko raz, a nie jako 250 żądań get.
  • Limit jest naliczany na podstawie użytkownika, który wysyła żądanie API. Jeśli użytkownik jest bezpośrednio członkiem konta zaawansowanego, limit zostanie obciążony na poziomie tego konta.
  • 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. Grupa usług porównywania cen to ogólny poziom uwierzytelniania, w ramach którego można tworzyć poszczególne usługi porównywania cen, a na nich konta i subkonta jako najbardziej szczegółowy poziom.

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 dla swojej 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ę, zapoznaj się z artykułem 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 interfejsu 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[]