sharingLink tipo de recurso

Artigo
12/27/2024

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

A partilhaLigar grupos de recursos liga itens de dados relacionados com uma única estrutura.

Se um recurso de permissão tiver uma faceta sharingLink não nula, a permissão representa uma ligação de partilha (em oposição às permissões concedidas a uma pessoa ou grupo).

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.
preventsDownload	Booliano	Se for verdadeiro, o utilizador só pode utilizar esta ligação para ver o item na Web e não pode utilizá-lo para transferir o conteúdo do item. Apenas para OneDrive for Business e SharePoint.
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

A tabela seguinte 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 âmbito

A tabela seguinte define os valores possíveis para a propriedade de âmbito .

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.
`existingAccess`	Apenas as pessoas a quem já tenha sido concedido acesso ao item através de outros meios podem aceder ao item através desta ligação. Disponível apenas no OneDrive for Business e no SharePoint.
`users`	A ligação concede acesso apenas a uma lista específica de pessoas. Disponível apenas no OneDrive for Business e no SharePoint.

Relações

Nenhum

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

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

Compartilhar via