Acl

Để xem danh sách phương thức cho tài nguyên này, hãy xem phần cuối trang này.

Biểu thị tài nguyên

{
  "kind": "calendar#aclRule",
  "etag": etag,
  "id": string,
  "scope": {
    "type": string,
    "value": string
  },
  "role": string
}
Tên tài sản Giá trị Mô tả Ghi chú
etag etag ETag của tài nguyên.
id string Giá trị nhận dạng của quy tắc Danh sách kiểm soát quyền truy cập (ACL). Xem bài viết Chia sẻ lịch.
kind string Loại tài nguyên ("calendar#aclRule").
role string Vai trò được chỉ định cho phạm vi. Các giá trị có thể có là:
  • "none" – Không cấp quyền truy cập.
  • "freeBusyReader" – Cấp quyền đọc thông tin về lịch trống/bận.
  • "reader" – Cung cấp quyền đọc vào lịch. Sự kiện riêng tư sẽ xuất hiện với những người dùng có quyền đọc, nhưng thông tin chi tiết về sự kiện sẽ bị ẩn.
  • "writer" – Cung cấp quyền đọc và ghi vào lịch. Sự kiện riêng tư sẽ xuất hiện với những người dùng có quyền truy cập của người viết và họ sẽ thấy thông tin chi tiết về sự kiện. Cung cấp quyền đọc đối với ACL của lịch.
  • "owner" – Cung cấp quyền sở hữu lịch. Vai trò này có tất cả quyền của vai trò người ghi, đồng thời có thêm khả năng thao tác với ACL.
 writable
scope object Mức độ quyền truy cập vào lịch được cấp theo quy tắc ACL này.
scope.type string Loại phạm vi. Các giá trị có thể có là:
  • "default" – Phạm vi công khai. Đây là giá trị mặc định.
  • "user" – Giới hạn phạm vi ở một người dùng.
  • "group" – Giới hạn phạm vi ở một nhóm.
  • "domain" – Giới hạn phạm vi ở một miền.
Lưu ý: Các quyền được cấp cho phạm vi "default" hoặc công khai áp dụng cho mọi người dùng, dù đã xác thực hay chưa.
scope.value string Địa chỉ email của người dùng hoặc nhóm hoặc tên của miền, tuỳ thuộc vào loại phạm vi. Bỏ qua đối với loại "default". writable

Phương thức

xóa
Xoá một quy tắc kiểm soát quyền truy cập.
get
Trả về một quy tắc kiểm soát quyền truy cập.
chèn
Tạo quy tắc kiểm soát quyền truy cập.
list
Trả về các quy tắc trong danh sách kiểm soát quyền truy cập cho lịch.
bản vá
Cập nhật quy tắc kiểm soát quyền truy cập. Phương thức này hỗ trợ ngữ nghĩa bản vá. Xin lưu ý rằng mỗi yêu cầu vá sẽ tiêu thụ 3 đơn vị hạn mức; ưu tiên sử dụng get theo sau là update. Giá trị trường mà bạn chỉ định sẽ thay thế các giá trị hiện có. Các trường mà bạn không chỉ định trong yêu cầu sẽ không thay đổi. Các trường mảng, nếu được chỉ định, sẽ ghi đè các mảng hiện có; thao tác này sẽ loại bỏ mọi phần tử mảng trước đó.
update
Cập nhật quy tắc kiểm soát quyền truy cập.
watch
Theo dõi các thay đổi đối với tài nguyên ACL.