Obtenir une ressource de site

  • Article
  • 2 minutes de lecture

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 clients multigé géographiques) est accessible avec dataLocationCode de la géographie, comme suit :

  • /sites/NAM: site racine de l’instance amérique du Nord du client
  • /sites/EUR: site racine de l’instance européenne du client

Autorisations

L’une des autorisations suivantes est nécessaire 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 moins de privilèges à celle qui en offre le plus)
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"
}