Warning: The Notifications API is deprecated and will be shutdown soon.

Roles: list

Retrieves a paginated list of all the roles in a domain. Try it now.

Request

HTTP request

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

Parameters

Parameter name Value Description
Path parameters
customer string Immutable ID of the G Suite account.
Optional query parameters
maxResults integer Maximum number of results to return. Acceptable values are 1 to 100, inclusive.
pageToken string Token to specify the next page in the list.

Authorization

This request requires authorization with at least one of the following scopes:

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

For more information, see the authentication and authorization page.

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#roles",
  "etag": etag,
  "items": [
    roles Resource
  ],
  "nextPageToken": string
}
Property name Value Description Notes
kind string The type of the API resource. This is always admin#directory#roles.
etag etag ETag of the resource.
items[] list A list of Role resources.
nextPageToken string

Try it!

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