Partager via

Obtenir une ressource de site par chemin d’accès

  • Article

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.

Vous pouvez récupérer un site par ID mais aussi en fonction du chemin de l’URL relative du serveur.

  • Nom d’hôte de la collection de sites (contoso.sharepoint.com)
  • Chemin du site, relatif au nom d’hôte du serveur.

Il existe également un identificateur de site réservé, root, qui fait toujours référence au site racine pour une cible donnée, comme suit :

  • /sites/root: Site racine du client.
  • /groups/{group-id}/sites/root: Site d’équipe du groupe.

Autorisations

L’une des autorisations suivantes est requise pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
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.
Application Sites.Read.All, Sites.ReadWrite.All

Requête HTTP

Pour accéder au site racine SharePoint avec un chemin relatif, procédez comme suit :

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

Réponse HTTP

Cette méthode renvoie une ressource site pour le site référencé par l’identificateur unique.

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"
}