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

Article
03/14/2024

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.

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

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

En-têtes de demande

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

Exemple

Demande

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

GET https://graph.microsoft.com/v1.0/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
Content-Type: application/json

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

Partager via