Method: users.settings.cse.identities.list

Muestra una lista de las identidades encriptadas del cliente para un usuario autenticado.

Solicitud HTTP

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities

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

Parámetros de ruta de acceso

Parámetros
userId

string

La dirección de correo electrónico principal del solicitante. Para indicar el usuario autenticado, puedes usar el valor especial me.

Parámetros de consulta

Parámetros
pageToken

string

Es un token de paginación que indica qué página de identidades se debe mostrar. Si no se proporciona el token, la API mostrará la primera página de resultados.

pageSize

integer

Es la cantidad de identidades que se mostrarán. Si no se proporciona, el tamaño de página será de 20 entradas de forma predeterminada.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Si el proceso es satisfactorio, el cuerpo de la respuesta contiene datos con la siguiente estructura:

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

object (CseIdentity)

Una página de la lista de identidades de CSE configuradas para el usuario.

nextPageToken

string

Es un token de paginación que se pasará a una llamada posterior a identities.list para recuperar la siguiente página de identidades. Si no se muestra este valor o si es una cadena vacía, significa que no hay más páginas.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • 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
  • https://www.googleapis.com/auth/gmail.settings.sharing

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