Acl

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

Cách trình bày 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 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ể là:
  • "none" – Không cấp quyền truy cập.
  • "freeBusyReader" – Cung cấp quyền đọc thông tin về trạng thái rảnh/bận.
  • "reader" – Cung cấp quyền đọc đối với lịch. Sự kiện riêng tư sẽ xuất hiện với người dùng có quyền đọc, nhưng thông tin sự kiện sẽ bị ẩn.
  • "writerWithoutPrivateAccess" – 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 writerWithoutPrivateAccess, 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. Người dùng có quyền chỉnh sửa sẽ thấy các sự kiện riêng tư và thông tin chi tiết về sự kiện. Cung cấp quyền đọc cho ACL của lịch.
  • "owner" – Cấp cho người quản lý quyền truy cập vào lịch. Vai trò này có tất cả các quyền của vai trò người viết, cộng thêm khả năng sửa đổi cấp độ truy cập của những người dùng khác.

có thể ghi
scope object Mức độ mà quy tắc ACL này cấp quyền truy cập vào lịch.
scope.type string Loại phạm vi. Các giá trị có thể là:
  • "default" – Phạm vi công khai. Đây là giá trị mặc định.
  • "user" – Giới hạn phạm vi cho một người dùng duy nhất.
  • "group" – Giới hạn phạm vi đối với 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 phạm vi "default" hoặc phạm vi công khai sẽ áp dụng cho mọi người dùng, bất kể họ có được xác thực hay không.
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ị bỏ qua đối với 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.
get
Trả về một quy tắc kiểm soát quyền truy cập.
chèn
Tạo một 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.
patch
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 vá. Xin lưu ý rằng mỗi yêu cầu vá sẽ tiêu thụ 3 đơn vị hạn mức; bạn nên sử dụng get rồi đến update. Các 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. Nếu được chỉ định, các trường mảng 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 mộ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.