Method: admin.contacts.v1.users.delegates.list

Enumera los delegados de un usuario determinado.

Solicitud HTTP

GET https://admin.googleapis.com/admin/contacts/v1/{parent=users/*}/delegates

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

El elemento superior que es propietario de esta colección de delegados con el siguiente formato: users/{userId}, donde userId es la dirección de correo electrónico del usuario determinado.

Parámetros de consulta

Parámetros
pageSize

integer

Determina cuántos delegados se muestran en cada respuesta. Por ejemplo, si la solicitud establece

pageSize=1

y el usuario dado tiene dos delegados, la respuesta tiene dos páginas. El nombre de la respuesta

nextPageToken

tiene el token para la segunda página. Si no se establece, se usará el tamaño de página predeterminado.

pageToken

string

Un token de página para especificar la página siguiente. Un usuario con varios delegados tiene un

nextPageToken

en la respuesta. En tu solicitud de seguimiento para obtener el siguiente grupo de delegados, ingresa el

nextPageToken

en la

pageToken

cadena de consulta.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es un tipo de mensaje de respuesta para que un administrador enumere los delegados de un usuario determinado.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "delegates": [
    {
      object (Delegate)
    }
  ],
  "nextPageToken": string
}
Campos
delegates[]

object (Delegate)

Lista de delegados del usuario determinado.

nextPageToken

string

Token para recuperar los delegados de seguimiento de un usuario determinado. El

nextPageToken

se usa en la configuración de la solicitud

pageToken

cadena de consulta.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/admin.contact.delegation
  • https://www.googleapis.com/auth/admin.contact.delegation.readonly

Para obtener más información, consulta la Guía de autorización.