Enumerar correos electrónicosList emails

Espacio de nombres: microsoft.graphNamespace: microsoft.graph

Importante

Las API de la /beta versión de Microsoft Graph están sujetas a cambios.APIs under the /beta version in Microsoft Graph are subject to change. No se admite el uso de estas API en aplicaciones de producción.Use of these APIs in production applications is not supported.

Recupere una lista de objetos itemEmail desde el perfilde un usuario.Retrieve a list of itemEmail objects from a user's profile.

PermisosPermissions

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permisoPermission type Permisos (de menos a más privilegiados)Permissions (from least to most privileged)
Delegado (cuenta profesional o educativa)Delegated (work or school account) User. Read, User. ReadWrite, User. ReadBasic. All, User. Read. All, User. ReadWrite. AllUser.Read, User.ReadWrite, User.ReadBasic.All, User.Read.All, User.ReadWrite.All
Delegado (cuenta personal de Microsoft)Delegated (personal Microsoft account) User. Read, User. ReadWrite, User. ReadBasic. All, User. Read. All, User. ReadWrite. AllUser.Read, User.ReadWrite, User.ReadBasic.All, User.Read.All, User.ReadWrite.All
AplicaciónApplication User. ReadBasic. All, User. Read. All, User. ReadWrite. AllUser.ReadBasic.All, User.Read.All, User.ReadWrite.All

Solicitud HTTPHTTP request

GET /me/profile/emails
GET /users/{id | userPrincipalName}/profile/emails

Parámetros de consulta opcionalesOptional query parameters

Este método admite los siguientes parámetros de consulta de OData a modo de ayuda para personalizar la respuesta.This method supports the following OData query parameters to help customize the response. Para obtener información general, vea Parámetros de consulta OData.For general information, see OData query parameters.

NombreName ValorValue DescripciónDescription
$filter$filter stringstring Limita la respuesta a solo los objetos que contienen los criterios especificados.Limits the response to only those objects which contain the specified criteria.
$orderby$orderby cadenastring De forma predeterminada, los objetos de la respuesta se ordenan por su valor createdDateTime en una consulta.By default the objects in the response are sorted by their createdDateTime value in a query. Puede cambiar el orden de la respuesta mediante el parámetro $OrderBy .You can change the order of the of the response using the $orderby parameter.
$select$select stringstring Lista separada por comas de las propiedades que se van a incluir en la respuesta. Para un rendimiento óptimo, seleccione solo el subconjunto de propiedades necesarias.Comma-separated list of properties to include in the response. For optimal performance, only select the subset of properties needed.
$skip$skip intint Omitir los primeros n resultados, útiles para la paginación.Skip the first n results, useful for paging.
$top$top intint Número de resultados que se van a devolver.Number of results to be returned.

Encabezados de solicitudRequest headers

NombreName DescripciónDescription
AuthorizationAuthorization {token} de portador. Obligatorio.Bearer {token}. Required.

Cuerpo de la solicitudRequest body

No proporcione un cuerpo de solicitud para este método.Do not supply a request body for this method.

RespuestaResponse

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y una colección de objetos itemEmail en el cuerpo de la respuesta.If successful, this method returns a 200 OK response code and a collection of itemEmail objects in the response body.

EjemplosExamples

GET https://graph.microsoft.com/beta/me/profile/emails

RespuestaResponse

Nota: el objeto de respuesta que se muestra aquí podría acortarse para facilitar la legibilidad.Note: The response object shown here might be shortened for readability.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "e13f7a4d-303c-464f-a6af-80ea18eb74f3",
      "allowedAudiences": "organization",
      "inference": null,
      "createdDateTime": "2020-07-06T06:34:12.2294868Z",
      "createdBy": {
        "user": {
            "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
            "displayName": "Innocenty Popov"
        }
      },
      "lastModifiedDateTime": "2020-07-08T06:34:12.2294868Z",
      "lastModifiedBy": {
        "user": {
            "id": "efee1b77-fb3b-4f65-99d6-274c11914d12",
            "displayName": "Innocenty Popov"
        }
      },
      "source": {
        "type": "User"
      },
      "address": "innocenty.popov@adventureworks.com",
      "displayName": "Innocenty Popov",
      "type": "work"
    }
  ]
}