Archive: insert

Di chuyển email vào mục lưu trữ của nhóm Google bằng tính năng tải nội dung nghe nhìn lên.

Phương thức này hỗ trợ URI /upload và chấp nhận nội dung nghe nhìn đã tải lên có các đặc điểm sau:

  • Kích thước tệp tối đa: Kích thước tối đa của thư là 25 MB. Giới hạn này bao gồm cả tiêu đề, nội dung và tệp đính kèm của siêu dữ liệu của thư.
  • Các loại MIME nội dung đa phương tiện được chấp nhận: message/rfc822

Giới hạn dự án cho Groups Migration API là 10 truy vấn trên mỗi giây (QPS) cho mỗi tài khoản. Số yêu cầu API tối đa mỗi ngày là 500.000. Để biết thêm thông tin về định dạng RFC822, hãy xem định dạng chuẩn RFC822.

Yêu cầu

Yêu cầu HTTP

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

Các tham số

Tên thông số Giá trị Nội dung mô tả
Tham số đường dẫn
groupId string Địa chỉ email của nhóm nơi email đã di chuyển được lưu trữ. Địa chỉ email này là một biến trong đường dẫn URL của yêu cầu. Nếu chủ sở hữu nhóm thay đổi địa chỉ email của nhóm bằng Bảng điều khiển dành cho quản trị viên hoặc API Thư mục, thì bạn phải sử dụng địa chỉ email mới trong biến groupId.
Tham số truy vấn bắt buộc
uploadType string

Loại yêu cầu tải lên URI /upload bằng một trong các giá trị sau:

  • media – Tải lên đơn giản để tải dữ liệu đa phương tiện lên.
  • resumable – Quá trình tải lên tiếp nối sẽ tải tệp lên theo cách tiếp nối, sử dụng một chuỗi gồm ít nhất hai yêu cầu.

Ủy quyền

Yêu cầu này cần được uỷ quyền với phạm vi sau:

Phạm vi
https://www.googleapis.com/auth/apps.groups.migration

Để biết thêm thông tin, hãy xem trang xác thực và uỷ quyền.

Nội dung yêu cầu

Đừng cung cấp nội dung yêu cầu bằng phương thức này.

Phản hồi

Nếu thành công, phương thức này sẽ trả về một nội dung phản hồi có cấu trúc như sau:

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}
Tên tài sản Giá trị Nội dung mô tả
kind string Đây là loại tài nguyên chèn. Giá trị: groupsmigration#groups
responseCode string

Mã trạng thái của phản hồi API cho một yêu cầu di chuyển đi kèm với mã trạng thái HTTP. Giá trị trạng thái responseCode bao gồm:

AUTHORIZATION FAILURE — Thông tin xác thực uỷ quyền của quản trị viên không hợp lệ. Mã trạng thái HTTP 401 sẽ được trả về.

BACKEND FAILURE – Máy chủ gặp sự cố hoặc đang bận. Mã trạng thái HTTP 503 sẽ được trả về. Sử dụng thuật toán thời gian đợi luỹ thừa, hãy đợi một độ trễ nhỏ trước khi thử lại lệnh gọi không thành công.

INVALID MESSAGE FAILURE — Email có định dạng không hợp lệ. Nếu thông báo bị từ chối do có định dạng không hợp lệ, bạn sẽ nhận được mã trạng thái HTTP 400 Bad Request. Sau đây là ví dụ về định dạng không hợp lệ:

  • Thư có thể thiếu các trường From, ToDate.
  • Lỗi xảy ra nếu một dòng trong thông báo không bị kết thúc bằng dòng mới kiểu CR+LF (tức là "\r\n").
  • Email đang trống.
  • Nhóm mục tiêu của quá trình di chuyển không tồn tại hoặc đang ở chế độ "chỉ có thể đọc". Để biết thêm thông tin về chế độ chia sẻ chỉ đọc, hãy xem tuỳ chọn chia sẻ trong Google Groups for Business.

SUCCESS — Thư đã được lưu trữ thành công trong kho lưu trữ nhóm của tài khoản. Mã trạng thái HTTP 200 sẽ được trả về.

UNSUPPORTED_PARALLEL_OPERATION – API Di chuyển nhóm không hỗ trợ tính năng chèn thông báo song song vào cùng một kho lưu trữ nhóm. Ngoài ra, API di chuyển nhóm không hỗ trợ các yêu cầu hàng loạt. Tuy nhiên, API di chuyển nhóm hỗ trợ các yêu cầu song song về việc chèn email vào các tệp lưu trữ nhóm khác nhau. Mã trạng thái HTTP 400 sẽ được trả về.