Limity wykorzystania

Limity użycia chronią infrastrukturę Google przed zautomatyzowanymi procesami, które wykorzystują interfejs API Display & Video 360 w nieodpowiedni sposób. Dzięki temu działania jednego dewelopera nie będą miały negatywnego wpływu na całą społeczność.

Limity żądań interfejsu API

Interfejs Display & Video 360 API stosuje 2 rodzaje limitów:

• Łączne limity kwoty, które dotyczą wszystkich odpowiednich próśb.
• Limity limitów zapisu, które uwzględniają wszystkie żądania wysłane do metod zapisu. Metody zapisu to metody (np. create, patch, delete lub bulkEdit), które modyfikują zasoby. Pamiętaj, że niektóre metody zużywają więcej miejsca na zapisywanie niż inne.

Jeśli projekt przekroczy którykolwiek z tych limitów, może zostać ograniczony.

Limit na potrzeby projektu

Wszystkie zasoby i metody interfejsu Display & Video 360 API mają te domyślne limity kwoty:

• Łączna liczba żądań na minutę w danym projekcie: 1500
• Liczba żądań zapisu na minutę w poszczególnych projektach: 700

Limity żądań reklamodawców

Metody, które podają identyfikator reklamodawcy w adresie URL żądania, są wliczane do dodatkowych limitów „na reklamodawcę na projekt”.

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

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

Metody intensywnie wykorzystujące zapis

Podane niżej metody interfejsu API są intensywnie korzystające z funkcji zapisu, co oznacza, że wykorzystują znaczną ilość zasobów produktu, a w konsekwencji zużywają więcej limitu żądań zapisu niż inne żądania zapisu.

Żądania wysyłane do metod o wysokim natężeniu zapisu są podczas obliczania wykorzystania limitu żądań zapisu liczone jako 5 zapytań zapisu. Na przykład 100 standardowych żądań zapisu i 21 intensywnych żądań zapisu (żadne z nich nie określa reklamodawcy) wysłanych w ciągu minuty zostanie policzonych jako 205 zapytań zapisu (100 + (21 * 5) = 205) i przekroczy obecny limit ogólnego limitu żądań wynoszący 200 żądań zapisu na minutę.

Te metody są uważane za metody intensywnie korzystające z funkcji zapisu:

• customBiddingAlgorithms.scripts.create
• customBiddingAlgorithms.uploadScript
• firstPartyAndPartnerAudiences.create
• firstPartyAndPartnerAudiences.editCustomerMatchMembers
• media.upload

Przekroczenie limitów zasobu

W niewielkiej liczbie przypadków żądanie może się nie udać z powodu przekroczenia limitu żądań interfejsu API. W takim przypadku interfejs API zwraca kod stanu HTTP i przyczynę błędu. Dodatkowo treść odpowiedzi zawiera szczegółowy opis przyczyny błędu.

Na liście poniżej znajdziesz informacje o możliwych błędach i zalecanych działaniach w przypadku błędów żądań spowodowanych przekroczeniem limitów żądań do interfejsu API.

Nie można zwiększać limitów interfejsu Display & Video 360 API.