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 champsTo:
,From:
etDate:
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 samplegroup@googlegroups.com. 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/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-mailVoici un exemple d'e-mail au format texte RFC 822 qui a été migré vers l'archive de samplegroup@googlegroups.com. NNNN@mail.samplegroup.com
est l'ID de message de cet exemple. 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 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 samplesender@example.com
s'est connecté à Google Groupes, mais il apparaît comme non lu pour tous les autres utilisateurs.