Partager via


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
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"
}