tipo de recurso sharingLink

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

El recurso sharingLink agrupa los elementos de datos relacionados con vínculos en una única estructura.

Si un recurso de permiso tiene una faceta sharingLink que no es null, el permiso representa un vínculo de uso compartido (en lugar de los permisos concedidos a una persona o grupo).

Representación JSON

La siguiente representación JSON muestra el tipo de recurso.

{
  "application": { "@odata.type": "microsoft.graph.identity" },
  "preventsDownload": false,
  "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.
preventsDownload	Booleano	Si es true, el usuario solo puede usar este vínculo para ver el elemento en la web y no puede usarlo para descargar el contenido del elemento. Solo para OneDrive para la Empresa y SharePoint.
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

En la tabla siguiente se definen los valores posibles para 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

En la tabla siguiente se definen los valores posibles para la propiedad scope .

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.
existingAccess	Solo las personas a las que ya se ha concedido acceso al elemento a través de otros medios pueden acceder al elemento mediante este vínculo. Disponible solo en OneDrive para la Empresa y en SharePoint.
users	El vínculo concede acceso solo a una lista específica de personas. Disponible solo en OneDrive para la Empresa y en SharePoint.