Archive: insert

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ń.

Upoważnienie

To żądanie wymaga autoryzacji w tym zakresie:

Zakres
https://www.googleapis.com/auth/apps.groups.migration

Więcej informacji znajdziesz na stronie uwierzytelniania i autoryzacji.

Treść żądania

Nie podawaj treści żądania z tą metodą.

Odpowiedź

Jeśli operacja się uda, metoda zwróci odpowiedź w następującej strukturze:

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}
nazwa usługi, Wartość Opis
kind string 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.