Transférer des e-mails

Avant de transférer un e-mail vers Google Groupes à l'aide de l'API Groups Migration, effectuez les actions suivantes : suivi

  • Vérifiez que le groupe cible existe et que son adresse e-mail est correcte avant de migrer un message vers l'archive de ce groupe. Pour en savoir plus sur la liste des groupes et des utilisateurs, consultez la documentation de l'API Directory.
  • Si l'expéditeur de l'e-mail a le même domaine que le groupe cible, vérifiez qu'il existe avant de migrer le message vers l'archive du groupe cible.
  • L'e-mail doit être au format Définition standard RFC 822 Utilisez l'en-tête Content-type: message/rfc822. Vérifiez que l'adresse e-mail Le format des champs To:, From: et Date: est correct. La est renvoyée dans JSON format de données.

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 transfère les e-mails vers l'archive exemplegroup@googlegroups.com. La taille maximale de Content-Length est de 25 Mo, y compris les métadonnées, le corps et les pièces jointes du message :

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

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 archive de samplegroup@googlegroups.com. Voici le NNNN@mail.samplegroup.com par exemple Message-ID. L'expéditeur de l'e-mail migré est samplesender@example.com et l'e-mail est migré vers l'archive du groupe 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.

    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 documentation de référence de l'API Groups Migration

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

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

    Dans Google Groupes, les fils de discussion l'état lu/non lu est stocké séparément pour chaque utilisateur. Lorsque vous insérez des messages et des fils de discussion à 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 intitulé SUBJECT s'affiche comme lu si samplesender@example.com est connecté à Google Groups, mais s'affiche comme non lu pour tous les autres utilisateurs.