Method: privileges.list
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
고객의 모든 권한 목록을 페이지로 나누어 가져옵니다.
HTTP 요청
GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/roles/ALL/privileges
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 |
customer |
string
고객의 Google Workspace 계정의 고유 ID입니다. 다중 도메인 계정의 경우 고객의 모든 그룹을 가져오려면 domain 대신 이 필드를 사용하세요. my_customer 별칭을 사용하여 계정의 customerId 를 나타낼 수도 있습니다. customerId 는 사용자 리소스의 일부로 반환되기도 합니다. customer 또는 domain 매개변수를 제공해야 합니다.
|
응답 본문
성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.
JSON 표현 |
{
"kind": string,
"etag": string,
"items": [
{
object (Privilege )
}
]
} |
필드 |
kind |
string
API 리소스의 유형입니다. 항상 admin#directory#privileges 입니다.
|
etag |
string
리소스의 ETag입니다.
|
items[] |
object (Privilege )
권한 리소스 목록입니다.
|
승인 범위
다음 OAuth 범위 중 하나가 필요합니다.
https://www.googleapis.com/auth/admin.directory.rolemanagement
https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly
자세한 내용은 승인 가이드를 참고하세요.
프리빌리지
JSON 표현 |
{
"serviceId": string,
"kind": string,
"etag": string,
"isOuScopable": boolean,
"childPrivileges": [
{
object (Privilege )
}
],
"privilegeName": string,
"serviceName": string
} |
필드 |
serviceId |
string
이 권한이 적용되는 서비스의 난독화된 ID입니다. 이 값은 Privileges.list() 와 함께 반환됩니다.
|
kind |
string
API 리소스의 유형입니다. 항상 admin#directory#privilege 입니다.
|
etag |
string
리소스의 ETag입니다.
|
isOuScopable |
boolean
권한을 조직 단위로 제한할 수 있는 경우
|
childPrivileges[] |
object (Privilege )
하위 권한 목록입니다. 서비스의 권한은 트리를 형성합니다. 각 권한에는 하위 권한 목록이 있을 수 있습니다. 이 목록은 리프 권한의 경우 비어 있습니다.
|
privilegeName |
string
권한의 이름입니다.
|
serviceName |
string
이 권한이 적용되는 서비스의 이름입니다.
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[],[],null,["# Method: privileges.list\n\nRetrieves a paginated list of all privileges for a customer.\n\n### HTTP request\n\n`GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/roles/ALL/privileges`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customer` | `string` The unique ID for the customer's Google Workspace account. In case of a multi-domain account, to fetch all groups for a customer, use this field instead of `domain`. You can also use the `my_customer` alias to represent your account's `customerId`. The `customerId` is also returned as part of the [Users](https://developers.google.com/workspace/admin/directory/v1/reference/users) resource. You must provide either the `customer` or the `domain` parameter. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"etag\": string, \"items\": [ { object (/workspace/admin/directory/reference/rest/v1/privileges/list#Privilege) } ] } ``` |\n\n| Fields ||\n|-----------|---------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` The type of the API resource. This is always `admin#directory#privileges`. |\n| `etag` | `string` ETag of the resource. |\n| `items[]` | `object (`[Privilege](/workspace/admin/directory/reference/rest/v1/privileges/list#Privilege)`)` A list of Privilege resources. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/admin.directory.rolemanagement`\n- `\n https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent).\n\nPrivilege\n---------\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"serviceId\": string, \"kind\": string, \"etag\": string, \"isOuScopable\": boolean, \"childPrivileges\": [ { object (/workspace/admin/directory/reference/rest/v1/privileges/list#Privilege) } ], \"privilegeName\": string, \"serviceName\": string } ``` |\n\n| Fields ||\n|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `serviceId` | `string` The obfuscated ID of the service this privilege is for. This value is returned with [`Privileges.list()`](https://developers.google.com/workspace/admin/directory/v1/reference/privileges/list). |\n| `kind` | `string` The type of the API resource. This is always `admin#directory#privilege`. |\n| `etag` | `string` ETag of the resource. |\n| `isOuScopable` | `boolean` If the privilege can be restricted to an organization unit. |\n| `childPrivileges[]` | `object (`[Privilege](/workspace/admin/directory/reference/rest/v1/privileges/list#Privilege)`)` A list of child privileges. Privileges for a service form a tree. Each privilege can have a list of child privileges; this list is empty for a leaf privilege. |\n| `privilegeName` | `string` The name of the privilege. |\n| `serviceName` | `string` The name of the service this privilege is for. |"]]