type de ressource sharingLink

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Les groupes de ressources sharingLink lient les éléments de données associés 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é.
type	Chaîne	Type de lien créé.
scope	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.
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.
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

Le tableau suivant 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

Le tableau suivant définit les valeurs possibles pour la propriété 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.