Site-Ressourcentypsite resource type

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Die site-Ressource stellt Metadaten und Beziehungen für eine SharePoint-Website bereit.The site resource provides metadata and relationships for a SharePoint site.

MethodenMethods

MethodMethod REST-PfadREST Path
Stammwebsite abrufenGet root site GET /sites/rootGET /sites/root
Website abrufenGet site GET /sites/{site-id}GET /sites/{site-id}
Website nach Pfad abrufenGet site by path GET /sites/{hostname}:/{site-path}GET /sites/{hostname}:/{site-path}
Website für eine Gruppe abrufenGet site for a group GET /groups/{group-id}/sites/rootGET /groups/{group-id}/sites/root
Analysen abrufenGet analytics GET /sites/{site-id}/analyticsGET /sites/{site-id}/analytics
Aktivitäten nach Intervall abrufenGet activities by interval GET /sites/{site-id}/getActivitiesByIntervalGET /sites/{site-id}/getActivitiesByInterval
Seiten auflistenList pages GET /sites/{site-id}/pagesGET /sites/{site-id}/pages
Stammwebsites auflistenList root sites GET /sites?filter=root ne null&select=siteCollection,webUrlGET /sites?filter=root ne null&select=siteCollection,webUrl
Nach Websites suchenSearch for sites GET /sites?search={query}GET /sites?search={query}
Website folgenFollow Site POST /users/{user-id}/followedSites/addPOST /users/{user-id}/followedSites/add
Website nicht mehr folgenUnfollow Site POST /users/{user-id}/followedSites/removePOST /users/{user-id}/followedSites/remove

EigenschaftenProperties

EigenschaftennameProperty name TypType BeschreibungDescription
idid Zeichenfolgestring Der eindeutige Bezeichner des Elements.The unique identifier of the item. Schreibgeschützt.Read-only.
createdDateTimecreatedDateTime DateTimeOffsetDateTimeOffset Das Datum und die Uhrzeit der Erstellung des Elements. Schreibgeschützt.The date and time the item was created. Read-only.
descriptiondescription stringstring Der beschreibende Text für die Website.The descriptive text for the site.
eTageTag stringstring ETag für das Element. Schreibgeschützt.ETag for the item. Read-only.
displayNamedisplayName stringstring Der vollständigen Titel für die Website. Schreibgeschützt.The full title for the site. Read-only.
lastModifiedDateTimelastModifiedDateTime DateTimeOffsetDateTimeOffset Das Datum und die Uhrzeit der letzten Änderung des Elements. Schreibgeschützt.The date and time the item was last modified. Read-only.
namename stringstring Der Name/Titel des Elements.The name / title of the item.
rootroot rootroot Falls vorhanden, gibt diese Eigenschaft an, dass es sich um die Stammwebsite in der Websitesammlung handelt. Schreibgeschützt.If present, indicates that this is the root site in the site collection. Read-only.
sharepointIdssharepointIds sharepointIdssharepointIds Gibt Bezeichner zurück, die für SharePoint REST-Kompatibilität nützlich sind. Schreibgeschützt.Returns identifiers useful for SharePoint REST compatibility. Read-only.
siteCollectionsiteCollection siteCollectionsiteCollection Stellt Details über die Websitesammlung der Website bereit. Nur für die Stammwebsite verfügbar. Schreibgeschützt.Provides details about the site's site collection. Available only on the root site. Read-only.
webUrlwebUrl String (URL)string (url) URL, über die das Element im Browser angezeigt werden kann. Schreibgeschützt.URL that displays the item in the browser. Read-only.

Eigenschaft idid property

Eine sitewird durch eine eindeutige ID identifiziert, die aus den folgenden Werten zusammengesetzt ist:A site is addressed by a unique identifier which is a composite ID of the following values:

  • Hostname der Websitesammlung (contoso.SharePoint.com)Site collection hostname (contoso.sharepoint.com)
  • Eindeutige ID der Websitesammlung (GUID)Site collection unique ID (GUID)
  • Eindeutige ID der Website (GUID)Site unique ID (GUID)

Derroot Bezeichner verweist immer auf die Stammwebsite für ein angegebenes Ziel, wie folgt:There is also a reserved site identifier, root, which always references the root site for a given target, as follows:

  • /sites/root: Der Stammwebsite des Mandanten./sites/root: The tenant root site.
  • /groups/{group-id}/sites/root: Die Teamwebsite der Gruppe./groups/{group-id}/sites/root: The group's team site.

BeziehungenRelationships

BeziehungsnameRelationship name TypType BeschreibungDescription
analyticsanalytics itemAnalytics-RessourceitemAnalytics resource Analysen zu den Anzeigeaktivitäten, die auf dieser Website stattgefunden haben.Analytics about the view activities that took place in this site.
columnscolumns Sammlung (ColumnDefinition)Collection(columnDefinition) Die Sammlung der wiederverwendbaren Spaltendefinitionen von Listen unterhalb dieser Website.The collection of column definitions reusable across lists under this site.
contentTypescontentTypes Sammlung (contentType)Collection(contentType) Die Sammlung von für diese Website definierten Inhaltstypen.The collection of content types defined for this site.
drivedrive drivedrive Das Standardlaufwerk (Dokumentbibliothek) für diese Website.The default drive (document library) for this site.
drivesdrives Sammlung (drive)Collection(drive) Die Sammlung von Laufwerken (Dokumentbibliotheken) unter dieser Website.The collection of drives (document libraries) under this site.
itemsitems Sammlung (baseItem)Collection(baseItem) Wird verwendet, um ein beliebiges in dieser Website enthaltenes Element zu adressieren. Diese Sammlung kann nicht aufgezählt werden.Used to address any item contained in this site. This collection cannot be enumerated.
Listenlists Sammlung ([Liste][])Collection(list) Die Sammlung der Listen unter dieser Website.The collection of lists under this site.
pagespages Sammlung(sitePage)Collection(sitePage) Die Sammlung von Seiten in der SitePages-Liste auf dieser Website.The collection of pages in the SitePages list in this site.
sitessites Sammlung (site)Collection(site) Die Sammlung der Unterwebsites unter dieser Website.The collection of the sub-sites under this site.

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung einer site-Ressource.Here is a JSON representation of a site resource.

Die site-Ressource wird von baseItem abgeleitet und erbt Eigenschaften von dieser Ressource.The site resource is derived from baseItem and inherits properties from that resource.

{
  "id": "string",
  "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" }],
  "sites": [ { "@odata.type": "microsoft.graph.site"} ],
  "columns": [ { "@odata.type": "microsoft.graph.columnDefinition" }],

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