sharingLink-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 sharingLink-Ressource gruppiert verknüpfungsbezogene Datenelemente in einer einzigen Struktur.

Wenn eine Berechtigungsressource über ein Facet "sharingLink" ungleich Null verfügt, stellt die Berechtigung einen Freigabelink dar (im Gegensatz zu Berechtigungen, die einer Person oder Gruppe erteilt wurden).

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "application": { "@odata.type": "microsoft.graph.identity" },
  "preventsDownload": false,
  "type": "view | edit | embed",
  "scope": "anonymous | organization",
  "webHtml": "string",
  "webUrl": "url"
}

Eigenschaften

Eigenschaft	Typ	Beschreibung
application	Identität	Die App, der der Link zugeordnet ist.
type	Zeichenfolge	Der Typ des erstellten Links.
scope	String	Der Bereich des Links, der durch diese Berechtigung dargestellt wird. Der Wert anonymous gibt an, dass der Link von jedem Benutzer verwendet werden kann. organization gibt an, dass der Link von Benutzern verwendet werden kann, die bei dem gleichen Mandanten angemeldet sind.
preventsDownload	Boolescher Wert	Bei "true" kann der Benutzer diesen Link nur zum Anzeigen des Elements im Web und nicht zum Herunterladen des Inhalts des Elements verwenden. Nur für OneDrive for Business und SharePoint.
webHtml	Zeichenfolge	Bei embed Links enthält diese Eigenschaft den HTML-Code für ein <iframe>-Element, das das Element in eine Webseite einbettet.
webUrl	Zeichenfolge	Eine URL, mit der das Element im Browser auf der OneDrive-Website geöffnet wird.

Typoptionen

In der folgenden Tabelle sind die möglichen Werte für die Typeigenschaft definiert.

Wert	Rolle	Beschreibung
view	read	Ein Freigabelink zum Anzeigen für schreibgeschützten Zugriff.
edit	write	Ein Freigabelink zum Bearbeiten für Lese-/Schreibzugriff.
embed	read	Ein schreibgeschützter Freigablink, der zum Einbetten von Inhalten in einer Hostwebseite verwendet werden kann. Einbettlinks sind nicht für OneDrive for Business oder SharePoint verfügbar.

Bereichsoptionen

In der folgenden Tabelle sind die möglichen Werte für die Bereichseigenschaft definiert.

Wert	Beschreibung
anonymous	Jeder Benutzer, der über den Link verfügt, hat Zugriff, ohne sich anmelden zu müssen. Dies kann auch Personen von außerhalb Ihrer Organisation einschließen.
organization	Jede Person, die bei Ihrer Organisation (Mandant) angemeldet ist, kann den Link verwenden, um Zugriff zu erhalten. Nur in OneDrive for Business und SharePoint verfügbar.
existingAccess	Nur Personen, denen bereits auf andere Weise Zugriff auf das Element gewährt wurde, können über diesen Link auf das Element zugreifen. Nur in OneDrive for Business und SharePoint verfügbar.
users	Der Link gewährt nur Zugriff auf eine bestimmte Liste von Personen. Nur in OneDrive for Business und SharePoint verfügbar.