Limity

Interfejs Content API for Shopping nakłada ścisłe limity na niektóre funkcje. Wszystkie limity i kwoty 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, a subkonta częściej niż raz dziennie.

Limity wywołań metod

Interfejs Content API for Shopping automatycznie dostosowuje limity products i accounts na podstawie Twojego użycia. Korzystanie z accounts zależy od limitu subkont.

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.
  • patch wliczają się do limitów get i update.
  • Każde wywołanie metody w ramach custombatch jest zliczane oddzielnie do limitu tej metody.
  • Połączenia są wliczane do limitu konta, na którym nastąpiło uwierzytelnianie. 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 subkont, połączenia będą liczone w ramach limitu tego subkonta.

Sprawdzanie limitów

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

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

Automatyczna kwota dotyczy tylko usług products i accounts. Jeśli potrzebujesz zwiększenia limitu dla innej usługi, osiągasz dzienny limit 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:

  • Twój identyfikator w Merchant Center.
  • Metody, w przypadku których został osiągnięty limit.
  • Szacunkowa liczba połączeń dziennie, które musisz wykonać w przypadku tych metod.
  • Powód, dla którego potrzebujesz zwiększenia limitu.

Błędy

Jeśli przekroczysz limity Content API for Shopping, pojawią się 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

Podane niżej limity opisują istotne ograniczenia dotyczące niektórych wartości ciągu znaków i pol tablic w reprezentacjach zasobów używanych w Content API. Te limity są takie same zarówno w przypadku Content API, jak i odpowiadającej mu funkcji w Merchant Center. Ta lista limitów może być niepełna, a tych limitów nie można zwiększyć.

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[]