Acl
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 리소스에 대한 메소드 목록은 이 페이지의 하단에 나와 있습니다.
리소스 표현
{
"kind": "calendar#aclRule",
"etag": etag,
"id": string,
"scope": {
"type": string,
"value": string
},
"role": string
}
속성 이름 |
값 |
설명 |
참고 |
etag |
etag |
리소스의 ETag입니다. |
|
id |
string |
액세스 제어 목록 (ACL) 규칙의 식별자입니다. 캘린더 공유하기를 참고하세요. |
|
kind |
string |
리소스 유형 ("calendar#aclRule ")입니다. |
|
role |
string |
범위에 할당된 역할입니다. 가능한 값은 다음과 같습니다. - '
none ': 액세스 권한을 제공하지 않습니다. - '
freeBusyReader ': 비즈니스 일정 정보에 대한 읽기 액세스 권한을 제공합니다. - '
reader ': 캘린더에 대한 읽기 액세스 권한을 제공합니다. 비공개 일정은 독자 액세스 권한이 있는 사용자에게 표시되지만 일정 세부정보는 숨겨집니다. - '
writer ': 캘린더에 대한 읽기 및 쓰기 액세스 권한을 제공합니다. 비공개 일정은 작성자 액세스 권한이 있는 사용자에게 표시되며 일정 세부정보가 표시됩니다. 캘린더의 ACL에 대한 읽기 액세스 권한을 제공합니다. - '
owner ': 캘린더의 소유권을 제공합니다. 이 역할에는 ACL을 조작하는 추가 기능이 있는 작성자 역할의 모든 권한이 있습니다. |
쓰기 가능
|
scope |
object |
이 ACL 규칙에서 부여되는 캘린더 액세스의 범위입니다. |
|
scope.type |
string |
범위 유형입니다. 가능한 값은 다음과 같습니다. - '
default ' - 공개 범위입니다. 기본값입니다. - '
user ': 범위를 단일 사용자로 제한합니다. - '
group ': 범위를 그룹으로 제한합니다. - '
domain ' - 범위를 도메인으로 제한합니다. 참고: 'default ' 또는 공개 범위에 부여된 권한은 인증 여부와 관계없이 모든 사용자에게 적용됩니다. |
|
scope.value |
string |
범위 유형에 따라 사용자 또는 그룹의 이메일 주소 또는 도메인 이름입니다. 'default ' 유형의 경우 생략됩니다. |
쓰기 가능
|
메서드
- 삭제
- 액세스 제어 규칙을 삭제합니다.
- get
- 액세스 제어 규칙을 반환합니다.
- insert
- 액세스 제어 규칙을 만듭니다.
- list
- 캘린더의 액세스 제어 목록에 있는 규칙을 반환합니다.
- patch
- 액세스 제어 규칙을 업데이트합니다. 이 메소드는 패치 의미 체계를 지원합니다. 각 패치 요청은 3개의 할당량 단위를 사용합니다.
get
뒤에 update
을 사용하는 것이 좋습니다. 지정하는 필드 값은 기존 값을 대체합니다. 요청에 지정하지 않은 필드는 변경되지 않습니다. 배열 필드(지정된 경우)는 기존 배열을 덮어씁니다. 이렇게 하면 이전 배열 요소가 삭제됩니다.
- 업데이트
- 액세스 제어 규칙을 업데이트합니다.
- 시계
- ACL 리소스의 변경사항을 확인합니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[],[],null,["# Acl\n\n\u003cbr /\u003e\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\n\u003cbr /\u003e\n\n```carbon\n{\n \"kind\": \"calendar#aclRule\",\n \"etag\": etag,\n \"id\": string,\n \"scope\": {\n \"type\": string,\n \"value\": string\n },\n \"role\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| `etag` | `etag` | ETag of the resource. | |\n| `id` | `string` | Identifier of the Access Control List (ACL) rule. See [Sharing calendars](https://developers.google.com/workspace/calendar/concepts/sharing#sharing_calendars). | |\n| `kind` | `string` | Type of the resource (\"`calendar#aclRule`\"). | |\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` | `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| 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\nMethods\n-------\n\n[delete](/workspace/calendar/api/v3/reference/acl/delete)\n: Deletes an access control rule.\n\n[get](/workspace/calendar/api/v3/reference/acl/get)\n: Returns an access control rule.\n\n[insert](/workspace/calendar/api/v3/reference/acl/insert)\n: Creates an access control rule.\n\n[list](/workspace/calendar/api/v3/reference/acl/list)\n: Returns the rules in the access control list for the calendar.\n\n[patch](/workspace/calendar/api/v3/reference/acl/patch)\n: Updates an access control rule. This method supports patch semantics. Note that each patch request consumes three quota units; prefer using a `get` followed by an `update`. The field values you specify replace the existing values. Fields that you don't specify in the request remain unchanged. Array fields, if specified, overwrite the existing arrays; this discards any previous array elements.\n\n[update](/workspace/calendar/api/v3/reference/acl/update)\n: Updates an access control rule.\n\n[watch](/workspace/calendar/api/v3/reference/acl/watch)\n: Watch for changes to ACL resources."]]