Diese Seite wurde von der Cloud Translation API übersetzt.

Archive: insert

Migriert eine E-Mail-Nachricht per Medienupload 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 Dateigröße für E-Mails beträgt 25 MB. Dieses Limit umfasst die Metadatenheader, den Nachrichtentext 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.

Anfragen

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 Abfrageparameter
`uploadType`	`string`	Der Typ der Uploadanfrage an den URI `/upload` mit einem der folgenden Werte: `media`: Einfacher Upload, mit dem die Mediendaten hochgeladen werden. `resumable`: fortsetzbarer Upload, bei dem die Datei fortsetzbar in einer Reihe von mindestens zwei Anfragen hochgeladen wird

Autorisierung

Für diese Anfrage ist eine Autorisierung in folgendem Bereich 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 Dies ist die Art der Einfügeressource. Wert: groupsmigration#groups

Name der Eigenschaft	Wert	Beschreibung
`kind`	`string`	Dies ist die Art der Einfügeressource. Wert: `groupsmigration#groups`
`responseCode`	`string`	Der Statuscode einer API-Antwort für eine Migrationsanfrage mit dem HTTP-Statuscode. Die `responseCode`-Statuswerte umfassen Folgendes: `AUTHORIZATION FAILURE`: Die Anmeldedaten des Administrators sind ungültig. Der HTTP-Statuscode `401` wird zurückgegeben. `BACKEND FAILURE`: Auf dem Server ist ein Problem aufgetreten oder er ist überlastet. Der HTTP-Statuscode `503` wird zurückgegeben. Warten Sie mit einem exponentiellen Backoff-Algorithmus eine kleine Verzögerung, bevor Sie den fehlgeschlagenen Aufruf wiederholen. `INVALID MESSAGE FAILURE`: Die E-Mail-Nachricht hat ein ungültiges Format. Wenn eine Nachricht als fehlerhaft abgelehnt wurde, 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 Zeilenumbruch im Stil CR+LF (d. h. `"\r\n"`) beendet wird. Die E-Mail-Nachricht ist leer. Die Zielgruppe der Migration ist nicht vorhanden oder befindet sich im Lesemodus. Weitere Informationen zum schreibgeschützten Freigabemodus finden Sie in den Freigabeoptionen von Google Groups for Business. `SUCCESS`: Die E-Mail wurde erfolgreich im Gruppenarchiv des Kontos archiviert. Der HTTP-Statuscode `200` wird zurückgegeben. `UNSUPPORTED_PARALLEL_OPERATION`: Die Groups Migration API unterstützt kein paralleles Einfügen von Nachrichten in dasselbe Gruppenarchiv. Außerdem unterstützt die Groups Migration API keine Batchanfragen. Die Groups Migration API unterstützt jedoch parallele Anfragen zum Einfügen von E-Mails in verschiedene Gruppenarchive. Der HTTP-Statuscode `400` wird zurückgegeben.

responseCode

string

Der Statuscode einer API-Antwort für eine Migrationsanfrage mit dem HTTP-Statuscode. Die responseCode-Statuswerte umfassen Folgendes:

AUTHORIZATION FAILURE: Die Anmeldedaten des Administrators sind ungültig. Der HTTP-Statuscode 401 wird zurückgegeben.

BACKEND FAILURE: Auf dem Server ist ein Problem aufgetreten oder er ist überlastet. Der HTTP-Statuscode 503 wird zurückgegeben. Warten Sie mit einem exponentiellen Backoff-Algorithmus eine kleine Verzögerung, bevor Sie den fehlgeschlagenen Aufruf wiederholen.

INVALID MESSAGE FAILURE: Die E-Mail-Nachricht hat ein ungültiges Format. Wenn eine Nachricht als fehlerhaft abgelehnt wurde, 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 Zeilenumbruch im Stil CR+LF (d. h. "\r\n") beendet wird.
Die E-Mail-Nachricht ist leer.
Die Zielgruppe der Migration ist nicht vorhanden oder befindet sich im Lesemodus. Weitere Informationen zum schreibgeschützten Freigabemodus finden Sie in den Freigabeoptionen von Google Groups for Business.

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

UNSUPPORTED_PARALLEL_OPERATION: Die Groups Migration API unterstützt kein paralleles Einfügen von Nachrichten in dasselbe Gruppenarchiv. Außerdem unterstützt die Groups Migration API keine Batchanfragen. Die Groups Migration API unterstützt jedoch parallele Anfragen zum Einfügen von E-Mails in verschiedene Gruppenarchive. Der HTTP-Statuscode 400 wird zurückgegeben.