Archive: insert

Esegue la migrazione di un messaggio email nell'archivio del gruppo Google utilizzando il caricamento di contenuti multimediali.

Questo metodo supporta un URI /upload e accetta i contenuti multimediali caricati con le seguenti caratteristiche:

  • Dimensione massima del file:la dimensione massima del messaggio è 25 MB. Questo limite include le intestazioni dei metadati, il corpo e gli eventuali allegati del messaggio.
  • Tipi MIME multimediali accettati: message/rfc822

Il limite di progetti per l'API Groups Migration è di 10 query al secondo (QPS) per account. Il numero massimo di richieste API al giorno è 500.000. Per ulteriori informazioni sul formato RFC822, consulta il formato standard RFC822.

Richiesta

Richiesta HTTP

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

Parametri

Nome del parametro Valore Descrizione
Parametri del percorso
groupId string L'indirizzo email del gruppo in cui viene archiviata l'email di cui è stata eseguita la migrazione. Questo indirizzo email è una variabile nel percorso dell'URL della richiesta. Se un proprietario del gruppo modifica l'indirizzo email del gruppo utilizzando la Console di amministrazione o l'API Directory, devi utilizzare il nuovo indirizzo email nella variabile groupId.
Parametri di query obbligatori
uploadType string

Il tipo di richiesta di caricamento all'URI /upload con uno dei seguenti valori:

  • media: caricamento semplice che carica i dati multimediali.
  • resumable - Caricamento ripristinabile che carica il file in modo da poter essere ripreso, utilizzando una serie di almeno due richieste.

Autorizzazione

Questa richiesta richiede l'autorizzazione con il seguente ambito:

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

Per ulteriori informazioni, consulta la pagina Autenticazione e autorizzazione.

Corpo della richiesta

Non fornire un corpo della richiesta con questo metodo.

Risposta

In caso di esito positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}
Nome proprietà Valore Descrizione
kind string Il tipo di risorsa di inserzione. Valore: groupsmigration#groups
responseCode string

Il codice di stato di una risposta API per una richiesta di migrazione accompagnato dal codice di stato HTTP. I valori dello stato responseCode includono:

AUTHORIZATION FAILURE: le credenziali di autorizzazione dell'amministratore non sono valide. Viene restituito un codice di stato HTTP 401.

BACKEND FAILURE: il server ha un problema o è occupato. Viene restituito un codice di stato HTTP 503. Utilizzando un algoritmo di backoff esponenziale, attendi un breve ritardo prima di riprovare la chiamata non riuscita.

INVALID MESSAGE FAILURE: il messaggio email è in un formato non valido. Se un messaggio viene rifiutato come non valido, ricevi un codice di stato HTTP 400 Bad Request. Ecco alcuni esempi di formati non validi:

  • Nel messaggio potrebbero mancare i campi From, To e Date.
  • Si verifica un errore se una riga del messaggio non è terminata da un a capo stile CR+LF (ovvero "\r\n").
  • Il messaggio email è vuoto.
  • Il gruppo di destinazione della migrazione non esiste o è in modalità di sola lettura. Per ulteriori informazioni sulla modalità di condivisione di sola lettura, consulta le opzioni di condivisione di Google Groups for Business.

SUCCESS: la posta è stata archiviata correttamente nell'archivio del gruppo dell'account. Viene restituito un codice di stato HTTP 200.

UNSUPPORTED_PARALLEL_OPERATION: l'API Groups Migration non supporta le inserzioni parallele di messaggi nello stesso archivio del gruppo. Inoltre, l'API Groups Migration non supporta le richieste batch. Tuttavia, l'API Groups Migration supporta le richieste parallele per le inserzioni di email in archivi di gruppi diversi. Viene restituito un codice di stato HTTP 400.