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ę, rozłóż równomiernie dzienne wywołania w ciągu dnia.
• Subkonta możesz aktualizować maksymalnie 2 razy dziennie.
• Metody źródła danych, takie jak list czy create, możesz wywoływać maksymalnie 2 razy dziennie na subkonto.

Limity wywołań metod

Merchant API automatycznie dostosowuje limity wywołań w przypadku tych metod:

• products i accounts na podstawie Twojego użytkowania.
• datasources w przypadku kont zaawansowanych na podstawie liczby ich subkont.

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 liczy się 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.
• W przypadku usługi datasources automatyczne skalowanie limitu dotyczy tylko kont zaawansowanych na podstawie liczby ich subkont. Limity dla kont samodzielnych i subkont są statyczne, a ich zwiększenie jest zwykle niemożliwe. Aby sprawdzić limity datasource, użyj accounts.limits metod.
• 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 uwierzytelnisz się jako konto zaawansowane, wywołania będą się liczyć do limitu tego konta. Jeśli uwierzytelnisz się jako jedno z subkont, wywołania będą się liczyć do limitu tego subkonta.

Ten 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 naliczane jako 500 pojedynczych żądań metody wstawienia.
• 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 wywołań

Aby sprawdzić bieżące limity wywołań i wykorzystanie konta, wywołaj quotas.list z name konta.

Automatyczny limit dotyczy usług products, accounts i datasources.

• W przypadku zasobów z automatycznymi limitami (products, accounts i datasources w przypadku kont zaawansowanych): możesz poprosić tylko o tymczasowe zwiększenie limitu w specjalnych sytuacjach, takich jak wprowadzenie na nowy rynek lub w okresach dużego ruchu w okresie świątecznym. W przypadku tego typu zasobów nie akceptujemy trwałych zwiększeń limitu.
• W przypadku wszystkich innych zasobów bez automatycznych limitów: możesz poprosić o zwiększenie limitu w razie potrzeby.

W formularzu kontaktowania się z zespołem pomocy wybierz problem Quota increase request i wypełnij go tymi informacjami:

• 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 trwał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 poproszenia o dodatkowy limit produktów, dodatkowe pliki danych lub subkont:

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