Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Przenosi wiadomość e-mail do archiwum grupy Google przy użyciu funkcji przesyłania multimediów.
Ta metoda obsługuje identyfikator URI /upload i akceptuje przesłane multimedia o tych cechach:
Maksymalny rozmiar pliku: maksymalny rozmiar wiadomości e-mail to 25 MB. Ten limit obejmuje nagłówki metadanych, treść i wszystkie załączniki.
Akceptowane typy MIME multimediów:message/rfc822
Limit projektów dla interfejsu Groups Migration API to 10 zapytań na sekundę (QPS) na konto. Maksymalna dzienna liczba żądań do interfejsu API to 500 000. Więcej informacji o formacie RFC822 znajdziesz w opisie standardowego formatu RFC822.
Prośba
Żądanie HTTP
POST https://www.googleapis.com/upload/groups/v1/groups/groupId/archive?uploadType=media
Parametry
Nazwa parametru
Wartość
Opis
Parametry ścieżki
groupId
string
Adres e-mail grupy, w której zarchiwizowane są przeniesione e-maile. Ten adres e-mail jest zmienną w ścieżce adresu URL żądania. Jeśli właściciel grupy zmieni adres e-mail grupy w konsoli administracyjnej lub za pomocą interfejsu Directory API, musisz użyć nowego adresu e-mail w zmiennej groupId.
Wymagane parametry zapytania
uploadType
string
Typ żądania przesłania do identyfikatora URI /upload z jedną z tych wartości:
media – proste przesyłanie, które przesyła dane multimedialne.
resumable – przesyłanie z możliwością wznowienia przesyłania pliku w sposób umożliwiający jego wznowienie, wykorzystując serię co najmniej 2 żądań.
Rodzaj zasobu wstawiania. Wartość: groupsmigration#groups
responseCode
string
Kod stanu odpowiedzi interfejsu API na żądanie migracji z kodem stanu HTTP.
Możliwe wartości stanu responseCode:
AUTHORIZATION FAILURE – dane logowania administratora są nieprawidłowe. Zwracany jest kod stanu HTTP 401.
BACKEND FAILURE – serwer wystąpił problem lub jest zajęty. Zwracany jest kod stanu HTTP 503. Za pomocą algorytmu wykładniczego ponowienia odczekaj chwilę, zanim spróbujesz ponownie wykonać nieudane wywołanie.
INVALID MESSAGE FAILURE – e-mail ma nieprawidłowy format. Jeśli wiadomość zostanie odrzucona jako zniekształcona, otrzymasz kod stanu HTTP 400 Bad Request. Przykłady nieprawidłowych formatów:
W wiadomości mogło brakować pól From, To i Date.
Błąd występuje, jeśli wiersz w wiadomości nie jest zakończony znakiem nowego wiersza w stylu CR+LF (czyli "\r\n").
Wiadomość e-mail jest pusta.
Grupa docelowa migracji nie istnieje lub jest w trybie „tylko do odczytu”. Więcej informacji o trybie udostępniania tylko do odczytu znajdziesz w artykule o opcjach udostępniania w Grupach dyskusyjnych Google dla Firm.
SUCCESS – e-mail został zarchiwizowany w archiwum grupy na koncie. Zwracany jest kod stanu HTTP 200.
UNSUPPORTED_PARALLEL_OPERATION – interfejs Groups Migration API nie obsługuje równoległego wstawiania wiadomości w tym samym archiwum grup. Interfejs Groups Migration API nie obsługuje żądań wsadowych. Interfejs Groups Migration API obsługuje jednak równoległe żądania wstawiania e-maili do różnych archiwów grup. Zwracany jest kod stanu HTTP 400.