type de ressource site
Espace de noms: microsoft.graph
La ressource site fournit des métadonnées et des relations pour un site SharePoint.
Méthodes
| Méthode | Type de retour | Description |
|---|---|---|
| Accéder au site racine | site | Accéder au site racine SharePoint au sein d’un client. |
| Accéder à un site | site | Accéder à un site SharePoint à l’aide du siteId. |
| Répertorier les sites dans les zones géographiques | collection de sites | Répertorier les sites dans toutes les zones géographiques d’une organisation. |
| Répertorier les sous-sites d’un site | collection de sites | Obtenez une collection de sous-sites définis pour un site. |
| Accéder à un site via un chemin d’accès | site | Accéder au site racine SharePoint avec un chemin relatif. |
| Obtenir un site pour un groupe | site | Accéder au site d’équipe d’un groupe. |
| Obtenir les données analytiques | itemAnalytics | Obtenir les données analytiques pour cette ressource. |
| Obtenir des activités par intervalle | itemActivityStat | Obtenir une collection d’itemActivityStats dans l’intervalle de temps spécifié. |
| Obtenir delta | collection de sites | Obtenez des sites nouvellement créés, mis à jour ou supprimés sans avoir à effectuer une lecture complète de l’ensemble de la collection de sites. |
| Rechercher des sites | collection de sites | Recherchez des sites qui correspondent aux mots clés fournis dans un locataire SharePoint. |
| Suivre le site | collection de sites | Suivre le ou les site(s) d’un utilisateur. |
| Ne plus suivre le site | collection de sites | Suivre le ou les site(s) d’un utilisateur. |
| Répertorier les sites suivis | collection de sites | Répertoriez les sites suivis par l’utilisateur connecté. |
| 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} | |
| Répertorier les opérations | Collection richLongRunningOperation | Obtenir une liste des opérations de longue durée riches associées à un site. |
| Répertorier les pages | GET /sites/{site-id}/pages |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| createdDateTime | DateTimeOffset | Date et heure de création de l’élément. En lecture seule. |
| description | string | Texte descriptif pour le site. |
| displayName | string | Titre complet du site. En lecture seule. |
| eTag | string | ETag pour l’élément. En lecture seule. |
| id | string | Identificateur unique de l’élément. En lecture seule. |
| isPersonalSite | bool | Identifie si le site est personnel ou non. 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. |
| 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 | Ressource 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. |
| drive | lecteur | Lecteur par défaut (bibliothèque de documents) pour ce site. |
| lecteurs | Collection(drive) | Ensemble de lecteurs (bibliothèques de documents) de ce site. |
| items | 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. |
| onenote | onenote | Appelle le service OneNote pour les opérations liées au bloc-notes. |
| operations | Collection richLongRunningOperation | Collection d’opérations de longue durée sur le site. |
| pages | Collection(baseSitePage) | Collection de pages dans la liste baseSitePages de ce site. |
| autorisations | Collection (autorisation) | Autorisations associées au modèle de site. Pouvant accepter la valeur Null. |
| sites | Collection(site) | Collection de sous-sites de ce site. |
| termStore | microsoft.graph.termStore.store | TermStore par défaut sous ce site. |
| termStores | Collection(microsoft.graph.termStore.store) | Collection de termStores 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.
{
"id": "string",
"isPersonalSite": "bool",
"root": { "@odata.type": "microsoft.graph.root" },
"sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
"siteCollection": {"@odata.type": "microsoft.graph.siteCollection"},
"displayName": "string",
/* relationships */
"analytics": { "@odata.type": "microsoft.graph.itemAnalytics" },
"contentTypes": [ { "@odata.type": "microsoft.graph.contentType" }],
"drive": { "@odata.type": "microsoft.graph.drive" },
"drives": [ { "@odata.type": "microsoft.graph.drive" }],
"items": [ { "@odata.type": "microsoft.graph.baseItem" }],
"lists": [ { "@odata.type": "microsoft.graph.list" }],
"operations": [ { "@odata.type": "microsoft.graph.richLongRunningOperation" }],
"permissions": [ { "@odata.type": "microsoft.graph.permission" }],
"sites": [ { "@odata.type": "microsoft.graph.site"} ],
"columns": [ { "@odata.type": "microsoft.graph.columnDefinition" }],
"onenote": { "@odata.type": "microsoft.graph.onenote"},
"termStore": { "@odata.type": "microsoft.graph.termStore.store" },
"termStores": [ { "@odata.type": "microsoft.graph.termStore.store" } ],
/* inherited from baseItem */
"name": "string",
"createdDateTime": "datetime",
"description": "string",
"eTag": "string",
"lastModifiedDateTime": "datetime",
"webUrl": "url"
}