sharingLink-RessourcentypsharingLink resource type

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Die sharingLink -Ressource gruppiert Verknüpfungs bezogene Datenelemente in einer einzelnen Struktur.The sharingLink resource groups link-related data items into a single structure.

Wenn eine Permission -Ressource ein sharingLink -Facet ungleich NULL aufweist, stellt die Berechtigung einen Freigabe Link dar (im Gegensatz zu Berechtigungen, die einer Person oder Gruppe erteilt werden).If a permission resource has a non-null sharingLink facet, the permission represents a sharing link (as opposed to permissions granted to a person or group).

JSON-DarstellungJSON representation

Es folgt eine JSON-Darstellung der Ressource.Here is a JSON representation of the resource.

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

EigenschaftenProperties

EigenschaftProperty TypType BeschreibungDescription
applicationapplication Identitätidentity Die App, der der Link zugeordnet ist.The app the link is associated with.
typetype StringString Der Typ des erstellten Links.The type of the link created.
scopescope StringString 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.The scope of the link represented by this permission. Value anonymous indicates the link is usable by anyone, organization indicates the link is only usable for users signed into the same tenant.
preventsDownloadpreventsDownload BooleschBoolean Wenn true, kann der Benutzer diesen Link nur verwenden, um das Element im Internet anzuzeigen, und kann ihn nicht zum Herunterladen des Inhalts des Elements verwenden.If true then the user can only use this link to view the item on the web, and cannot use it to download the contents of the item. Nur für OneDrive für Unternehmen und SharePoint.Only for OneDrive for Business and SharePoint.
webHtmlwebHtml StringString Bei embed Links enthält diese Eigenschaft den HTML-Code für ein <iframe>-Element, das das Element in eine Webseite einbettet.For embed links, this property contains the HTML code for an <iframe> element that will embed the item in a webpage.
webUrlwebUrl StringString Eine URL, mit der das Element im Browser auf der OneDrive-Website geöffnet wird.A URL that opens the item in the browser on the OneDrive website.

Typ-OptionenType options

In der folgenden Tabelle werden die möglichen Werte für die Type -Eigenschaft definiert.The following table defines the possible values for the type property.

WertValue FunktionRole BeschreibungDescription
view read Ein Freigabelink zum Anzeigen für schreibgeschützten Zugriff.A view-only sharing link, allowing read-only access.
edit write Ein Freigabelink zum Bearbeiten für Lese-/Schreibzugriff.An edit sharing link, allowing read-write access.
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.A view-only sharing link that can be used to embed content into a host webpage. Embed links are not available for OneDrive for Business or SharePoint.

BereichsoptionenScope options

In der folgenden Tabelle werden die möglichen Werte für die Scope -Eigenschaft definiert.The following table defines the possible values for the scope property.

WertValue BeschreibungDescription
anonymous Jeder, der über die Verknüpfung verfügt, hat Zugriff, ohne dass Sie sich anmelden müssen.Anyone with the link has access, without needing to sign in. Dies kann Personen außerhalb Ihrer Organisation einschließen.This may include people outside of your organization.
organization Jeder, der bei Ihrer Organisation (dem Mandanten) angemeldet ist, kann den Link verwenden, um Zugriff zu erhalten.Anyone signed into your organization (tenant) can use the link to get access. Nur verfügbar in OneDrive für Unternehmen und SharePoint.Only available in OneDrive for Business and SharePoint.
existingAccess Nur Personen, die über andere Mittel bereits Zugriff auf das Element erhalten haben, können über diesen Link auf das Element zugreifen.Only people who have already been granted access to the item through other means can access the item using this link. Nur verfügbar in OneDrive für Unternehmen und SharePoint.Only available in OneDrive for Business and SharePoint.
users Der Link gewährt nur Zugriff auf eine bestimmte Personenliste.The link grants access only to a specific list of people. Nur verfügbar in OneDrive für Unternehmen und SharePoint.Only available in OneDrive for Business and SharePoint.