REST Resource: labels.permissions
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
리소스: LabelPermission
라벨의 주 구성원 (사용자, 그룹, 잠재고객)에 적용되는 권한입니다.
JSON 표현 |
{
"name": string,
"email": string,
"role": enum (LabelRole ),
// Union field principal can be only one of the following:
"person": string,
"group": string,
"audience": string
// End of list of possible types for union field principal .
} |
필드 |
name |
string
이 권한의 리소스 이름입니다.
|
email |
string
사용자 또는 그룹 주 구성원의 이메일 주소를 지정합니다. 잠재고객 주체에 대해 입력되지 않습니다. 사용자 및 그룹 권한은 이메일 주소를 사용해서만 삽입할 수 있습니다. 업데이트 요청에서 이메일 주소를 지정한 경우 주체를 지정하면 안 됩니다.
|
role |
enum (LabelRole )
주 구성원이 보유해야 하는 역할입니다.
|
통합 필드 principal . 이 권한이 적용되는 주 구성원입니다. 이메일, 사용자, 그룹 또는 잠재고객이어야 합니다. 예: * people/12345 * groups/45678 * audiences/default principal 는 다음 중 하나여야 합니다. |
person |
string
사용자 리소스 이름입니다.
|
group |
string
그룹 리소스 이름입니다.
|
audience |
string
역할을 부여할 잠재고객입니다. audiences/default 의 매직 값은 라벨을 소유한 조직의 컨텍스트에서 기본 잠재고객에 역할을 적용하는 데 사용할 수 있습니다.
|
LabelRole
열거형 |
LABEL_ROLE_UNSPECIFIED |
알 수 없는 역할입니다. |
READER |
읽기 권한 사용자는 Drive 항목에 적용된 라벨과 연결된 메타데이터를 읽을 수 있습니다. |
APPLIER |
적용자는 쓰기 액세스 권한이 있는 Drive 항목에 연결된 메타데이터를 쓸 수 있습니다. READER 을 의미합니다. |
ORGANIZER |
주최자는 관리하는 공유 드라이브에 이 라벨을 고정하고 라벨에 새로운 적용자를 추가할 수 있습니다. |
EDITOR |
편집자는 라벨을 삭제하는 것을 포함하여 모든 업데이트를 할 수 있으며, 라벨을 삭제하면 연결된 Drive 항목 메타데이터도 삭제됩니다. APPLIER 을 의미합니다. |
메서드 |
|
라벨 권한을 삭제합니다. |
|
라벨 권한을 업데이트합니다. |
|
라벨의 권한을 업데이트합니다. |
|
라벨의 권한을 삭제합니다. |
|
라벨의 권한을 나열합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-05(UTC)
[null,null,["최종 업데이트: 2025-08-05(UTC)"],[],[],null,["# REST Resource: labels.permissions\n\n- [Resource: LabelPermission](#LabelPermission)\n - [JSON representation](#LabelPermission.SCHEMA_REPRESENTATION)\n - [LabelRole](#LabelPermission.LabelRole)\n- [Methods](#METHODS_SUMMARY)\n\nResource: LabelPermission\n-------------------------\n\nThe permission that applies to a principal (user, group, audience) on a label.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"email\": string, \"role\": enum (/workspace/drive/labels/reference/rest/v2/labels.permissions#LabelPermission.LabelRole), // Union field `principal` can be only one of the following: \"person\": string, \"group\": string, \"audience\": string // End of list of possible types for union field `principal`. } ``` |\n\n| Fields ||\n|------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Resource name of this permission. |\n| `email` | `string` Specifies the email address for a user or group principal. Not populated for audience principals. User and group permissions may only be inserted using an email address. On update requests, if email address is specified, no principal should be specified. |\n| `role` | `enum (`[LabelRole](/workspace/drive/labels/reference/rest/v2/labels.permissions#LabelPermission.LabelRole)`)` The role the principal should have. |\n| Union field `principal`. The principal this permission applies to. Must be either an email, user, group, or audience. Example: \\* `people/12345` \\* `groups/45678` \\* `audiences/default` `principal` can be only one of the following: ||\n| `person` | `string` Person resource name. |\n| `group` | `string` Group resource name. |\n| `audience` | `string` Audience to grant a role to. The magic value of `audiences/default` may be used to apply the role to the default audience in the context of the organization that owns the label. |\n\n### LabelRole\n\nRoles are concentric with subsequent role.\n\n| Enums ||\n|--------------------------|------------------------------------------------------------------------------------------------------------------------------------|\n| `LABEL_ROLE_UNSPECIFIED` | Unknown role. |\n| `READER` | A reader can read the label and associated metadata applied to Drive items. |\n| `APPLIER` | An applier can write associated metadata on Drive items in which they also have write access to. Implies `READER`. |\n| `ORGANIZER` | An organizer can pin this label in shared drives they manage and add new appliers to the label. |\n| `EDITOR` | Editors can make any update including deleting the label which also deletes the associated Drive item metadata. Implies `APPLIER`. |\n\n| Methods ------- ||\n|---------------------------------------------------------------------------------------------|--------------------------------|\n| ### [batchDelete](/workspace/drive/labels/reference/rest/v2/labels.permissions/batchDelete) | Deletes label permissions. |\n| ### [batchUpdate](/workspace/drive/labels/reference/rest/v2/labels.permissions/batchUpdate) | Updates label permissions. |\n| ### [create](/workspace/drive/labels/reference/rest/v2/labels.permissions/create) | Updates a label's permissions. |\n| ### [delete](/workspace/drive/labels/reference/rest/v2/labels.permissions/delete) | Deletes a label's permission. |\n| ### [list](/workspace/drive/labels/reference/rest/v2/labels.permissions/list) | Lists a label's permissions. |"]]