Obtenir une ressource de site

Article
04/08/2023

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.

Un site reçoit un identificateur unique qui est un code composite des valeurs suivantes :

Nom d’hôte de la collection de sites (contoso.sharepoint.com)
ID unique de la collection de sites (GUID)
ID unique du site (GUID)

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.

En outre, le site racine d’une instance géographique particulière (pour les locataires multigéographiques) est accessible avec le dataLocationCode de geography, comme suit :

/sites/NAM: site racine de l’instance nord-américaine du locataire
/sites/EUR: site racine de l’instance européenne du locataire

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

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
GET /sites/JPN

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

Exemple

Demande

GET /sites/{site-id}

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

Partager via