Limity

Twoje konto sprzedawcy i korzystanie z Merchant API podlegają limitom.

Zaktualizuj zasadę

Interfejs API sprzedawcy egzekwuje te zasady dotyczące aktualizacji:

• Produkty możesz aktualizować maksymalnie 2 razy dziennie.
• Konta podrzędne możesz aktualizować tylko raz dziennie.

Limity wywołań metod

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

Tak śledzimy wykorzystanie limitu:

• Limity dotyczą poszczególnych metod. Na przykład metoda get ma osobny limit od metody update.
• Każde żądanie jest zliczane raz, niezależnie od jego typu. Na przykład żądanie list250 produktówget liczymy jako 1 żądanie, a nie jako 250 żądań.
• Limit jest naliczany na podstawie użytkownika, który wysyła żądanie do interfejsu API. Jeśli użytkownik jest bezpośrednim członkiem konta zaawansowanego, limit zostanie naliczony na poziomie tego konta.
• Limity dotyczą grupy usług porównywania cen, usługi porównywania cen, konta lub subkont, w przypadku których uwierzytelniasz się podczas wywoływania. Jeśli na przykład uwierzytelnienie nastąpi jako konto zaawansowane, wywołania będą wliczane do limitu konta zaawansowanego. Jeśli uwierzytelnienie nastąpi jako jedno z Twoich kont podrzędnych, wywołania będą wliczane do limitu konta podrzędnego.

Diagram przedstawia hierarchię grup usług porównywania cen, usług porównywania cen, kont i subkont.

Zmiany limitów wywołań metod w Content API for Shopping

Jeśli korzystasz z Content API for Shopping, zwróć uwagę na te zmiany limitu wywołań metody w Merchant API:

• Brak niestandardowego przetwarzania wsadowego nie wpływa na obliczanie limitu. Na przykład za żądanie zbiorcze zawierające 500 żądań wstawiania naliczana jest opłata jak za 500 osobnych żądań metody wstawiania.
• Automatyzacja limitów w przypadku kont i usług pozostaje bez zmian.
• Aby sprawdzić bieżące wykorzystanie limitu i limity, w tym automatyzację i zastąpienia, użyj metody Quota.list.

Sprawdzanie limitów wywołań

Aby sprawdzić bieżący limit połączeń i wykorzystanie na koncie, wywołaj quotas.list z name konta.

Automatyczny limit dotyczy tylko usług products i accounts. Jeśli potrzebujesz zwiększonego limitu na dowolną inną usługę, 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
• szacunkową liczbę połączeń dziennie, które są potrzebne w przypadku tych metod;
• powód, dla którego potrzebujesz zwiększenia limitu;
• czy jest to wzrost tymczasowy czy stały;

Zalecamy okresowe sprawdzanie limitów, aby mieć pewność, że masz wystarczającą ilość limitów na potrzeby wdrożenia, lub jak limity są dostosowywane automatycznie.

Błędy

Jeśli przekroczysz limity, zobaczysz 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 połączeń.

Poniższych błędów nie można rozwiązać za pomocą automatycznego zwiększenia limitu. Wymagają one poproszenia 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 konta

Metody accounts.limits.get i accounts.limits.list umożliwiają sprawdzanie limitów dotyczących elementów na poziomie konta. Aby sprawdzić limity produktów, możesz użyć tych metod.

Aby pobrać konkretny limit produktu, np. limit reklam w Europejskim Obszarze Gospodarczym na koncie, musisz podać identyfikator konta i identyfikator limitu w wywołaniu funkcji accounts.limits.get. Identyfikator limitu to połączenie typu i zakresu limitu. Na przykład products~ADS_EEA w przypadku produktów, na które kierowane są reklamy w Europejskim Obszarze Gospodarczym, i products~ADS_NON_EEA w przypadku produktów, na które kierowane są reklamy poza Europejskim Obszarem Gospodarczym.

Oto przykładowe żądanie pobrania limitu products~ADS_EEA dla danego konta:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits/products~ADS_EEA

Aby dowiedzieć się, jakie identyfikatory limitów są dostępne na Twoim koncie, użyj tego zapytania:accounts.limits.list z filtrem type="products":

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/limits?filter=type%3D%22products%22

Więcej informacji o limitach produktów znajdziesz w artykule Omówienie limitów w Google Merchant Center.

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 Merchant API. Te limity są takie same w przypadku Merchant API i odpowiadających im funkcji w Merchant Center.

Pamiętaj, że ta lista limitów może być niekompletna. Nie zwiększymy tych limitów.

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