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:

  • Dimensioni massime del file:la dimensione massima di un messaggio email è 25 MB. Questo limite include intestazioni, corpo ed eventuali allegati dei metadati del messaggio.
  • Tipi MIME multimediali accettati: message/rfc822

Il limite di progetto 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 è archiviata l'email di cui è stata eseguita la migrazione. Questo indirizzo email è una variabile nel percorso dell'URL della richiesta. Se il proprietario di un 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 ricerca obbligatori
uploadType string

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

  • media: caricamento semplice che consente di caricare i dati multimediali.
  • resumable: caricamento ripristinabile che carica il file in un modo ripristinabile, utilizzando una serie di almeno due richieste.

Autorizzazione

Questa richiesta richiede un'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 il corpo di una 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 inserimento. Valore: groupsmigration#groups
responseCode string

Il codice di stato della risposta API per una richiesta di migrazione accompagnato dal codice di stato HTTP. I valori di 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 leggero ritardo prima di riprovare la chiamata non riuscita.

INVALID MESSAGE FAILURE: il formato del messaggio email non è valido. Se un messaggio viene rifiutato in quanto non valido, riceverai 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 nel messaggio non viene terminata da una nuova riga in 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 l'inserimento di messaggi in parallelo nello stesso archivio di gruppi. Inoltre, l'API Groups Migration non supporta le richieste batch. Tuttavia, l'API Groups Migration supporta le richieste parallele di inserimento di email in diversi archivi di gruppo. Viene restituito un codice di stato HTTP 400.