Archive: insert

Przenoszenie wiadomości e-mail do archiwum grupy Google za pomocą przesyłania multimediów.

Ta metoda obsługuje identyfikator URI /upload i akceptuje przesył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 wiadomości.
  • Akceptowane typy MIME multimediów: message/rfc822

Limit projektu interfejsu Groups Migration API wynosi 10 zapytań na sekundę (QPS) na konto. Maksymalna liczba żądań interfejsu API dziennie to 500 tys. Więcej informacji o formacie RFC 822 znajdziesz w standardzie RFC 822.

Żądanie

Żą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 przeniesione e-maile są archiwizowane. Ten adres e-mail jest zmienną w ścieżce adresu URL żądania. Jeśli właściciel grupy zmieni adres e-mail grupy za pomocą konsoli administracyjnej lub interfejsu Directory API, w zmiennej groupId musisz użyć nowego adresu e-mail.
Wymagane parametry zapytania
uploadType string

Typ żądania przesyłania do identyfikatora URI /upload z jedną z tych wartości:

  • media – proste przesyłanie, które przesyła dane multimedialne.
  • resumable – wznawialne przesyłanie, w którym przesyłany jest plik w sposób możliwy do wznowienia z użyciem serii co najmniej 2 żądań.

Autoryzacja

To żądanie wymaga autoryzacji z tym zakresem:

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

Więcej informacji znajdziesz na stronie Uwierzytelnianie i autoryzacja.

Treść żądania

W przypadku tej metody nie podawaj treści żądania.

Odpowiedź

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

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}
Nazwa usługi Wartość Opis
kind string Rodzaj wstawiania zasobu. Wartość: groupsmigration#groups
responseCode string

Kod stanu odpowiedzi interfejsu API dla żądania migracji z kodem stanu HTTP. Wartości stanu responseCode obejmują:

AUTHORIZATION FAILURE – dane uwierzytelniające administratora są nieprawidłowe. Zwracany jest kod stanu HTTP 401.

BACKEND FAILURE – serwer ma problem lub jest zajęty. Zwracany jest kod stanu HTTP 503. Korzystając z algorytmu wykładniczego ponowienia, poczekaj z niewielkim opóźnieniem i spróbuj ponownie wykonać nieudane wywołanie.

INVALID MESSAGE FAILURE – wiadomość e-mail ma nieprawidłowy format. Jeśli wiadomość zostanie odrzucona jako źle sformatowana, otrzymasz kod stanu HTTP 400 Bad Request. Przykłady nieprawidłowego formatu:

  • W wiadomości mogą brakować pól From, To i Date.
  • Błąd wystąpi, jeśli wiersz w wiadomości nie jest zakończony znakiem nowej linii 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 reżimie udostępniania tylko do odczytu znajdziesz w artykule Opcje udostępniania w Grupach dyskusyjnych Google dla firm.

SUCCESS – wiadomość została zarchiwizowana 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 do tego samego archiwum grupy. Ponadto interfejs API migracji grup nie obsługuje żądań zbiorczych. Interfejs Groups Migration API obsługuje jednak równoległe żądania dotyczące wstawiania e-maili do różnych archiwów grup. Zwracany jest kod stanu HTTP 400.