メールを移行する

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: メールのメタデータ、本文、添付ファイル。

以下は、RFC 822 テキスト形式のメール メッセージの例です。samplegroup@googlegroups.com のアーカイブに移行されました。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 というタイトルのメッセージは既読として表示されますが、他のすべてのユーザーに対しては未読として表示されます。