Limity

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

Zaktualizuj zasadę

Interfejs API sprzedawcy egzekwuje te zasady dotyczące aktualizacji:

• Produkty możesz aktualizować maksymalnie 2 razy dziennie. Aby zachować zgodność z limitem połączeń na minutę, rozłóż połączenia dziennie równomiernie w ciągu dnia.
• Konta podrzędne możesz aktualizować tylko raz dziennie.

Limity wywołań metod

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

Tak śledzimy wykorzystanie limitu:

• Limity są przypisane do poszczególnych metod. Na przykład metoda get ma limit niezależny od metody update.
• Każde żądanie jest zliczane raz, niezależnie od jego typu. Na przykład żądanie list250 produktów liczymy raz, a nie jako 250 get żą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 konta zaawansowanego.
• Limity dotyczą grupy usług porównywania cen, konta usługi porównywania cen lub subkont, w przypadku których uwierzytelniasz się podczas wywoływania. Jeśli na przykład uwierzytelniasz się jako konto zaawansowane, wywołania są wliczane do limitu konta zaawansowanego. Jeśli natomiast uwierzytelniasz się jako jedno z subkont, wywołania są wliczane do limitu subkonta.

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

Zmiany limitu wywołań metody w Content API for Shopping

Jeśli używasz Content API for Shopping, zwróć uwagę na te zmiany limitów wywołań metod w Merchant API:

• Brak niestandardowego przetwarzania zbiorczego nie wpływa na obliczanie limitu. Na przykład żądanie zbiorcze zawierające 500 żądań wstawiania jest rozliczane jako 500 osobnych żądań metody wstawiania.
• Automatyzacja limitów w przypadku kont i produktów pozostaje bez zmian.
• Aby określić bieżące wykorzystanie limitu i limity, w tym automatyzację i zastąpienia, użyj metody Quota.list.

Sprawdzanie limitów połączeń

Aby sprawdzić bieżące limity 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 dla innej usługi, 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
• Szacunkowa liczba połączeń dziennie, których potrzebujesz 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ący limit na potrzeby implementacji lub wiesz, jak limit jest dostosowywany automatycznie.

Błędy

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

• Za minutę: quota/request_rate_too_high
• Dziennie: quota/daily_limit_exceeded

Aby wyświetlić limit i użycie 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ć przez automatyczne zwiększenie 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 podmiotów na poziomie konta. Możesz ich używać do sprawdzania limitów produktów.

Aby pobrać limit konkretnego produktu, np. limit reklam w Europejskim Obszarze Gospodarczym na koncie, musisz w wywołaniu funkcji accounts.limits.get podać identyfikator konta i identyfikator limitu. Identyfikator limitu to połączenie typu limitu i zakresu. Na przykład products~ADS_EEA w przypadku produktów kierujących reklamy w Europejskim Obszarze Gospodarczym i products~ADS_NON_EEA w przypadku produktów kierujących reklamy poza Europejski Obszar Gospodarczy.

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 kodu: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 dotyczących liczby 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[]