Compartilhar via


tipo de recurso sharingLink

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.

Os grupos de recursos do sharingLink vinculam itens de dados relacionados a uma única estrutura.

Se um recurso de permissão tiver uma faceta do compartilhamento não nuloLink , a permissão representará um link de compartilhamento (em oposição às permissões concedidas a uma pessoa ou grupo).

Representação JSON

A representação JSON a seguir mostra o tipo de recurso.

{
  "application": { "@odata.type": "microsoft.graph.identity" },
  "preventsDownload": false,
  "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.
preventsDownload Booliano Se for true, o usuário só poderá usar esse link para exibir o item na Web e não poderá usá-lo para baixar o conteúdo do item. Somente 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 a seguir 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

A tabela a seguir define os valores possíveis para a propriedade 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.
existingAccess Somente pessoas que já receberam acesso ao item por meio de outros meios podem acessar o item usando este link. Disponível apenas no OneDrive for Business e no SharePoint.
users O link concede acesso apenas a uma lista específica de pessoas. Disponível apenas no OneDrive for Business e no SharePoint.