Acl

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

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ị Nội dung mô tả Ghi chú
etag etag ETag của tài nguyên.
id string Số nhận dạng của quy tắc Danh sách kiểm soát 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ể sử dụng là:
  • "none" – Không có quyền truy cập.
  • "freeBusyReader" – Cấp quyền đọc các thông tin rảnh/bận.
  • "reader" – Cấp quyền đọc lịch. Những người dùng có quyền đọc sẽ thấy các sự kiện riêng tư, 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 ghi sẽ thấy được các sự kiện riêng tư và thông tin chi tiết về sự kiện sẽ xuất hiện.
  • "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 ghi 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 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ể sử dụng 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" (công khai) sẽ á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 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 đối với loại "default". có thể ghi

Phương thức

xóa
Xoá 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 của 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 bản vá. Hãy lưu ý rằng mỗi yêu cầu bản vá sử dụng 3 đơn vị hạn mức; hãy ưu tiên sử dụng get sau update. Các giá trị của 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 đó.
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ú ý tớ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).