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

  • Article

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

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

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

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

GET https://graph.microsoft.com/beta/sites/{hostname}:/{relative-path}

Réponse

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

HTTP/1.1 200 OK

{
  "id": "contoso.sharepoint.com,2C712604-1370-44E7-A1F5-426573FDA80A,2D2244C3-251A-49EA-93A8-39E1C3A060FE",
  "owner": {
    "user": {
      "displayName": "Daron Spektor",
      "id": "5280E7FE-DC7A-4486-9490-E790D81DFEB3"
    }
  },
  "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"
}