Groups Migration API を使用して Google グループにメールを移行する前に、次のことを行います。
- メール メッセージをそのグループのアーカイブに移行する前に、ターゲット グループが存在し、グループのメールに間違いがないことをご確認ください。グループとユーザーの一覧表示の詳細については、Directory API をご覧ください。
- メールの送信者がターゲット グループと同じドメインを持っている場合は、メール メッセージをターゲット グループのアーカイブに移行する前に、メール送信者が存在することを確認してください。
- メール メッセージは、RFC 822 標準定義に従って作成する必要があります。
Content-type: message/rfc822
ヘッダーを使用します。メール メッセージのTo:
、From:
、Date:
の各フィールドの形式が正しいことを確認します。レスポンスは JSON データ形式で返されます。
メールを Google グループに移行する
メール メッセージをグループのアーカイブに移行するには、POST
HTTP リクエストを送信し、Authorization
ヘッダーを含めます。GROUP_EMAIL_ADDRESS
は、メッセージの送信先となるグループのメールアドレスに置き換えます。
POST https://www.googleapis.com/upload/groups/v1/groups/GROUP_EMAIL_ADDRESS/archive?uploadType=media
リクエストの例
この例では、メールを samplegroup@googlegroups.com アーカイブに移行しています。Content-Length
は 25 MB に制限されており、これにはメッセージのメタデータ、本文、添付ファイルが含まれます。
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
次のように置き換えます。
BYTES
: メールのバイト数。AUTH_TOKEN
: Authorization
ヘッダー。METADATA_BODY
: メールのメタデータ、本文、添付ファイル。次に、samplegroup@googlegroups.com のアーカイブに移行された RFC 822 テキスト形式のメール メッセージの例を示します。NNNN@mail.samplegroup.com
はこの例の Message-ID です。移行されたメールの送信者は samplesender@example.com であり、メールは 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.
成功すると、200
HTTP ステータス コードと移行ステータスが返されます。responseCode
値の詳細については、Groups Migration API リファレンスをご覧ください。
{ "kind": "groupsMigration#groups", "responseCode": "SUCCESS", }
インポートしたメッセージを Google グループのインターフェースに表示する
Google グループでは、スレッドの既読状態と未読状態はユーザーごとに別々に保存されます。Groups Migration API を使用してメッセージやスレッドを挿入した場合、From:
ヘッダーでユーザーから送信されたものとして扱われます。つまり、From:
ヘッダーにアドレスが記載されているユーザーを除き、すべてのユーザーで未読として表示されます。たとえば、前述の JSON リクエストの例より、samplesender@example.com
が Google グループにログインした場合は「SUBJECT
」というタイトルのメッセージが既読になりますが、それ以外のユーザーには未読として表示されます。