Method: contactGroups.list

List all contact groups owned by the authenticated user. Members of the contact groups are not populated.

HTTP request

GET https://people.googleapis.com/v1/contactGroups

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
pageToken

string

The nextPageToken value returned from a previous call to contactGroups.list. Requests the next page of resources.

pageSize

number

Optional. The maximum number of resources to return. Valid values are between 1 and 1000, inclusive. Defaults to 30 if not set or set to 0.

syncToken

string

A sync token, returned by a previous call to contactgroups.list. Only resources changed since the sync token was created will be returned.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

The response to a list contact groups request.

JSON representation
{
  "contactGroups": [
    {
      object (ContactGroup)
    }
  ],
  "totalItems": number,
  "nextPageToken": string,
  "nextSyncToken": string
}
Fields
contactGroups[]

object (ContactGroup)

The list of contact groups. Members of the contact groups are not populated.

totalItems

number

The total number of items in the list without pagination.

nextPageToken

string

The token that can be used to retrieve the next page of results.

nextSyncToken

string

The token that can be used to retrieve changes since the last request.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/contacts
  • https://www.googleapis.com/auth/contacts.readonly

For more information, see the Authorization guide.

Try it!