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

Muestra una lista de 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 sigue el formato: users/{userId}, en el que 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 determinado tiene dos delegados, la respuesta tiene dos páginas. El nombre de la respuesta

nextPageToken

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

string

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

nextPageToken

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

nextPageToken

valor en el

pageToken

cadena de consulta.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Es el tipo de mensaje de respuesta para que un administrador enumere a 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

valor se usa en el

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.