Tipo de recurso SharingLink

El recurso SharingLink agrupa en una sola estructura los elementos de datos relacionados con vínculos.

Si un recurso Permission tiene una faceta sharingLink que no es NULL, el permiso representa un vínculo para compartir (a diferencia de los permisos concedidos a una persona o un grupo).

Representación JSON

Aquí tiene una representación JSON del recurso.

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

Propiedades

Propiedad	Tipo	Descripción
application	identity	La aplicación con la que está asociada el vínculo.
type	String	El tipo del vínculo creado.
scope	String	El ámbito del vínculo representado por este permiso. El valor anonymous indica que cualquier usuario puede usar el vínculo, organization indica que solo pueden usar el vínculo los usuarios que han iniciado sesión en el mismo inquilino.
webHtml	Cadena	Para los vínculos embed, esta propiedad contiene el código HTML para un elemento <iframe> que insertará el elemento en una página web.
webUrl	String	Una dirección URL que abre el elemento en el explorador en el sitio web de OneDrive.

Opciones de tipo

Esta tabla define los valores posibles de la propiedad type:

Valor	Rol	Descripción
view	read	Un vínculo para compartir de solo vista, que permite el acceso de solo lectura.
edit	write	Un vínculo para compartir de edición, que permite el acceso de lectura y escritura.
embed	read	Un vínculo para compartir de solo vista que puede usarse para insertar contenido en una página web de host. La opción de inserción de vínculos no está disponible en OneDrive para la Empresa o SharePoint.

Opciones de ámbito

Valor	Descripción
anonymous	Cualquier persona con el vínculo tiene acceso, sin necesidad de iniciar sesión. Se incluyen personas de fuera de su organización.
organization	Cualquier persona que haya iniciado sesión en su organización (espacio empresarial) podrá usar el vínculo para obtener acceso. Disponible solo en OneDrive para la Empresa y en SharePoint.