Site-Ressourcentyp

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Die site-Ressource stellt Metadaten und Beziehungen für eine SharePoint-Website bereit.

Methoden

Methode	REST-Pfad
Stammwebsite abrufen	GET /sites/root
Website abrufen	GET /sites/{site-id}
Website nach Pfad abrufen	GET /sites/{hostname}:/{site-path}
Website für eine Gruppe abrufen	GET /groups/{group-id}/sites/root
Analysen abrufen	GET /sites/{site-id}/analytics
Aktivitäten nach Intervall abrufen	GET /sites/{site-id}/getActivitiesByInterval
Seiten auflisten	GET /sites/{site-id}/pages
Stammwebsites auflisten	GET /sites?filter=root ne null&select=siteCollection,webUrl
Nach Websites suchen	GET /sites?search={query}
Website folgen	POST /users/{user-id}/followedSites/add
Website nicht mehr folgen	POST /users/{user-id}/followedSites/remove
Websites auflisten, denen gefolgt wird	GET /me/followedSites
Berechtigung abrufen	GET /sites/{site-id}/permissions/{permission-id}
Berechtigungen auflisten	GET /sites/{site-id}/permissions
Berechtigungen erstellen	POST /sites/{site-id}/permissions
Berechtigung löschen	DELETE /sites/{site-id}/permissions/{permission-id}
Berechtigung aktualisieren	PATCH /sites/{site-id}/permissions/{permission-id}
Listeninhaltstypen	GET /sites/{site-id}/contentTypes
contentType erstellen	POST /sites/{site-id}/contentTypes
Spalten auflisten	GET /sites/{site-id}/columns
Spalte erstellen	POST /sites/{site-id}/columns
Vorgänge auflisten	GET /sites/{site-id}/operations
Websiteeinstellungen abrufen	GET /sites/{site-id}/settings

Eigenschaften

Eigenschaft	Typ	Beschreibung
id	string	Der eindeutige Bezeichner des Elements. Schreibgeschützt.
createdDateTime	DateTimeOffset	Das Datum und die Uhrzeit der Erstellung des Elements. Schreibgeschützt.
description	string	Der beschreibende Text für die Website.
eTag	string	ETag für das Element. Schreibgeschützt.
displayName	string	Der vollständigen Titel für die Website. Schreibgeschützt.
lastModifiedDateTime	DateTimeOffset	Das Datum und die Uhrzeit der letzten Änderung des Elements. Schreibgeschützt.
name	string	Der Name/Titel des Elements.
root	root	Falls vorhanden, gibt diese Eigenschaft an, dass es sich um die Stammwebsite in der Websitesammlung handelt. Schreibgeschützt.
Einstellungen	siteSettings	Die Einstellungen auf dieser Website. Schreibgeschützt.
sharepointIds	sharepointIds	Gibt Bezeichner zurück, die für SharePoint REST-Kompatibilität nützlich sind. Schreibgeschützt.
siteCollection	siteCollection	Stellt Details über die Websitesammlung der Website bereit. Nur für die Stammwebsite verfügbar. Schreibgeschützt.
webUrl	String (URL)	URL, über die das Element im Browser angezeigt werden kann. Schreibgeschützt.

Eigenschaft id

Eine site wird durch eine eindeutige ID identifiziert, die aus den folgenden Werten zusammengesetzt ist:

• Hostname der Websitesammlung (contoso.SharePoint.com)
• Eindeutige ID der Websitesammlung (GUID)
• Eindeutige ID der Website (GUID)

Derroot Bezeichner verweist immer auf die Stammwebsite für ein angegebenes Ziel, wie folgt:

• /sites/root: Der Stammwebsite des Mandanten.
• /groups/{group-id}/sites/root: Die Teamwebsite der Gruppe.

Beziehungen

Beziehung	Typ	Beschreibung
analytics	itemAnalytics-Ressource	Analysen zu den Anzeigeaktivitäten, die auf dieser Website stattgefunden haben.
columns	Sammlung (ColumnDefinition)	Die Sammlung der wiederverwendbaren Spaltendefinitionen von Listen unterhalb dieser Website.
contentTypes	Sammlung (contentType)	Die Sammlung von für diese Website definierten Inhaltstypen.
drive	drive	Das Standardlaufwerk (Dokumentbibliothek) für diese Website.
drives	Sammlung (drive)	Die Sammlung von Laufwerken (Dokumentbibliotheken) unter dieser Website.
items	Sammlung (baseItem)	Wird verwendet, um ein beliebiges in dieser Website enthaltenes Element zu adressieren. Diese Sammlung kann nicht aufgezählt werden.
Listen	Sammlung ([Liste][])	Die Sammlung der Listen unter dieser Website.
operations	richLongRunningOperation-Sammlung	Die Sammlung von Vorgängen mit langer Ausführungszeit für die Website.
pages	Sammlung(sitePage)	Die Sammlung von Seiten in der SitePages-Liste auf dieser Website.
Berechtigungen	Sammlung (permission)	Die der Website zugeordneten Berechtigungen. Nullwerte zulassend.
sites	Sammlung (site)	Die Sammlung der Unterwebsites unter dieser Website.
termStore	microsoft.graph.termStore.store	Der termStore unter dieser Website.
externalColumns	Sammlung (ColumnDefinition)	Die Sammlung der in der Website verfügbaren Spaltendefinitionen, die von den Websites in der übergeordneten Hierarchie der aktuellen Website referenziert werden.

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

Die site-Ressource wird von baseItem abgeleitet und erbt Eigenschaften von dieser 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"
}