Users.settings.delegates: list

Note: Requires authorization.

Lists the delegates for the specified account.

This method is only available to service account clients that have been delegated domain-wide authority.

Request

HTTP request

GET https://www.googleapis.com/gmail/v1/users/userId/settings/delegates

Parameters

Parameter name	Value	Description
Path parameters
userId	string	User's email address. The special value "me" can be used to indicate the authenticated user.

Authorization

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

Scope
https://www.googleapis.com/auth/gmail.settings.basic
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.readonly

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:

{
  "delegates": [
    users.settings.delegates Resource
  ]
}

Property name	Value	Description	Notes
delegates[]	list	List of the user's delegates (with any verification status).