Tipo de recurso SharingLink

O recurso SharingLink agrupa itens de dados relacionados ao link em uma única estrutura.

Se um recurso Permission tiver uma faceta sharingLink não nula, a permissão representará um link de compartilhamento (em vez de permissões concedidas a uma pessoa ou um grupo).

Representação JSON

Veja a seguir uma representação JSON do recurso.

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

Propriedades

Propriedade	Tipo	Descrição
aplicativo	identity	O aplicativo ao qual o link está associado.
type	String	O tipo do link criado.
scope	String	O escopo do link representado por esta permissão. O valor anonymous indica que o link é utilizável por qualquer pessoa; organization indica que o link só é útil para usuários conectados ao mesmo locatário.
webHtml	String	Para links embed, essa propriedade contém o código HTML para um elemento <iframe> que inserirá o item em uma página da Web.
webUrl	String	Uma URL que abre o item no navegador no site do OneDrive.

Opções de tipo

Esta tabela define os valores possíveis para a propriedade type:

Valor	Função	Descrição
view	read	Um link somente de compartilhamento para exibição, permitindo o acesso somente leitura.
edit	write	Um link de compartilhamento de edição, permitindo o acesso de leitura e gravação.
embed	read	Um link de compartilhamento somente exibição que pode ser usado para inserir o conteúdo em uma página da Web de hospedagem. Os links de compartilhamento não estão disponíveis para OneDrive for Business ou SharePoint.

Opções de escopo

Valor	Descrição
anonymous	Qualquer pessoa com o link tem acesso, sem precisar fazer logon. Isso pode incluir pessoas de fora da organização.
organization	Qualquer pessoa que tenha feito logon em sua organização (locatário) pode usar o link para obter acesso. Disponível apenas no OneDrive for Business e no SharePoint.