Transférer des e-mails

Avant de migrer un e-mail vers Google Groupes à l'aide de l'API Groups Migration, procédez comme suit :

• Vérifiez que le groupe cible existe et que l'adresse e-mail du groupe est exacte avant de migrer un e-mail vers les archives de ce groupe. Pour en savoir plus sur les groupes de fiches et les utilisateurs, consultez la page API Directory.
• Si l'expéditeur de l'e-mail appartient au même domaine que le groupe cible, vérifiez que l'expéditeur de l'e-mail existe avant de migrer l'e-mail vers les archives du groupe cible.
• Le format du message électronique doit respecter la définition standard RFC 822. Utilisez l'en-tête Content-type: message/rfc822. Vérifiez que les champs To:, From: et Date: de l'e-mail sont au bon format. La réponse est renvoyée au format de données JSON.

Transférer un e-mail vers Google Groupes

Pour migrer un e-mail vers l'archive d'un groupe, envoyez une requête HTTP POST, incluez l'en-tête Authorization et remplacez GROUP_EMAIL_ADDRESS par l'adresse e-mail du groupe auquel les messages sont destinés:

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

Exemple de requête

Cet exemple migre les e-mails vers l'archive [e-mail]. Le fichier Content-Length est limité à 25 Mo et inclut les métadonnées, le corps et les éventuelles pièces jointes du message:

POST https://www.googleapis.com/upload/groups/v1/groups/[e-mail]/archive?uploadType=media
Host: www.googleapis.com
Content-Type: message/rfc822
Content-Length: BYTES
Authorization: Bearer Auth token

METADATA_BODY

Remplacez les éléments suivants :

BYTES: nombre d'octets de l'e-mail.

AUTH_TOKEN: en-tête Authorization.

METADATA_BODY: métadonnées, corps et pièces jointes de l'e-mail

Voici un exemple d'e-mail au format texte RFC 822 qui a été migré vers l'archive de [e-mail]. [e-mail] est l'ID de message de cet exemple. L'expéditeur de l'e-mail migré est [e-mail] et l'e-mail est migré vers l'archive du groupe [e-mail]:

    Received: by 10.143.160.15 with HTTP; Mon, 16 Jul 2007 10:12:26 -0700 (PDT)
    Message-ID: <[e-mail]>
    Date: Mon, 16 Jul 2007 10:12:26 -0700
    From: [e-mail]
    To: [e-mail]
    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: [e-mail]

    This is the body of the migrated email message.

Une réponse réussie renvoie un code d'état HTTP 200 et l'état de la migration. Pour en savoir plus sur les valeurs responseCode, consultez la documentation de référence de l'API Groups Migration.

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

Afficher les messages importés dans l'interface de Google Groupes

Dans Google Groupes, l'état de lecture/non lu des fils de discussion est stocké séparément pour chaque utilisateur. Lorsque vous insérez des messages et des threads à l'aide de l'API Groups Migration, ils sont traités comme s'ils avaient été envoyés par l'utilisateur dans l'en-tête From:. Cela signifie qu'ils apparaissent comme non lus pour tous les utilisateurs, à l'exception de celui dont l'adresse figure dans l'en-tête From:. Par exemple, après l'exemple de requête JSON précédent, le message SUBJECT apparaît comme lu si [e-mail] s'est connecté à Google Groupes, mais il apparaît comme non lu pour tous les autres utilisateurs.