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} |
| Archiv Website | POST /sites/{site-id}/archive |
| Aufheben der Archivierung der Website | 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 |
| Vorgang abrufen status | 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 der Erstellung der Website. 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. Schreibgeschützt. Geerbt von baseItem. |
| id | Zeichenfolge | Der eindeutige Bezeichner der Website. Schreibgeschützt. Geerbt von baseItem. |
| lastModifiedDateTime | DateTimeOffset | Das Datum und die 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, der nur zum Zeitpunkt der Websiteerstellung angegeben werden soll. |
| 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 ihr Inhalt per E-Mail freigegeben 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. Mögliche Werte sind: sitepagepublishing, group, sts, unknownFutureValue. |
| webUrl | Zeichenfolge | Die URL für die Website, die nur zum Zeitpunkt der Websiteerstellung bereitgestellt 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 | Analysen zu den Ansichtsaktivitäten, die auf dieser Website stattgefunden haben. |
| columns | columnDefinition-Auflistung | 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-Auflistung | Die Dokumentverarbeitungsaufträge, die auf dieser Website ausgeführt werden. |
| drives | drive-Sammlung | Die Sammlung von Laufwerken (Dokumentbibliotheken) unter dieser Website. |
| Erweiterungen | extension-Sammlung | Die Sammlung von offenen Erweiterungen, die für diese Website definiert sind. Nullwerte zulassend. |
| externalColumns | columnDefinition-Auflistung | Die Auflistung von Spaltendefinitionen, die in der Website verfügbar sind, auf die von den Websites in der übergeordneten Hierarchie des aktuellen Standorts verwiesen wird. |
| items | baseItem-Auflistung | Wird verwendet, um ein beliebiges in dieser Website enthaltenes Element zu adressieren. Diese Auflistung kann nicht aufgelistet werden. |
| lists | List-Sammlung | 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 Auflistung von Seiten in der BaseSitePages-Liste auf dieser Website. |
| pageTemplates | pageTemplate-Auflistung | Die Sammlung von Seitenvorlagen auf dieser Website. |
| Berechtigungen | permission collection | Die der Website zugeordneten Berechtigungen. Nullwerte zulassend. |
| recycleBin | recycleBin | Ein Container für eine Sammlung 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"
}