Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
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:
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.