メールを移行する

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

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 です。移行されたメールの送信者は sampleender@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 というタイトルのメッセージが、他のすべてのユーザーには未読として表示されます。