Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Namespace: microsoft.graph
Wichtig
Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.
Die site-Ressource stellt Metadaten und Beziehungen für eine SharePoint-Website bereit.
Methoden
| Methode | REST-Pfad |
|---|---|
| Create | POST /sites |
| Get | GET /sites/{site-id} |
| Stammwebsite abrufen | GET /sites/root |
| 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 |
| Listenseitenvorlagen | GET /sites/{site-id}/pageTemplates/microsoft.graph.pageTemplate |
| Stammwebsites auflisten | GET /sites?filter=root ne null&select=siteCollection,webUrl |
| Auflisten von Websites in verschiedenen Regionen | GET /site/getAllSites |
| Auflisten der Unterwebsite für eine SharePoint-Website | GET /sites/{site-id}/sites |
| Nach Websites suchen | GET /sites?search={query} |
| Website Archiv | POST /sites/{site-id}/archive |
| Website abspeichern | POST /sites/{site-id}/unarchive |
| 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 |
| Dokumentverarbeitungsauftrag erstellen | POST /sites/{site-id}/documentProcessingJobs |
| Vorgänge auflisten | GET /sites/{site-id}/operations |
| Abrufen des Vorgangsstatus | GET /sites/getOperationStatus(operationId='{siteOperationId}') |
| Websiteeinstellungen abrufen | GET /sites/{site-id}/settings |
| Delta abrufen | GET /sites/delta |
| Offene Erweiterungen | |
| Offene Erweiterung erstellen | POST /sites/{site-id}/extensions |
| Offene Erweiterung abrufen | GET /sites/{site-id}/extensions |
| Offene Erweiterung aktualisieren | PATCH /sites/{site-id}/extensions |
| Offene Erweiterung löschen | DELETE /sites/{site-id}/extensions |
Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| createdDateTime | DateTimeOffset | Das Datum und die Uhrzeit, zu der die Website erstellt wurde. Schreibgeschützt. Geerbt von baseItem. |
| description | Zeichenfolge | Der beschreibende Text für die Website. Geerbt von baseItem. |
| displayName | Zeichenfolge | Der vollständigen Titel für die Website. Schreibgeschützt. |
| eTag | String | ETag für die Website angeben. Schreibgeschützt. Geerbt von baseItem. |
| id | Zeichenfolge | Der eindeutige Bezeichner der Website. Schreibgeschützt. Geerbt von baseItem. |
| lastModifiedDateTime | DateTimeOffset | Datum und Uhrzeit der letzten Änderung der Website. Schreibgeschützt. Geerbt von baseItem. |
| Gebietsschema | Zeichenfolge | Die Spracheinstellungen der Website. |
| lockState | siteLockState | Der Zustand der Website. Die möglichen Werte sind: unlocked, lockedReadOnly, lockedNoAccess, lockedNoAdditions, unknownFutureValue |
| name | Zeichenfolge | Der Name der Website. Geerbt von baseItem. |
| ownerIdentityToResolve | identityInput | Der Websitebesitzer wird nur zum Zeitpunkt der Websiteerstellung angegeben. |
| root | root | Falls vorhanden, wird die Stammwebsite in der Websitesammlung bereitgestellt. Schreibgeschützt. |
| settings | siteSettings | Die Einstellungen auf dieser Website. Schreibgeschützt. |
| shareByEmailEnabled | Boolean | Bestimmt, ob die Website und deren Inhalt per E-Mail geteilt werden können. |
| 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. |
| template | siteTemplateType | Gibt die auf die Website angewendete Vorlage an. Die möglichen Werte sind: sitepagepublishing, sts, unknownFutureValue. |
| webUrl | Zeichenfolge | Die URL für die Website, die nur zum Zeitpunkt der Websiteerstellung angegeben werden kann. Schreibgeschützt. Geerbt von baseItem. |
Eigenschaft id
Eine sitewird 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 |
|---|---|---|
| Analysen | itemAnalytics | Analysedaten zu den Aktivitäten, die auf dieser Website ausgeführt wurden. |
| columns | columnDefinition collection | Die Sammlung der wiederverwendbaren Spaltendefinitionen von Listen unterhalb dieser Website. |
| contentModels | contentModel-Sammlung | Die Sammlung von Inhaltsmodellen, die auf diese Website angewendet werden. |
| contentTypes | contentType-Auflistung | Die Sammlung von für diese Website definierten Inhaltstypen. |
| Laufwerk | drive | Das Standardlaufwerk (Dokumentbibliothek) für diese Website. |
| documentProcessingJobs | documentProcessingJob collection | Die auf dieser Website ausgeführten Dokumentverarbeitungsaufträge. |
| drives | drive-Sammlung | Die Sammlung von Laufwerken (Dokumentbibliotheken) unter dieser Website. |
| Erweiterungen | extension-Sammlung | Die Sammlung geöffneter Erweiterungen, die für diese Website definiert sind. Nullwerte zulassend. |
| externalColumns | columnDefinition collection | Die Auflistung der auf der Website verfügbaren Spaltendefinitionen, auf die von den Websites in der übergeordneten Hierarchie der aktuellen Website verwiesen wird. |
| items | baseItem-Sammlung | Wird verwendet, um ein beliebiges in dieser Website enthaltenes Element zu adressieren. Diese Sammlung kann nicht aufgelistet werden. |
| lists | Listensammlung | Die Sammlung der Listen unter dieser Website. |
| operations | richLongRunningOperation-Sammlung | Die Sammlung von Vorgängen mit langer Ausführungszeit für die Website. |
| Seiten | baseSitePage-Sammlung | Die Sammlung von Seiten in der baseSitePages-Liste auf dieser Website. |
| pageTemplates | pageTemplate-Sammlung | Die Sammlung von Seitenvorlagen auf dieser Website. |
| Berechtigungen | permission collection | Die der Website zugeordneten Berechtigungen. Nullwerte zulassend. |
| Papierkorb | Papierkorb | Ein Container für eine Auflistung von recycleBinItem-Ressourcen auf dieser Website. |
| sites | site-Sammlung | Die Sammlung der Unterwebsites unter dieser Website. |
| termStore | microsoft.graph.termStore.store | Der termStore unter dieser Website. |
JSON-Darstellung
Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.
Die site-Ressource wird von baseItem abgeleitet und erbt Eigenschaften von dieser 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"
}