type de ressource sharingLink

Espace de noms: microsoft.graph

Regroupe les éléments de données liés aux liens dans une structure unique.

Si une ressource d’autorisation a une facette sharingLink non null, l’autorisation représente un lien de partage (par opposition aux autorisations accordées à une personne ou un groupe).

Représentation JSON

La représentation JSON suivante montre le type de ressource.

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

Propriétés

Propriété Type Description
application identité Application à laquelle le lien est associé.
empêchettéléchargement Valeur booléenne Si la valeur est true, l’utilisateur peut uniquement utiliser ce lien pour afficher l’élément sur le web et ne peut pas l’utiliser pour télécharger le contenu de l’élément. Uniquement pour OneDrive Entreprise et SharePoint.
étendue String Étendue du lien représentée par cette autorisation. La valeur anonymous indique que le lien est utilisable par tout le monde, organization indique que le lien n’est utilisable que pour les utilisateurs connectés au même client.
type Chaîne Type de lien créé.
webHtml String Pour les liens embed, cette propriété contient le code HTML d’un élément <iframe> qui incorpore l’élément dans une page web.
webUrl Chaîne URL qui ouvre l’élément dans le navigateur sur le site web OneDrive.

Options de type

Ce tableau définit les valeurs possibles pour la propriété type :

Valeur Rôle Description
view read Lien de partage en lecture seule, qui permet un accès en lecture seule.
edit write Lien de partage de modification, qui permet un accès en lecture et en écriture.
embed read Lien de partage en lecture seule qui peut être utilisé pour incorporer du contenu dans une page web hôte. Les liens incorporés ne sont pas disponibles pour OneDrive Entreprise ou SharePoint.

Options d’étendue

Valeur Description
anonymous Toute personne disposant du lien peut accéder sans avoir besoin de se connecter. Cela peut inclure des personnes extérieures à votre organisation.
organization Toute personne connectée à votre client (locataire) peut utiliser le lien pour bénéficier de l’accès. Disponible uniquement dans OneDrive Entreprise et SharePoint.
existingAccess Seules les personnes qui ont déjà obtenu l’accès à l’élément par d’autres moyens peuvent accéder à l’élément à l’aide de ce lien. Disponible uniquement dans OneDrive Entreprise et SharePoint.
users Le lien accorde l’accès uniquement à une liste spécifique de personnes. Disponible uniquement dans OneDrive Entreprise et SharePoint.