Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 |
|---|---|
| Create | POST /sites |
| Obtenir | GET /sites/{site-id} |
| Accéder au site racine | GET /sites/root |
| 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} |
| Archive site | POST /sites/{site-id}/archive |
| Annuler l’archivage du site | POST /sites/{site-id}/unarchive |
| 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 status de l’opération | GET /sites/getOperationStatus(operationId='{siteOperationId}') |
| Obtenir les paramètres du site | OBTENIR /sites/{site-id}/paramètres |
| Obtenir delta | GET /sites/delta |
| Extensions d’ouverture | |
| Créer une extension d’ouverture | POST /sites/{site-id}/extensions |
| Obtenir une extension d’ouverture | GET /sites/{site-id}/extensions |
| Mettre à jour une extension ouverte | PATCH /sites/{site-id}/extensions |
| Supprimer une extension ouverte | DELETE /sites/{site-id}/extensions |
Propriétés
| Propriété | Type | Description |
|---|---|---|
| createdDateTime | DateTimeOffset | Date et heure de création du site. En lecture seule. Hérité de baseItem. |
| description | String | Texte descriptif pour le site. Hérité de baseItem. |
| displayName | String | Titre complet du site. En lecture seule. |
| eTag | String | ETag pour le site. En lecture seule. Hérité de baseItem. |
| id | String | Identificateur unique du site. En lecture seule. Hérité de baseItem. |
| lastModifiedDateTime | DateTimeOffset | Date et heure de la dernière modification du site. En lecture seule. Hérité de baseItem. |
| local | String | Paramètres de langue du site. |
| lockState | siteLockState | État du site. Les valeurs possibles sont : unlocked, lockedReadOnly, lockedNoAccess, lockedNoAdditions, unknownFutureValue |
| nom | String | Nom du site. Hérité de baseItem. |
| ownerIdentityToResolve | identityInput | Propriétaire du site à fournir au moment de la création du site uniquement. |
| root | root | 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. |
| shareByEmailEnabled | Booléen | Détermine si le site et son contenu peuvent être partagés par e-mail. |
| 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. |
| template | siteTemplateType | Spécifie le modèle appliqué au site. Les valeurs possibles sont : sitepagepublishing, group, sts, unknownFutureValue. |
| webUrl | String | URL du site qui ne peut être fournie qu’au moment de la création du site. En lecture seule. Hérité de baseItem. |
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. |
| extensions | collection extension | Collection d’extensions ouvertes définies pour ce site. Pouvant accepter la valeur Null. |
| 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",
"locale": "String",
"lockState": "String",
"ownerIdentityToResolve": {"@odata.type": "microsoft.graph.identityInput"},
"root": { "@odata.type": "microsoft.graph.root" },
"settings": { "@odata.type": "microsoft.graph.sitesettings" },
"shareByEmailEnabled": "Boolean",
"sharepointIds": { "@odata.type": "microsoft.graph.sharepointIds" },
"siteCollection": {"@odata.type": "microsoft.graph.siteCollection"},
"template": "String",
/* relationships */
"analytics": { "@odata.type": "microsoft.graph.itemAnalytics" },
"columns": [ { "@odata.type": "microsoft.graph.columnDefinition" }],
"contentTypes": [ { "@odata.type": "microsoft.graph.contentType" }],
"extensions": [ { "@odata.type": "microsoft.graph.extension" }],
"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"
}