Acl

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

Biểu diễn 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 Mã nhận dạng của quy tắc Danh sách kiểm soát quyền truy cập (ACL). Hãy xem phần 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" - Cung cấp quyền đọc thông tin rảnh/bận.
  • "reader" – Cấp quyền đọc lịch. Các sự kiện riêng tư sẽ hiển thị với người dùng có quyền truy cập của độc giả, nhưng thông tin chi tiết về sự kiện sẽ bị ẩn.
  • "writer" – Cấp quyền đọc và ghi đối với lịch. Người dùng có quyền truy cập của người ghi sẽ thấy các sự kiện riêng tư và thông tin chi tiết về sự kiện sẽ hiển thị.
  • "owner" - Cung cấp quyền sở hữu lịch. Vai trò này có tất cả các quyền của vai trò người viết với khả năng bổ sung để xem và thao tác các ACL.
có thể ghi
scope object Mức độ quyền truy cập vào lịch được cấp bởi 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 duy nhất.
  • "group" – Giới hạn phạm vi ở một nhóm.
  • "domain" – Giới hạn phạm vi trong một miền.
Lưu ý: Các quyền được cấp cho "default" (hoặc phạm vi công khai) áp dụng cho mọi người dùng, đã được xác thực hay chưa.
scope.value string Địa chỉ email của một người dùng hoặc nhóm hoặc tên của một miền, tuỳ thuộc vào loại phạm vi. Bị bỏ qua cho loại "default". có thể ghi

Phương thức

xóa
Xoá một quy tắc kiểm soát quyền truy cập.
nhận
Trả về 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 một quy tắc kiểm soát quyền truy cập. Phương thức này hỗ trợ ngữ nghĩa của bản vá. Lưu ý rằng mỗi yêu cầu bản vá cần 3 đơn vị hạn mức; thích dùng get theo sau là update. Các giá trị trường mà bạn chỉ định sẽ thay thế các giá trị hiện có. Những trường 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 đó.
cập nhật
Cập nhật một quy tắc kiểm soát quyền truy cập.
đồng hồ
Chú ý theo dõi những thay đổi đối với tài nguyên Danh sách kiểm soát quyền truy cập (ACL).