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 |
| Lister les modèles de page | GET /sites/{site-id}/pageTemplates/microsoft.graph.pageTemplate |
| 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 |
| Répertorier les sous-sites d’un site | GET /sites/{site-id}/sites |
| 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 |
| Créer un travail de traitement de document | POST /sites/{site-id}/documentProcessingJobs |
| 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. |
| contentModels | collection contentModel | Collection de modèles de contenu appliqués à 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. |
| documentProcessingJobs | collection documentProcessingJob | Travaux de traitement de documents en cours d’exécution sur 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. |
| pageTemplates | collection pageTemplate | Collection de modèles de page 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"
}