Partager via


Obtenir une ressource de site

Espace de noms: microsoft.graph

Récupérez les propriétés et les relations d’une ressource de site. Une ressource de site représente un site d’équipe dans SharePoint.

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) Sites.Read.All Sites.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application Sites.Read.All Sites.ReadWrite.All

Requête HTTP

Obtenir le site racine du client

Pour accéder au site racine SharePoint au sein d’un client, procédez comme suit :

GET /sites/root
GET /sites/contoso.sharepoint.com

Accéder à un site via l’URL du serveur

Si vous disposez de l’URL du serveur d’une ressource de site, vous pouvez créer une requête en procédant comme suit :

GET /sites/{hostname}:/{server-relative-path}

Accéder à un site d’équipe de groupe

Pour accéder au site d’équipe d’un groupe, procédez comme suit :

GET /groups/{group-id}/sites/root

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.

Exemples

Exemple 1 : Obtenir un site à l’aide de l’ID de site

Demande

L’exemple suivant montre une requête qui obtient un site par son ID de site. Un ID de site est la valeur de la propriété id de sa ressource de site . Pour plus d’informations sur le format de l’ID de site, consultez site.

GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE

Réponse

L’exemple suivant illustre la réponse.

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

{
  "id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE",
  "isPersonalSite": false,
  "displayName": "OneDrive Team Site",
  "name": "1drvteam",
  "createdDateTime": "2017-05-09T20:56:00Z",
  "lastModifiedDateTime": "2017-05-09T20:56:01Z",
  "webUrl": "https://contoso.sharepoint.com/teams/1drvteam"
}

Exemple 2 : Obtenir un site par URL relative du serveur

Demande

L’exemple suivant montre une requête qui obtient un site par son nom d’hôte et son chemin d’accès relatif au serveur.

GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/teams/1drvteam

Réponse

L’exemple suivant illustre la réponse.

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

{
  "id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE",
  "displayName": "OneDrive Team Site",
  "name": "1drvteam",
  "createdDateTime": "2017-05-09T20:56:00Z",
  "lastModifiedDateTime": "2017-05-09T20:56:01Z",
  "webUrl": "https://contoso.sharepoint.com/teams/1drvteam"
}

Exemple 3 : Obtenir le site d’un groupe

Demande

L’exemple suivant montre une requête qui obtient le site d’un groupe par la propriété id d’un groupe.

GET https://graph.microsoft.com/v1.0/groups/2C712604-1370-44E7-A1F5-426573FDA80A/sites/root

Réponse

L’exemple suivant illustre la réponse.

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

{
  "id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE",
  "displayName": "OneDrive Team Site",
  "name": "1drvteam",
  "createdDateTime": "2017-05-09T20:56:00Z",
  "lastModifiedDateTime": "2017-05-09T20:56:01Z",
  "webUrl": "https://contoso.sharepoint.com/teams/1drvteam"
}