Di chuyển email

Trước khi di chuyển email sang Google Groups bằng Groups Migration API, hãy làm như sau:

  • Xác nhận rằng nhóm mục tiêu tồn tại và email của nhóm đó chính xác trước khi di chuyển nội dung email vào kho lưu trữ của nhóm đó. Để biết thêm thông tin về cách liệt kê nhóm và người dùng, hãy xem Directory API.
  • Nếu người gửi email có cùng miền với nhóm mục tiêu, hãy xác nhận rằng người gửi email tồn tại trước khi di chuyển nội dung email vào kho lưu trữ của nhóm mục tiêu.
  • Định dạng nội dung email phải tuân theo định nghĩa tiêu chuẩn RFC 822. Sử dụng tiêu đề Content-type: message/rfc822. Xác nhận rằng các trường To:, From: và Date: của thư điện tử được định dạng đúng cách. Phản hồi được trả về ở định dạng dữ liệu JSON.

Di chuyển nội dung email sang Google Groups

Để di chuyển một nội dung email vào kho lưu trữ của nhóm, hãy gửi yêu cầu POST HTTP, thêm tiêu đề Authorization và thay thế GROUP_EMAIL_ADDRESS bằng địa chỉ email của nhóm mà thư đó được gửi đến:

POST https://www.googleapis.com/upload/groups/v1/groups/GROUP_EMAIL_ADDRESS/archive?uploadType=media

Ví dụ về yêu cầu

Ví dụ này di chuyển thư đến kho lưu trữ samplegroup@googlegroups.com. Content-Length bị giới hạn ở mức 25 MB, bao gồm cả siêu dữ liệu, nội dung và mọi tệp đính kèm của thư:

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

Thay thế nội dung sau:

  • BYTES: số byte trong email.
  • AUTH_TOKEN: tiêu đề Authorization.
  • METADATA_BODY: siêu dữ liệu, nội dung và mọi tệp đính kèm của email.

Sau đây là ví dụ về một nội dung email ở định dạng văn bản RFC 822 đã được di chuyển vào kho lưu trữ của samplegroup@googlegroups.com. NNNN@mail.samplegroup.com là Message-ID của ví dụ này. Người gửi email đã di chuyển là samplesender@example.com và email được di chuyển vào kho lưu trữ của nhóm 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.

Phản hồi thành công sẽ trả về mã trạng thái HTTP 200 và trạng thái di chuyển. Để biết thêm thông tin về các giá trị responseCode, hãy xem tài liệu tham khảo về Groups Migration API.

{
 "kind": "groupsMigration#groups",
 "responseCode": "SUCCESS",
}

Xem bài viết đã nhập trên giao diện của Google Groups

Trên Google Groups, trạng thái đã đọc hoặc chưa đọc của chuỗi tin được lưu trữ riêng cho từng người dùng. Khi bạn chèn tin nhắn và chuỗi tin nhắn bằng Groups Migration API, các tin nhắn và chuỗi tin nhắn đó sẽ được coi như do người dùng gửi trong tiêu đề From:. Điều này có nghĩa là thư sẽ xuất hiện dưới dạng thư chưa đọc đối với tất cả người dùng, ngoại trừ người dùng có địa chỉ trong tiêu đề From:. Ví dụ: sau ví dụ về yêu cầu JSON trước đó, thông báo có tiêu đề SUBJECT sẽ xuất hiện dưới dạng đã đọc nếu samplesender@example.com đăng nhập vào Google Groups, nhưng sẽ xuất hiện dưới dạng chưa đọc đối với tất cả người dùng khác.