Listar sitesList websites

Namespace: microsoft.graphNamespace: microsoft.graph

Importante

As APIs na /beta versão do Microsoft Graph estão sujeitas a alterações.APIs under the /beta version in Microsoft Graph are subject to change. Não há suporte para o uso dessas APIs em aplicativos de produção.Use of these APIs in production applications is not supported.

Recupere uma lista de objetos personWebsite de um perfilde usuário.Retrieve a list of personWebsite objects from a user's profile.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegada (conta corporativa ou de estudante)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
Delegada (conta pessoal da 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
AplicativoApplication User. ReadBasic. All, User. Read. All, User. ReadWrite. AllUser.ReadBasic.All, User.Read.All, User.ReadWrite.All

Solicitação HTTPHTTP request

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

Parâmetros de consulta opcionaisOptional query parameters

Este método oferece suporte aos seguintes parâmetros de consulta OData para ajudar a personalizar a resposta.This method supports the following OData query parameters to help customize the response. Para obter informações gerais, acesse Parâmetros de consulta OData.For general information, see OData query parameters.

NomeName ValorValue DescriçãoDescription
$filter$filter stringstring Limita a resposta somente aos objetos que contêm os critérios especificados.Limits the response to only those objects which contain the specified criteria.
$orderby$orderby cadeia de caracteresstring Por padrão, os objetos na resposta são classificados por seu valor createdDateTime em uma consulta.By default, the objects in the response are sorted by their createdDateTime value in a query. Você pode alterar a ordem da resposta usando o $orderby parâmetro.You can change the order of the of the response using the $orderby parameter.
$select$select stringstring Lista separada por vírgulas de propriedades para incluir na resposta. Para um desempenho ideal, selecione apenas o subconjunto de propriedades necessário.Comma-separated list of properties to include in the response. For optimal performance, only select the subset of properties needed.
$skip$skip intint Ignore os primeiros n resultados, útil para paginação.Skip the first n results, useful for paging.
$top$top intint Número de resultados a ser retornado.Number of results to be returned.

Cabeçalhos de solicitaçãoRequest headers

NomeName DescriçãoDescription
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.

Corpo da solicitaçãoRequest body

Não forneça um corpo de solicitação para esse método.Do not supply a request body for this method.

RespostaResponse

Se tiver êxito, este método retornará um 200 OK código de resposta e uma coleção de objetos personWebsite no corpo da resposta.If successful, this method returns a 200 OK response code and a collection of personWebsite objects in the response body.

ExemplosExamples

SolicitaçãoRequest

Este é um exemplo de solicitação.The following is an example of the request.

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

RespostaResponse

Este é um exemplo de resposta.The following is an example of the response.

Observação: o objeto response mostrado aqui pode ser encurtado para legibilidade. Todas as propriedades serão retornadas de uma chamada 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"
    }
  ]
}