Enumerar sitios webList websites

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. Para determinar si una API está disponible en v 1.0, use el selector de versiones .To determine whether an API is available in v1.0, use the Version selector.

Recupere una lista de objetos personWebsite desde el perfilde un usuario.Retrieve a list of personWebsite 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/websites
GET /users/{id | userPrincipalName}/profile/websites

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 en 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 $orderby parámetro.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 personWebsite en el cuerpo de la respuesta.If successful, this method returns a 200 OK response code and a collection of personWebsite objects in the response body.

EjemplosExamples

SolicitudRequest

Aquí tiene un ejemplo de la solicitud.The following is an example of the request.

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

RespuestaResponse

Aquí tiene un ejemplo de la respuesta.The following is an example of the response.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad. Se devolverán todas las propiedades de una llamada real.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

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

{
  "value": [
    {
      "id": "0fb4c1e3-c1e3-0fb4-e3c1-b40fe3c1b40f",
      "allowedAudiences": "organization",
      "inference": null,
      "createdDateTime": "2020-07-06T06:34:12.2294868Z",
      "createdBy": {
        "application": null,
        "device": null,
        "user": {
          "displayName": "Innocenty Popov",
          "id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
        }
      },
      "lastModifiedDateTime": "2020-07-06T06:34:12.2294868Z",
      "lastModifiedBy": {
        "application": null,
        "device": null,
        "user": {
          "displayName": "Innocenty Popov",
          "id": "db789417-4ccb-41d1-a0a9-47b01a09ea49"
        }
      },
      "categories": [
        "football"
      ],
      "description": "Lyn Damer play in the Women's 1st Division (Toppserien) in Norway",
      "displayName": "Lyn Damer",
      "webUrl": "www.lyndamer.no"
    }
  ]
}