Freigeben über

SharingLink-Ressourcentyp

  • Artikel

Die SharingLink-Ressource gruppiert linkbezogene Datenelemente in einer einzelnen Struktur.

Wenn eine Permission-Ressource ein sharingLink-Facet ungleich Null aufweist, stellt die Berechtigung einen Freigabelink dar (im Gegensatz zu Berechtigungen, die einer Person oder Gruppe erteilten werden).

JSON-Darstellung

Es folgt eine JSON-Darstellung der Ressource.

{
  "application": { "@odata.type": "microsoft.graph.identity" },
  "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 String 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, und gibt an, organization dass der Link nur für Benutzer verwendet werden kann, die bei demselben Mandanten angemeldet sind.
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 String Eine URL, mit der das Element im Browser auf der OneDrive-Website geöffnet wird.

Typoptionen

In dieser Tabelle werden zulässige Werte für die type-Eigenschaft aufgeführt:

Wert Funktion 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

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.