Acl: update
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
액세스 제어 규칙을 업데이트합니다.
지금 사용해 보기
요청
HTTP 요청
PUT https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/ruleId
매개변수
| 매개변수 이름 |
값 |
설명 |
| 경로 매개변수 |
calendarId |
string |
캘린더 식별자입니다. 캘린더 ID를 가져오려면 calendarList.list 메서드를 호출합니다. 현재 로그인한 사용자의 기본 캘린더에 액세스하려면 'primary' 키워드를 사용하세요.
|
ruleId |
string |
ACL 규칙 식별자입니다.
|
| 선택적 쿼리 매개변수 |
sendNotifications |
boolean |
캘린더 공유 변경사항에 관한 알림을 전송할지 여부입니다. 액세스 권한 삭제에 대한 알림은 없습니다. 선택사항입니다. 기본값은 true입니다.
|
승인
이 요청에는 다음 범위 중 하나 이상에 대한 승인이 필요합니다.
| 범위 |
|---|
https://www.googleapis.com/auth/calendar |
https://www.googleapis.com/auth/calendar.acls |
자세한 내용은 인증 및 승인 페이지를 참고하세요.
요청 본문
요청 본문에서는 다음과 같은 속성을 사용하여 Acl 리소스를 제공합니다.
| 속성 이름 |
값 |
설명 |
참고 |
| 필수 속성 |
scope |
object |
이 ACL 규칙에서 캘린더 액세스가 부여되는 범위입니다. |
|
scope.type |
string |
범위 유형입니다. 가능한 값은 다음과 같습니다. - '
default' - 공개 범위입니다. 기본값입니다. - '
user': 범위를 단일 사용자로 제한합니다. - '
group': 범위를 그룹으로 제한합니다. - '
domain' - 범위를 도메인으로 제한합니다. 참고: 'default' 또는 공개 범위에 부여된 권한은 인증 여부와 관계없이 모든 사용자에게 적용됩니다. |
|
| 선택 속성 |
role |
string |
범위에 할당된 역할입니다. 가능한 값은 다음과 같습니다. - '
none': 액세스 권한을 제공하지 않습니다. - '
freeBusyReader': 비즈니스 일정 정보에 대한 읽기 액세스 권한을 제공합니다. - '
reader': 캘린더에 대한 읽기 액세스 권한을 제공합니다. 비공개 일정은 독자 액세스 권한이 있는 사용자에게 표시되지만 일정 세부정보는 숨겨집니다. - '
writer': 캘린더에 대한 읽기 및 쓰기 액세스 권한을 제공합니다. 비공개 일정은 작성자 액세스 권한이 있는 사용자에게 표시되며 일정 세부정보가 표시됩니다. 캘린더의 ACL에 대한 읽기 액세스 권한을 제공합니다. - '
owner': 캘린더의 소유권을 제공합니다. 이 역할에는 작성자 역할의 모든 권한과 ACL을 조작하는 추가 기능이 있습니다. |
쓰기 가능
|
scope.value |
string |
범위 유형에 따라 사용자 또는 그룹의 이메일 주소 또는 도메인 이름입니다. 'default' 유형의 경우 생략됩니다. |
쓰기 가능
|
응답
이 메서드는 성공하면 응답 본문에 Acl 리소스를 반환합니다.
사용해 보기
아래의 API 탐색기를 사용하여 실시간 데이터를 대상으로 이 메소드를 호출하고 응답을 확인해 보세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[],[],null,["# Acl: update\n\n| **Note:** Requires [authorization](#auth).\n\nUpdates an access control rule.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/ruleId\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|---------------------|-----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `calendarId` | `string` | Calendar identifier. To retrieve calendar IDs call the [calendarList.list](/workspace/calendar/api/v3/reference/calendarList/list) method. If you want to access the primary calendar of the currently logged in user, use the \"`primary`\" keyword. |\n| `ruleId` | `string` | ACL rule identifier. |\n| **Optional query parameters** |||\n| `sendNotifications` | `boolean` | Whether to send notifications about the calendar sharing change. Note that there are no notifications on access removal. Optional. The default is True. |\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes:\n\n| Scope |\n|-------------------------------------------------|\n| `https://www.googleapis.com/auth/calendar` |\n| `https://www.googleapis.com/auth/calendar.acls` |\n\nFor more information, see the [authentication and authorization](/workspace/guides/configure-oauth-consent) page.\n\n### Request body\n\nIn the request body, supply an [Acl resource](/workspace/calendar/api/v3/reference/acl#resource) with the following properties:\n\n| Property name | Value | Description | Notes |\n|---------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| **Required Properties** ||||\n| `scope` | `object` | The extent to which [calendar access](https://developers.google.com/workspace/calendar/concepts/sharing#sharing_calendars) is granted by this ACL rule. | |\n| scope.`type` | `string` | The type of the scope. Possible values are: - \"`default`\" - The public scope. This is the default value. - \"`user`\" - Limits the scope to a single user. - \"`group`\" - Limits the scope to a group. - \"`domain`\" - Limits the scope to a domain. Note: The permissions granted to the \"`default`\", or public, scope apply to any user, authenticated or not. | |\n| **Optional Properties** ||||\n| `role` | `string` | The role assigned to the scope. Possible values are: - \"`none`\" - Provides no access. - \"`freeBusyReader`\" - Provides read access to free/busy information. - \"`reader`\" - Provides read access to the calendar. Private events will appear to users with reader access, but event details will be hidden. - \"`writer`\" - Provides read and write access to the calendar. Private events will appear to users with writer access, and event details will be visible. Provides read access to the calendar's ACLs. - \"`owner`\" - Provides ownership of the calendar. This role has all of the permissions of the writer role with the additional ability to manipulate ACLs. | writable |\n| scope.`value` | `string` | The email address of a user or group, or the name of a domain, depending on the scope type. Omitted for type \"`default`\". | writable |\n\nResponse\n--------\n\nIf successful, this method returns an [Acl resource](/workspace/calendar/api/v3/reference/acl#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response."]]
