Privileges: list

Requires authorization

Retrieves a paginated list of all privileges for a customer. Try it now.

Request

HTTP request

GET https://www.googleapis.com/admin/directory/v1/customer/customer/roles/ALL/privileges

Parameters

Parameter name Value Description
Path parameters
customer string Immutable ID of the G Suite account.

Authorization

This request requires authorization with at least one of the following scopes (read more about authentication and authorization).

Scope
https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly
https://www.googleapis.com/auth/admin.directory.rolemanagement

Request body

Do not supply a request body with this method.

Response

If successful, this method returns a response body with the following structure:

{
  "kind": "admin#directory#privileges",
  "etag": etag,
  "items": [
    {
      "kind": "admin#directory#privilege",
      "etag": etag,
      "serviceId": string,
      "serviceName": string,
      "privilegeName": string,
      "isOuScopable": boolean,
      "childPrivileges": [
        (Privilege)
      ]
    }
  ]
}
Property name Value Description Notes
kind string The type of the API resource. This is always admin#directory#privileges.
etag etag ETag of the resource.
items[] list A list of Privilege resources.
items[].kind string The type of the API resource. This is always admin#directory#privilege.
items[].etag etag ETag of the resource.
items[].serviceId string The obfuscated ID of the service this privilege is for.
items[].serviceName string The name of the service this privilege is for.
items[].privilegeName string The name of the privilege.
items[].isOuScopable boolean If the privilege can be restricted to an organization unit.
items[].childPrivileges[] list 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.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.

Send feedback about...

Directory API
Directory API
Need help? Visit our support page.