Acl: insert

Tạo một quy tắc kiểm soát quyền truy cập. Thử ngay.

Yêu cầu

Yêu cầu HTTP

POST https://www.googleapis.com/calendar/v3/calendars/calendarId/acl

Thông số

Tên thông số Giá trị Mô tả
Tham số đường dẫn
calendarId string Mã nhận dạng lịch. Để truy xuất mã lịch, hãy gọi phương thức calendarList.list. Nếu bạn muốn truy cập vào lịch chính của người dùng hiện đang đăng nhập, hãy sử dụng từ khoá "primary".
Tham số truy vấn không bắt buộc
sendNotifications boolean Có gửi thông báo về thay đổi đối với hoạt động chia sẻ lịch hay không. Không bắt buộc. Giá trị mặc định là True.

Ủy quyền

Yêu cầu này cần có uỷ quyền với ít nhất một trong các phạm vi sau:

Phạm vi
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.acls

Để 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

Trong nội dung yêu cầu, hãy cung cấp một tài nguyên Acl có các thuộc tính sau:

Tên tài sản Giá trị Mô tả Ghi chú
Thuộc tính bắt buộc
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 cho 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, 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 ghi 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 quyền quản lý cho 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.
Thuộc tính không bắt buộc
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ản hồi

Nếu thành công, phương thức này sẽ trả về một tài nguyên Acl trong nội dung phản hồi.

Hãy dùng thử!

Hãy sử dụng Trình khám phá API bên dưới để gọi phương thức này trên dữ liệu thực và xem phản hồi.