Limity wykorzystania

Limity wykorzystania chronią infrastrukturę Google przed zautomatyzowanymi procesami, które korzystają z interfejsu Display & Video 360 API w niewłaściwy sposób. Zapewniają, że działania jednego dewelopera nie będą miały negatywnego wpływu na całą społeczność.

Limity żądań do interfejsu API

Interfejs Display & Video 360 API używa 2 typów limitów:

  • Łączne limity, do których wliczają się wszystkie odpowiednie żądania.
  • Zapisz limity limitu, z którymi będą się liczyć wszystkie odpowiednie żądania wysyłane do metod zapisu. Metody zapisu to metody takie jak create, patch, delete i bulkEdit, które modyfikują zasoby. Pamiętaj, że niektóre metody zużywają większy limit zapisu niż inne.

Jeśli Twój projekt przekracza którykolwiek z tych limitów, może wystąpić ograniczenie.

Limit dla całego projektu

Poniższe domyślne limity są wspólne dla wszystkich zasobów i metod interfejsu Display & Video 360 API:

  • Łączna liczba żądań na minutę na projekt: 1500
  • Liczba żądań zapisu na minutę na projekt: 700

Limity żądań dla poszczególnych reklamodawców

Metody określające identyfikator reklamodawcy w adresie URL żądania wliczają się do dodatkowych limitów „na reklamodawcę na projekt”.

Wszystkie żądania z identyfikatorem reklamodawcy określonym w ścieżce adresu URL – np. do usług advertisers.lineItems, advertisers.creatives lub advertisers.channels – będą wliczane do tych limitów:

  • Łączna liczba żądań na minutę na reklamodawcę na projekt: 300
  • Liczba żądań zapisu na minutę na reklamodawcę w projekcie: 150

Metody wymagające dużej ilości pracy

Poniższe metody interfejsu API wymagają intensywnego zapisu, co oznacza, że wykorzystują one znaczną ilość zasobów usług i w rezultacie zużywają większy limit żądań zapisu niż inne żądania zapisu.

Podczas obliczania wykorzystania limitu żądań zapisu żądania wysyłane do metod intensywnie wymagających zapisu są liczone jako 5 zapytań zapisu. Na przykład 100 standardowych żądań zapisu i 21 żądań intensywnie wymagających zapisu (z których żadne nie określa reklamodawcy) wykonanych w ciągu minuty zostanie zliczone jako 205 zapytań zapisu (100 + (21 * 5) = 205), co spowoduje przekroczenie obecnego ogólnego limitu żądań zapisu wynoszącego 200 zapytań zapisu na minutę.

Te metody są uznawane za wymagające intensywnego zapisu:

Przekroczenie limitu

W mało prawdopodobnym przypadku niepowodzenia żądania z powodu przekroczenia limitu żądań do interfejsu API interfejs API zwraca kod stanu HTTP i przyczyną błędu. Poza tym treść odpowiedzi zawiera szczegółowy opis przyczyny błędu.

Na liście poniżej znajdziesz możliwe błędy i zalecane działania w przypadku niepowodzenia żądań spowodowanych przekroczeniem limitów żądań do interfejsu API.

Kod RPC przekaz, Zalecane działanie
429 RESOURCE_EXHAUSTED Zasób został wyczerpany (np. sprawdź limit). Sprawdź wykorzystanie w Konsoli interfejsów API Google i zmodyfikuj przepływ pracy, aby lepiej dopasować żądania przesyłane w ramach różnych reklamodawców lub w bardziej ogólny sposób spowolnić częstotliwość wysyłania żądań.

Nie można prosić o zwiększenie limitów w ramach limitów interfejsu Display & Video 360 API.