Di chuyển email

Trước khi di chuyển email sang Google Groups bằng API Di chuyển Groups, 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 là chính xác trước khi di chuyển một email đến bản lưu trữ của nhóm đó. Để biết thêm thông tin về nhóm trang thông tin và người dùng, hãy xem thời gian Directory API (API Thư mục).
  • Nếu người gửi email có cùng miền với nhóm mục tiêu, hãy kiểm tra để xác nhận rằng người gửi email có tồn tại trước khi di chuyển nội dung email tới kho lưu trữ của nhóm mục tiêu.
  • Định dạng thư 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 nội dung email Các trường To:, From: và Date: được định dạng đúng. Phản hồi được trả về ở định dạng dữ liệu JSON.

Di chuyển email sang Google Groups

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

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

Yêu cầu mẫu

Ví dụ này di chuyển email đến kho lưu trữ samplegroup@googlegroups.com. Content-Length bị giới hạn ở mức 25 MB, bao gồm 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à một ví dụ về email ở định dạng văn bản RFC 822 đã được chuyển sang bản lưu trữ của samplegroup@googlegroups.com. NNNN@mail.samplegroup.com là chẳng hạn như ID thư. Người gửi của email được di chuyển là samplesender@example.com và email là đã di chuyển sang 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.

    Khi phản hồi thành công, hệ thố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ề API Di chuyển nhóm.

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

    Xem tin nhắn đã nhập trên giao diện Google Groups

    Trên Google Groups, các chuỗi Trạng thái đã đọc/chưa đọc được lưu trữ riêng cho từng người dùng. Thời gian chèn thư và chuỗi bằng API di chuyển nhóm, thì các tệp này được xử lý như thể chúng do người dùng gửi trong tiêu đề From:. Điều này có nghĩa là các thư đó sẽ xuất hiện dưới dạng 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 xuất hiện dưới dạng chưa đọc cho tất cả người dùng khác.