メールを移行する

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」というタイトルのメッセージが既読になりますが、それ以外のユーザーには未読として表示されます。