Retrieves a paginated list of all members in a group. This method times out after 60 minutes. For more information, see Troubleshoot error codes .
HTTP request
GET https://admin.googleapis.com/admin/directory/v1/groups/{groupKey}/members
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
groupKey
|
Identifies the group in the API request. The value can be the group's email address, group alias, or the unique group ID. |
Query parameters
| Parameters | |
|---|---|
includeDerivedMembership
|
Whether to list indirect memberships. Default: false. |
maxResults
|
Maximum number of results to return. Max allowed value is 200. |
pageToken
|
Token to specify next page in the list. |
roles
|
The |
Request body
The request body must be empty.
Response body
If successful, the response body contains data with the following structure:
| JSON representation |
|---|
{
"kind"
:
string
,
"etag"
:
string
,
"members"
:
[
{
object (
|
| Fields | |
|---|---|
kind
|
Kind of resource this is. |
etag
|
ETag of the resource. |
members[]
|
A list of member objects. |
nextPageToken
|
Token used to access next page of this result. |
Authorization scopes
Requires one of the following OAuth scopes:
-
https://apps-apis.google.com/a/feeds/groups/ -
https://www.googleapis.com/auth/admin.directory.group -
https://www.googleapis.com/auth/admin.directory.group.member -
https://www.googleapis.com/auth/admin.directory.group.member.readonly -
https://www.googleapis.com/auth/admin.directory.group.readonly
For more information, see the Authorization guide .

