type de ressource site

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 .

La ressource site fournit des métadonnées et des relations pour un site SharePoint.

Méthodes

Méthode Chemin d’accès REST
Accéder au site racine GET /sites/root
Accéder à un site GET /sites/{site-id}
Accéder à un site via un chemin d’accès GET /sites/{hostname}:/{site-path}
Obtenir un site pour un groupe GET /groups/{group-id}/sites/root
Obtenir les données analytiques GET /sites/{site-id}/analytics
Obtenir des activités par intervalle GET /sites/{site-id}/getActivitiesByInterval
Répertorier les pages GET /sites/{site-id}/pages
Répertorier les sites racine GET /sites?filter=root ne null&select=siteCollection,webUrl
Répertorier les sites dans les zones géographiques GET /site/getAllSites
Rechercher des sites GET /sites?search={query}
Suivre le site POST /users/{user-id}/followedSites/add
Ne plus suivre le site POST /users/{user-id}/followedSites/remove
Répertorier les sites suivis GET /me/followedSites
Obtenir une autorisation GET /sites/{site-id}/autorisations/{permission-id}
Répertorier les autorisations GET /sites/{site-id}/autorisations
Créer des autorisations POST /sites/{site-id}/autorisations
Supprimer une autorisation DELETE /sites/{site-id}/autorisations/{permission-id}
Mettre à jour une autorisation PATCH /sites/{site-id}/autorisations/{permission-id}
Types de contenu de liste OBTENIR /sites/{site-id}/Typesdecontenu
Créer Typedecontenu PUBLIER /sites/{site-id}/Typesdecontenu
Répertorier des colonnes OBTENIR /sites/{site-id}/colonnes
Créer une colonne PUBLIER /sites/{site-id}/colonnes
Répertorier les opérations GET /sites/{site-id}/operations
Obtenir les paramètres du site OBTENIR /sites/{site-id}/paramètres
Obtenir delta GET /sites/delta

Propriétés

Propriété Type Description
id String Identificateur unique de l’élément. En lecture seule.
createdDateTime DateTimeOffset Date et heure de création de l’élément. En lecture seule.
description string Texte descriptif pour le site.
eTag string ETag pour l’élément. En lecture seule.
displayName string Titre complet du site. En lecture seule.
lastModifiedDateTime DateTimeOffset Date et heure de dernière modification de l’élément. En lecture seule.
name string Nom/titre de l’élément.
racine racine Le cas échéant, fournit le site racine dans la collection de sites. En lecture seule.
paramètres siteSettings Paramètres de ce site. En lecture seule.
sharepointIds sharepointIds Renvoie les identificateurs utiles pour garantir la compatibilité de SharePoint REST. En lecture seule.
siteCollection siteCollection Fournit des détails sur la collection du site. Disponible uniquement sur le site racine. En lecture seule.
webUrl chaîne (URL) URL qui affiche l’élément dans le navigateur. En lecture seule.

id, propriété

Un site est identifié par un ID unique composé 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)

L’identificateur root fait toujours référence au site racine d’une cible donnée, comme suit :

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

Relations

Relation Type Description
analytics itemAnalytics Analyse des activités d’affichage qui ont eu lieu sur ce site.
colonnes collection columnDefinition Collection des définitions de colonne réutilisables dans plusieurs listes sous ce site.
contentTypes collection contentType Collection de types de contenu définis pour ce site.
Lecteur lecteur Lecteur par défaut (bibliothèque de documents) pour ce site.
lecteurs Collection d’objets lecteur Ensemble de lecteurs (bibliothèques de documents) de ce site.
externalColumns collection columnDefinition Collection de définitions de colonnes disponibles dans le site référencé à partir des sites de la hiérarchie parente du site actuel.
éléments collection baseItem Utilisé pour traiter tout élément figurant dans ce site. Cette collection ne peut pas être énumérée.
lists collection list Collection de listes en aval de ce site.
opérations Collection richLongRunningOperation Collection d’opérations de longue durée pour le site.
pages collection baseSitePage Collection de pages dans la liste baseSitePages sur ce site.
autorisations collection permission Autorisations associées au modèle de site. Pouvant accepter la valeur Null.
recycleBin recycleBin Conteneur pour une collection de ressources recycleBinItem dans ce site.
sites collection de sites Collection de sous-sites de ce site.
termStore microsoft.graph.termStore.store Le termStore sous ce site.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

La ressource site est dérivée de l’élément baseItem et hérite des propriétés de cette ressource.

{
  "displayName": "string",
  "id": "string",
  "root": { "@odata.type": "microsoft.graph.root" },
  "settings": { "@odata.type": "microsoft.graph.sitesettings" },
  "sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
  "siteCollection": {"@odata.type": "microsoft.graph.siteCollection"},

  /* relationships */
  "analytics": { "@odata.type": "microsoft.graph.itemAnalytics" },
  "columns": [ { "@odata.type": "microsoft.graph.columnDefinition" }],
  "contentTypes": [ { "@odata.type": "microsoft.graph.contentType" }],
  "externalColumns": [ { "@odata.type": "microsoft.graph.columnDefinition" }],
  "drive": { "@odata.type": "microsoft.graph.drive" },
  "drives": [ { "@odata.type": "microsoft.graph.drive" }],
  "items": [ { "@odata.type": "microsoft.graph.baseItem" }],
  "lists": [ { "@odata.type": "microsoft.graph.list" }],
  "permissions": [ { "@odata.type": "microsoft.graph.permission" }],
  "sites": [ { "@odata.type": "microsoft.graph.site"} ],
  "termStore": { "@odata.type": "microsoft.graph.termStore.store" },

  /* inherited from baseItem */
  "createdDateTime": "datetime",
  "description": "string",
  "eTag": "string",
  "lastModifiedDateTime": "datetime",
  "name": "string",
  "webUrl": "url"
}