Archive: insert

Di chuyển thư email vào bản 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 được 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 siêu dữ liệu và mọi tệp đính kèm 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 đối với API di chuyển nhóm là 10 truy vấn mỗi giây (QPS) trên 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 tiêu 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

Thông số

Tên thông số Giá trị Mô tả
Thông số đường dẫn
groupId string Địa chỉ email của nhóm lưu trữ email đã di chuyển. Đị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 Directory API, bạn phải sử dụng địa chỉ email mới trong biến groupId.
Thông 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 phương tiện lên.
  • resumable – Tải lên tiếp nối, tải tệp lên theo cách có thể tiếp nối bằng một loạt ít nhất hai yêu cầu.

Ủy quyền

Yêu cầu này yêu cầu đượ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 phần nội dung phản hồi có cấu trúc sau:

{
  "kind": "groupsmigration#groups",
  "responseCode": string
}
Tên tài sản Giá trị 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. Các giá trị trạng thái responseCode bao gồm:

AUTHORIZATION FAILURE — Thông tin uỷ quyền của quản trị viên không hợp lệ. Mã trạng thái HTTP 401 đượ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 thuật toán thời gian đợi luỹ thừa, hãy đợi một độ trễ ngắn 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 một 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à một số ví dụ về định dạng không hợp lệ:

  • Thư có thể thiếu các trường From, To và Date.
  • Lỗi sẽ xảy ra nếu một dòng trong thông báo không được kết thúc bằng dòng mới kiểu CR+LF (tức là "\r\n").
  • Thư email 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ó thể đọc, hãy xem các tuỳ chọn chia sẻ của Google Groups for Business.

SUCCESS – Thư đã được lưu trữ thành công trong bản 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ợ chèn thư 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ợ 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 để chèn email vào các bản lưu trữ nhóm khác nhau. Mã trạng thái HTTP 400 được trả về.