Groups Migration API: limity i limity

Limity i limity chronią infrastrukturę Google przed automatycznym procesem, który w nieodpowiedni sposób korzysta z interfejsu Groups Migration API. Nadmierna liczba żądań z interfejsu API może wynikać z nieszkodliwej literówki lub nieskutecznego systemu, który wykonuje niepotrzebne wywołania interfejsu API. Niezależnie od przyczyny zablokowanie ruchu z określonego źródła po osiągnięciu określonego poziomu jest konieczne dla ogólnego stanu systemu Google Workspace.

Nieudane żądania do interfejsu API

W mało prawdopodobnym przypadku niepowodzenia żądania do interfejsu API aplikacja otrzyma odpowiedź z kodem stanu HTTP. Kod stanu HTTP 403 zawiera informacje o błędach dotyczących nieprawidłowych danych wejściowych, a kod stanu HTTP 503 – informacje o błędzie wskazujące, które limity interfejsu API zostały przekroczone. Te odpowiedzi pozwalają aplikacji niestandardowej wykrywać te błędy i podejmować odpowiednie działania.

Żądania pilne dotyczące czasu

Jeśli żądania muszą zostać zrealizowane w ustalonym czasie, wysyłaj je równolegle lub korzystaj z wielu wątków w aplikacji w języku Java lub C#. Możesz na przykład podzielić żądania według miesiąca lub innego okresu. W przypadku wątków spróbuj zacząć od 10 wątków – po 1 wątku na żądanie. Rekomendacja dotycząca wątków ma wady i nie jest przydatna we wszystkich sytuacjach związanych z interfejsami API. Jeśli liczba żądań staje się zbyt duża, występują błędy limitu.

Błędy czasowe

W przypadku wszystkich błędów, które są uzależnione od czasu (maksymalnie N rzeczy przez X sekund w wątku), zwłaszcza w przypadku błędów kodu stanu 503, zalecamy wychwycenie kodu wyjątku i za pomocą algorytmu wykładniczego ponowienia odczekać z niewielkim opóźnieniem przed ponowną próbą nieudanego wywołania. Przykładem interfejsu Groups Migration API w przypadku jednego wątku jest odczekanie 5 sekund i ponowienie nieudanego wywołania. Jeśli żądanie się powiedzie, powtórz ten wzorzec dla innych wątków. Jeśli drugie żądanie się nie powiedzie, aplikacja powinna skalować się wstecz zgodnie z częstotliwością żądania, aż wywołanie się powiedzie. Możesz na przykład zwiększyć początkowe opóźnienie o 5 sekund do 10 sekund i ponowić nieudane połączenie. Określ też limit ponownych prób. W przypadku ] (przykład:) ponawiaj żądanie 5–7 razy z różnymi czasami opóźnienia. Po tym czasie aplikacja zwróci błąd użytkownikowi.

Ograniczenia

Kategorie ograniczeń interfejsu API Ograniczenia
Zapytania na sekundę (QPS) Limit projektów dewelopera to 10 zapytań na sekundę na konto.

Limity

Kategorie limitów interfejsu API Limity
Maksymalna dzienna liczba żądań do interfejsu API Maksymalna dzienna liczba żądań do interfejsu API to 500 000.
Archiwum, data wygaśnięcia wiadomości Archiwa grupy nie tracą ważności. Wiadomości pozostają w archiwum do czasu usunięcia grupy. Zasada przechowywania e-maili nie ma wpływu na wiadomości w archiwum grupy.
Rozmiar wiadomości e-mail Maksymalny rozmiar e-maila to 25 MB. Ten limit obejmuje nagłówki metadanych, treść i wszystkie załączniki wiadomości.

Inne rodzaje limitów

Inne limity Ograniczenia i wytyczne
Formaty typów treści E-mail musi być w standardowym formacie tekstowym RFC 822. Podczas przesyłania przeniesionych e-maili typ treści żądania musi używać nagłówka Content-type: message/rfc822.
Format danych w odpowiedziach interfejsu API Format danych odpowiedzi to JavaScript Object Notation (JSON).
Zasady dotyczące lokalizacji danych Interfejs Groups Migration API nie obsługuje zasad dotyczących lokalizacji danych, które ze względów umownych wymagają przechowywania danych w określonych granicach geograficznych lub politycznych. Nie używaj interfejsu Groups Migration API, jeśli lokalizacja danych jest wymagana na Twoim koncie.
Równoległe wstawianie wiadomości Interfejs Groups Migration API obsługuje równoległe żądania wstawiania e-maili w różnych archiwach grup. Interfejs Groups Migration API nie obsługuje jednak równoległego wstawiania wiadomości do tego samego archiwum grup. Ta wersja interfejsu Groups Migration API nie obsługuje również żądań zbiorczych.
Nieautoryzowane żądania Interfejs Groups Migration API nie akceptuje żadnych nieautoryzowanych żądań. Żądanie jest uznawane za nieautoryzowane, jeśli nie podano tokena autoryzacji. Więcej informacji znajdziesz w artykule o uwierzytelnianiu i autoryzacji.