Tạo quy tắc kiểm soát quyền truy cập. Thử ngay hoặc xem ví dụ.
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ả |
---|---|---|
Thông số đường dẫn | ||
calendarId |
string |
Giá trị 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 đã đăng nhập, hãy sử dụng từ khoá "primary ".
|
Thông số truy vấn không bắt buộc | ||
sendNotifications |
boolean |
Liệu có gửi thông báo về thay đổi đối với việc 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 yêu cầu 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 phần nội dung yêu cầu, hãy cung cấp tài nguyên Acl với 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ể có là:
|
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 " hoặc công khai áp dụng cho mọi người dùng, dù đã xác thực hay chưa. |
|
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ỏ qua đối với loại "default ". |
writable |
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 phần nội dung phản hồi.
Ví dụ
Lưu ý: Các đoạn mã mẫu của phương thức này không phải là ví dụ cho mọi ngôn ngữ lập trình được hỗ trợ (xem trang thông tin về các thư viện dùng cho ứng dụng để biết danh sách các ngôn ngữ được hỗ trợ).
Java
Sử dụng thư viện ứng dụng Java.
import com.google.api.services.calendar.Calendar; import com.google.api.services.calendar.model.AclRule; // ... // Initialize Calendar service with valid OAuth credentials Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials) .setApplicationName("applicationName").build(); // Create access rule with associated scope AclRule rule = new AclRule(); Scope scope = new Scope(); scope.setType("scopeType").setValue("scopeValue"); rule.setScope(scope).setRole("role"); // Insert new access rule AclRule createdRule = service.acl().insert('primary', rule).execute(); System.out.println(createdRule.getId());
Python
Sử dụng thư viện ứng dụng Python.
rule = { 'scope': { 'type': 'scopeType', 'value': 'scopeEmail', }, 'role': 'role' } created_rule = service.acl().insert(calendarId='primary', body=rule).execute() print created_rule['id']
PHP
Sử dụng thư viện ứng dụng PHP.
$rule = new Google_Service_Calendar_AclRule(); $scope = new Google_Service_Calendar_AclRuleScope(); $scope->setType("scopeType"); $scope->setValue("scopeValue"); $rule->setScope($scope); $rule->setRole("role"); $createdRule = $service->acl->insert('primary', $rule); echo $createdRule->getId();
Ruby
Sử dụng thư viện ứng dụng Ruby.
rule = Google::Apis::CalendarV3::AclRule.new( scope: { type: 'scopeType', value: 'scopeEmail', }, role: 'role' ) result = client.insert_acl('primary', rule) print result.id
Hãy dùng thử!
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 trực tiếp và xem phản hồi.