Limity

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

Zaktualizuj zasadę

Merchant API egzekwuje te zasady dotyczące aktualizacji:

• Produkty możesz aktualizować maksymalnie 2 razy dziennie. Aby zachować zgodność z limitem na minutę, musisz równomiernie rozłożyć dzienne wywołania w ciągu dnia.
• Subkonta możesz aktualizować tylko raz dziennie.

Limity wywołań metod

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

Oto jak śledzimy wykorzystanie limitu:

• Limity są przypisane do poszczególnych metod. Na przykład metoda get ma oddzielny limit od metody update.
• Każde żądanie jest liczone raz, niezależnie od jego typu. Na przykład żądanie list dotyczące 250 produktów liczymy raz, a nie jako 250 żądań get.
• 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łania. Jeśli na przykład uwierzytelniasz się jako konto zaawansowane, wywołania są liczone na poczet limitu tego konta. Jeśli uwierzytelniasz się jako jedno z subkont, wywołania są liczone na poczet limitu tego subkonta.

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 używasz Content API for Shopping, zwróć uwagę na te zmiany limitów wywołań metod w Merchant API:

• Brak niestandardowego grupowania nie wpływa na obliczanie limitu. Na przykład żądanie zbiorcze zawierające 500 żądań wstawienia jest liczone jako 500 pojedynczych żądań metody wstawienia.
• Automatyzacja limitów w przypadku kont i produktów 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żące limity wywołań i wykorzystanie konta, wywołaj quotas.list z name konta.

Automatyczny limit dotyczy tylko usług products i accounts. Jeśli potrzebujesz zwiększonego limitu w przypadku innej usługi, wyczerpujesz dzienny limit w przypadku usług products lub accounts albo potrzebujesz tymczasowego zwiększenia limitu w przypadku usług accounts lub products 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 wywołań dziennie potrzebna w przypadku tych metod
• Powód, dla którego potrzebujesz zwiększenia limitu
• Czy jest to zwiększenie tymczasowe czy stałe

Zalecamy okresowe sprawdzanie limitów, aby upewnić się, że masz wystarczający limit na potrzeby implementacji lub jak limit jest dostosowywany automatycznie.

Błędy

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

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

Aby wyświetlić limit i wykorzystanie oraz poprosić o zwiększenie limitu dziennego lub minutowego przeczytaj artykuł Sprawdzanie limitów wywołań.

Tych błędów nie można rozwiązać za pomocą automatycznego zwiększenia limitu. Wymagają one przesłania prośby o dodatkowy limit produktów, dodatkowe pliki danych lub subkonta:

• too_many_items: Merchant quota exceeded
• too_many_subaccounts: Maximum number of sub-accounts reached

Limity na koncie

Metody accounts.limits.get i accounts.limits.list umożliwiają sprawdzanie limitów dotyczących jednostek na poziomie konta. Za pomocą tych metod możesz sprawdzać limity produktów.

Aby pobrać konkretny limit produktu, np. limit reklam w EOG na koncie, musisz w wywołaniu accounts.limits.getpodać identyfikator konta i identyfikator limitu . Identyfikator limitu to połączenie typu limitu i zakresu. Na przykład products~ADS_EEA w przypadku produktów kierowanych na reklamy w EOG i products~ADS_NON_EEA w przypadku produktów kierowanych na reklamy poza EOG.

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ę więcej o dostępnych identyfikatorach limitów na koncie, użyj 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 Limity 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 będziemy zwiększać 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[]