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 von E-Mail-Nachrichten beträgt 25 MB. Dieses Limit enthält 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 und Konto. Die maximale Anzahl von API-Anfragen pro Tag beträgt 500.000. Weitere Informationen zum RFC822-Format sieh dir die RFC 822-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 migrierte E-Mail archiviert ist. Diese E-Mail-Adresse ist Variable im URL-Pfad der Anfrage. Wenn ein Gruppeninhaber die E-Mail-Adresse der Gruppe ändert entweder in der Admin-Konsole oder über die Directory API, müssen Sie die neue E-Mail-Adresse in die Variable groupId ein.
Erforderliche Abfrageparameter
uploadType string

Die Art der Uploadanfrage an den URI /upload mit einer der folgenden Optionen Werte:

  • media: Einfacher Upload, der die Mediendaten hochlädt.
  • resumable: Fortsetzbarer Upload, bei dem die Datei als fortsetzbare Datei hochgeladen wird mit einer Reihe von mindestens zwei Anfragen.

Autorisierung

Für diese Anfrage ist eine Autorisierung mit folgendem Bereich erforderlich:

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

Weitere Informationen finden Sie in der Authentifizierung und Autorisierung.

Anfragetext

Geben Sie für diese 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 Ressource zum Einfügen. Wert: groupsmigration#groups
responseCode string

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

AUTHORIZATION FAILURE: Die Autorisierungsanmeldedaten des Administrators lauten ungültig. Ein 401-HTTP-Statuscode wird zurückgegeben.

BACKEND FAILURE: Der Server hat ein Problem oder ist ausgelastet. Ein 503-HTTP Statuscode zurückgegeben. Bei Verwendung eines exponentieller Backoff warten Sie 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, erhältst du den HTTP-Statuscode 400 Bad Request. Ungültiges Format Beispiele:

  • Möglicherweise fehlen in der Nachricht die Felder From, To und Date.
  • Ein Fehler tritt auf, wenn eine Zeile im message ist nicht durch einen Zeilenumbruch im Stil CR+LF ("\r\n") beendet.
  • Die E-Mail-Nachricht ist leer.
  • Die Zielgruppe der Migration existiert nicht oder ist schreibgeschützt . Weitere Informationen Informationen zum schreibgeschützten Freigabemodus finden Sie in der Google Groups for Business- Freigabeoptionen nutzen.

SUCCESS – Die E-Mail wurde in der Gruppe des Kontos archiviert. -Archiv. Ein 200-HTTP-Statuscode wird zurückgegeben.

UNSUPPORTED_PARALLEL_OPERATION – Die Groups Migration API tut dies nicht das parallele Einfügen von Nachrichten im selben Gruppenarchiv unterstützt. Die Die Groups Migration API unterstützt keine Batchanfragen. Die Die Groups Migration API unterstützt parallele Anfragen zum Einfügen von E-Mails in verschiedene Gruppenarchiven. Ein 400-HTTP-Statuscode wird zurückgegeben.