Migrazione delle email

Prima di eseguire la migrazione di un'email a Google Gruppi utilizzando l'API Groups Migration, procedi come segue:

  • Prima di eseguire la migrazione di un messaggio email all'archivio del gruppo, verifica che il gruppo di destinazione esista e che l'indirizzo email del gruppo sia corretto. Per saperne di più su come elencare gruppi e utenti, consulta l'API Directory.
  • Se il mittente dell'email ha lo stesso dominio del gruppo di destinazione, verifica che il mittente dell'email esista prima di eseguire la migrazione del messaggio email all'archivio del gruppo di destinazione.
  • Il formato del messaggio email deve essere conforme alla definizione standard RFC 822. Utilizza l'intestazione Content-type: message/rfc822. Verifica che i campi To:, From: e Date: del messaggio email siano formattati correttamente. La risposta viene restituita in formato dei dati JSON.

Eseguire la migrazione di un messaggio email a Google Gruppi

Per eseguire la migrazione di un messaggio email all'archivio di un gruppo, invia una POST richiesta HTTP, includi l'intestazione Authorization e sostituisci GROUP_EMAIL_ADDRESS con l'indirizzo email del gruppo a cui sono destinati i messaggi:

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

Esempio di richiesta

Questo esempio esegue la migrazione dei messaggi email all'archivio samplegroup@googlegroups.com. Content-Length è limitato a 25 MB, inclusi i metadati, il corpo e gli eventuali allegati del messaggio:

POST https://www.googleapis.com/upload/groups/v1/groups/samplegroup@googlegroups.com/archive?uploadType=media
Host: www.googleapis.com
Content-Type: message/rfc822
Content-Length: BYTES
Authorization: Bearer AUTH_TOKEN

METADATA_BODY

Sostituisci quanto segue:

  • BYTES: il numero di byte nell'email.
  • AUTH_TOKEN: l'intestazione Authorization.
  • METADATA_BODY: i metadati, il corpo e gli eventuali allegati dell'email.

Di seguito è riportato un esempio di messaggio email in formato di testo RFC 822 di cui è stata eseguita la migrazione nell'archivio di samplegroup@googlegroups.com. NNNN@mail.samplegroup.com è l'ID messaggio di questo esempio. Il mittente dell'email di cui è stata eseguita la migrazione è samplesender@example.com e l'email viene migrata nell'archivio del gruppo samplegroup@googlegroups.com:

    Received: by 10.143.160.15 with HTTP; Mon, 16 Jul 2007 10:12:26 -0700 (PDT)
    Message-ID: <NNNN@mail.samplegroup.com>
    Date: Mon, 16 Jul 2007 10:12:26 -0700
    From: samplesender@example.com
    To: samplegroup@googlegroups.com
    Subject: SUBJECT
    MIME-Version: 1.0
    Content-Type: text/plain; charset=ISO-8859-1; format=flowed
    Content-Transfer-Encoding: 7bit
    Content-Disposition: inline
    Delivered-To: samplegroup@samplegroup.com

    This is the body of the migrated email message.

Una risposta riuscita restituisce un codice di stato HTTP 200 e lo stato della migrazione. Per saperne di più sui valori di responseCode, consulta il riferimento dell'API Groups Migration.

{
 "kind": "groupsMigration#groups",
 "responseCode": "SUCCESS",
}

Visualizzare i messaggi importati nell'interfaccia di Google Gruppi

In Google Gruppi, lo stato di lettura o non lettura dei thread viene memorizzato separatamente per ogni utente. Quando inserisci messaggi e thread utilizzando l'API Groups Migration, vengono trattati come se fossero stati inviati dall'utente nell'intestazione From:. Ciò significa che vengono visualizzati come non letti per tutti gli utenti, ad eccezione dell'utente il cui indirizzo è nell'intestazione From:. Ad esempio, dopo la richiesta JSON di esempio precedente, il messaggio con titolo SUBJECT viene visualizzato come letto se samplesender@example.com ha eseguito l'accesso a Google Gruppi, ma viene visualizzato come non letto per tutti gli altri utenti.