tipo de recurso calendarPermission

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.

As permissões de um utilizador com quem o calendário foi partilhado ou delegado num cliente do Outlook.

A lista, criação, obtenção, atualização e eliminação de permissões de calendário é suportada apenas em nome do proprietário do calendário.

Obter as permissões de calendário de um calendário em nome de um destinatário ou delegado de partilha devolve uma coleção de permissões de calendário vazia.

Depois de configurar um destinatário ou delegado de partilha para um calendário, só pode atualizara propriedade da função para alterar as permissões de um destinatário ou delegado de partilha. Não pode atualizar a propriedade allowedRoles, emailAddress, isInsideOrganization ou isRemovable . Para alterar estas propriedades, deve eliminar o objeto calendarPermission correspondente e criar outro destinatário ou delegado de partilha num cliente do Outlook.

Métodos

Método	Tipo de retorno	Descrição
List	calendarPermission	Obtenha uma coleção de objetos calendarPermission que descrevem a identidade e as funções dos utilizadores com os quais o calendário especificado foi partilhado ou delegado.
Create	calendarPermission	Create objeto calendarPermission.
Get	calendarPermission	Ler propriedades e relações do objeto calendarPermission.
Atualizar	calendarPermission	Atualizar o objeto calendarPermission.
Delete	Nenhum	Eliminar o objeto calendarPermission.

Propriedades

Propriedade	Tipo	Descrição
allowedRoles	coleção calendarRoleType	Lista de níveis de permissão de partilha ou delegação permitidos para o calendário. Os valores possíveis são: none, freeBusyRead, limitedRead, read, write, delegateWithoutPrivateEventAccess, delegateWithPrivateEventAccess, custom.
emailAddress	emailAddress	Representa um destinatário ou delegado de partilha que tem acesso ao calendário. Para o destinatário da partilha "A Minha Organização", a propriedade de endereço é nula. Somente leitura.
id	Cadeia de caracteres	O identificador exclusivo do utilizador (partilhar destinatário ou delegado) com quem o calendário foi partilhado. Somente leitura.
isInsideOrganization	Booliano	Verdadeiro se o utilizador no contexto (partilhar destinatário ou delegado) estiver dentro da mesma organização que o proprietário do calendário.
isRemovable	Booliano	True se o utilizador puder ser removido da lista de destinatários ou delegados do calendário especificado, false caso contrário. O utilizador "A minha organização" determina as permissões que outras pessoas na sua organização têm para o calendário especificado. Não pode remover "A minha organização" como destinatário de um calendário.
role	calendarRoleType	Nível de permissão atual do destinatário ou delegado da partilha de calendário.

valores calendarRoleType

Member	Descrição
none	O calendário não é partilhado com o utilizador.
freeBusyRead	O utilizador é um destinatário de partilha que pode ver status de disponibilidade do proprietário no calendário.
limitedRead	O utilizador é um destinatário de partilha que pode ver status de disponibilidade e títulos e localizações dos eventos no calendário.
leitura	O utilizador é um destinatário da partilha que pode ver todos os detalhes dos eventos no calendário, exceto os eventos privados do proprietário.
gravação	O utilizador é um destinatário de partilha que pode ver todos os detalhes (exceto eventos privados) e editar eventos no calendário.
delegateWithoutPrivateEventAccess	O utilizador é um delegado que tem acesso de escrita, mas não consegue ver as informações dos eventos privados do proprietário no calendário.
delegateWithPrivateEventAccess	O utilizador é um delegado que tem acesso de escrita e pode ver informações dos eventos privados do proprietário no calendário.
personalizado	O utilizador tem permissões personalizadas para o calendário.

Representação JSON

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

{
  "allowedRoles": ["string"],
  "emailAddress": {"@odata.type": "microsoft.graph.emailAddress"},
  "id": "String (identifier)",
  "isInsideOrganization": "boolean",
  "isRemovable": "boolean",
  "role": "string"
}