type de ressource sharingLink

Article
04/09/2024

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).

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	Boolean	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.

Relations

Aucun.

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"
}

Partager via