sharingLink-Ressourcentyp

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 Ressourcengruppen "sharingLink " verknüpfen zugehörige Datenelemente in einer einzigen Struktur.

Wenn eine Berechtigungsressource über eine SharingLink-Facette ungleich NULL verfügt, stellt die Berechtigung einen Freigabelink dar (im Gegensatz zu Berechtigungen, die einer Person oder Gruppe erteilt wurden).

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 allen Benutzern verwendet werden kann. Gibt an, dass der Link nur für Benutzer verwendet werden kann, organization die beim gleichen Mandanten angemeldet sind.
verhindert Download Boolean Wenn der Wert TRUE ist, kann der Benutzer diesen Link nur verwenden, um das Element im Web anzuzeigen, und nicht zum Herunterladen der Inhalte des Details. 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 String 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 type-Eigenschaft definiert.

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

In der folgenden Tabelle sind die möglichen Werte für die scope-Eigenschaft 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 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 einer bestimmten Liste von Personen Zugriff. Nur in OneDrive for Business und SharePoint verfügbar.

Beziehungen

Keine.

JSON-Darstellung

Die folgende JSON-Darstellung veranschaulicht den Ressourcentyp.

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