Z tego przewodnika dowiesz się, jakie limity i kwoty obowiązują podczas korzystania z interfejsu Data Manager API.
Limity dotyczące projektu
Aby korzystać z interfejsu Data Manager API, musisz mieć projekt Google Cloud. Projekt w chmurze Google Cloud udostępnia klienta OAuth i dane logowania, których używasz do uwierzytelniania żądań do interfejsu API.
Interfejs Data Manager API wymusza ograniczanie liczby żądań w przypadku każdego projektu Google Cloud, z podziałem na usługę i typ operacji (odczyt i zmiana):
| Usługa | Operacja | Liczba żądań dziennie | Żądania na minutę |
|---|---|---|---|
IngestionService |
Modyfikowanie (zapis) | 100 000 | 300 |
IngestionService |
Odczyt | 100 000 | 300 |
| Wszystkie inne usługi łącznie | Modyfikowanie (zapis) | 50 000 | 300 |
| Wszystkie inne usługi łącznie | Odczyt | 50 000 | 300 |
Żądania przekraczające limity są odrzucane z błędem RESOURCE_EXHAUSTED i stanem HTTP 429 Too Many Requests.
Możesz przejąć kontrolę nad aplikacją i ograniczyć limity szybkości, aktywnie zmniejszając liczbę żądań i ograniczając liczbę zapytań na sekundę po stronie klienta. W konsoli Google Cloud możesz też skonfigurować alerty dotyczące limitów i monitorowanie, aby otrzymywać powiadomienia, zanim aplikacja osiągnie limity.
Nazwy limitów
Każdy limit odpowiada nazwie limitu i rodzajowi danych w Google Cloud. Gdy żądanie przekroczy limit, interfejs Data Manager API zwróci nazwę limitu w ErrorInfo standardowym pakiecie szczegółów w sekcji metadata.quota_limit:
| Nazwa limitu przydziału | Usługa | Operacja | Okno | Limit |
|---|---|---|---|---|
IngestionMutateRequestsPerDayPerProject |
IngestionService |
Mutacja | Dzień | 100 000 |
IngestionMutateRequestsPerMinutePerProject |
IngestionService |
Mutacja | Minuta | 300 |
IngestionReadRequestsPerDayPerProject |
IngestionService |
Odczyt | Dzień | 100 000 |
IngestionReadRequestsPerMinutePerProject |
IngestionService |
Odczyt | Minuta | 300 |
ManagementMutateRequestsPerDayPerProject |
Wszystkie inne usługi | Mutacja | Dzień | 50 000 |
ManagementMutateRequestsPerMinutePerProject |
Wszystkie inne usługi | Mutacja | Minuta | 300 |
ManagementReadRequestsPerDayPerProject |
Wszystkie inne usługi | Odczyt | Dzień | 50 000 |
ManagementReadRequestsPerMinutePerProject |
Wszystkie inne usługi | Odczyt | Minuta | 300 |
Sprawdź metadata.quota_limit w ładunku ErrorInfo, aby odróżnić błędy limitu dziennego od błędów limitu minutowego i określić, czy tymczasowo wstrzymać działanie i ponowić próbę z wycofywaniem, czy wstrzymać działanie do czasu zresetowania dziennego limitu.
Więcej informacji znajdziesz w sekcji Błędy związane z limitem przydziału i ograniczaniem liczby żądań.
Limity żądań
Oto limity dotyczące poszczególnych żądań:
IngestAudienceMembersRequestiRemoveAudienceMembersRequest:10 tys.
AudienceMemberzasobów na liścieaudience_members10 identyfikatorów użytkowników w
UserDatadlaAudienceMember10
Destinationzasobów na liściedestinations
RemoveAllAudienceMembersRequest:- 10
Destinationzasobów na liściedestinations
- 10
-
2000
Eventzasobów na liścieevents10 identyfikatorów użytkowników w
UserDatadlaEvent10
Destinationzasobów na liściedestinations