Archive: insert

Migriert eine E-Mail-Nachricht mithilfe des Medienuploads in das Archiv der Google-Gruppe.

Diese Methode unterstützt einen /upload-URI und akzeptiert hochgeladene Medien mit den folgenden Eigenschaften:

  • Maximale Dateigröße:Die maximale Größe einer E-Mail-Nachricht beträgt 25 MB. Diese Grenze gilt für die Metadaten-Header, den Textkörper und alle Anhänge der Nachricht.
  • Zulässige Medien-MIME-Typen:message/rfc822

Das Projektlimit für die Groups Migration API beträgt 10 Abfragen pro Sekunde pro Konto. Die maximale Anzahl von API-Anfragen pro Tag beträgt 500.000. Weitere Informationen zum RFC822-Format finden Sie unter RFC822-Standardformat.

Anfrage

HTTP-Anfrage

POST https://www.googleapis.com/upload/groups/v1/groups/groupId/archive?uploadType=media

Parameter

Parametername Wert Beschreibung
Pfadparameter
groupId string Die E-Mail-Adresse der Gruppe, in der die migrierten E-Mails archiviert werden. Diese E-Mail-Adresse ist eine Variable im URL-Pfad der Anfrage. Wenn ein Gruppeninhaber die E-Mail-Adresse der Gruppe über die Admin-Konsole oder die Directory API ändert, müssen Sie die neue E-Mail-Adresse in der Variablen groupId verwenden.
Erforderliche Suchparameter
uploadType string

Der Typ der Uploadanfrage an den /upload-URI mit einem der folgenden Werte:

  • media: Einfacher Upload, bei dem die Mediendaten hochgeladen werden.
  • resumable – Fortsetzbarer Upload, bei dem die Datei mit einer Reihe von mindestens zwei Anfragen hochgeladen wird.

Autorisierung

Für diese Anfrage ist eine Autorisierung mit dem folgenden Umfang erforderlich:

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

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Geben Sie bei dieser Methode keinen Anfragetext an.

Antwort

Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}
Name der Eigenschaft Wert Beschreibung
kind string Die Art der einzufügenden Ressource. Wert: groupsmigration#groups
responseCode string

Der Statuscode einer API-Antwort für eine Migrationsanfrage, begleitet vom HTTP-Statuscode. Zu den Statuswerten für responseCode gehören:

AUTHORIZATION FAILURE – Die Autorisierungsanmeldedaten des Administrators sind ungültig. Es wird der HTTP-Statuscode 401 zurückgegeben.

BACKEND FAILURE: Es gibt ein Problem mit dem Server oder er ist ausgelastet. Der HTTP-Statuscode 503 wird zurückgegeben. Warten Sie bei Verwendung eines exponentiellen Backoffs auf eine kleine Verzögerung, bevor Sie den fehlgeschlagenen Aufruf wiederholen.

INVALID MESSAGE FAILURE: Das Format der E-Mail-Nachricht ist ungültig. Wenn eine Nachricht als fehlerhaft abgelehnt wird, erhalten Sie den HTTP-Statuscode 400 Bad Request. Beispiele für ungültige Formate:

  • In der Nachricht fehlen möglicherweise die Felder From, To und Date.
  • Ein Fehler tritt auf, wenn eine Zeile in der Nachricht nicht durch einen CR+LF-Zeilenumbruch ("\r\n") abgeschlossen wird.
  • Die E-Mail-Nachricht ist leer.
  • Die Zielgruppe der Migration existiert nicht oder ist im Lesemodus. Weitere Informationen zum Freigabemodus „Nur lesen“ finden Sie in den Freigabeoptionen für Google Groups for Business.

SUCCESS: Die E-Mail wurde im Gruppenarchiv des Kontos archiviert. Es wird der HTTP-Statuscode 200 zurückgegeben.

UNSUPPORTED_PARALLEL_OPERATION – Die Groups Migration API unterstützt keine parallelen Nachrichteneinträge in dasselbe Gruppenarchiv. Außerdem unterstützt die Groups Migration API keine Batchanfragen. Die Groups Migration API unterstützt jedoch parallele Anfragen für das Einfügen von E-Mails in verschiedene Gruppenarchive. Es wird der HTTP-Statuscode 400 zurückgegeben.