Users.settings.delegates

For a list of methods for this resource, see the end of this page.

Resource representations

Settings for a delegate. Delegates can read, send, and delete messages, as well as view and add contacts, for the delegator's account. See "Set up mail delegation" for more information about delegates.

{
  "delegateEmail": string,
  "verificationStatus": string
}
Property name Value Description Notes
delegateEmail string The email address of the delegate.
verificationStatus string Indicates whether this address has been verified and can act as a delegate for the account. Read-only.

Acceptable values are:
  • "accepted"
  • "expired"
  • "pending"
  • "rejected"
  • "verificationStatusUnspecified"

Methods

create
Adds a delegate with its verification status set directly to accepted, without sending any verification email. The delegate user must be a member of the same G Suite organization as the delegator user.

Gmail imposes limtations on the number of delegates and delegators each user in a G Suite organization can have. These limits depend on your organization, but in general each user can have up to 25 delegates and up to 10 delegators.

Note that a delegate user must be referred to by their primary email address, and not an email alias.

Also note that when a new delegate is created, there may be up to a one minute delay before the new delegate is available for use.

This method is only available to service account clients that have been delegated domain-wide authority.
delete
Removes the specified delegate (which can be of any verification status), and revokes any verification that may have been required for using it.

Note that a delegate user must be referred to by their primary email address, and not an email alias.

This method is only available to service account clients that have been delegated domain-wide authority.
get
Gets the specified delegate.

Note that a delegate user must be referred to by their primary email address, and not an email alias.

This method is only available to service account clients that have been delegated domain-wide authority.
list
Lists the delegates for the specified account.

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

Şunun hakkında geri bildirim gönderin...

Yardım mı gerekiyor? Destek sayfamızı ziyaret edin.