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 de versão.

As permissões de um usuário com o qual o calendário foi compartilhado ou delegado em um Outlook cliente.

Há suporte para listar, criar, obter, atualizar e excluir permissões de calendário em nome apenas do proprietário do calendário.

Obter as permissões de calendário de um calendário em nome de um compartilhamento ou representante retorna uma coleção de permissões de calendário vazia.

Depois que um compartilhamento ou representante for definido para um calendário, você poderá atualizar apenas a propriedade role para alterar as permissões de um compartilhamento ou representante. Não é possível atualizar a propriedade allowedRoles, emailAddress, isInsideOrganization ou isRemovable. Para alterar essas propriedades, exclua o objeto calendarPermission correspondente e crie outro compartilhamento ou representante em um cliente Outlook cliente.

Métodos

Método	Tipo de retorno	Descrição
List	calendarPermission	Obter uma coleção de objetos calendarPermission que descrevem a identidade e as funções dos usuários com os quais o calendário especificado foi compartilhado ou delegado.
Criar	calendarPermission	Criar objeto calendarPermission.
Obter calendarPermission	calendarPermission	Ler propriedades e relações do objeto calendarPermission.
Atualização	calendarPermission	Atualizar objeto calendarPermission.
Delete	Nenhum	Excluir objeto calendarPermission.

Propriedades

Propriedade	Tipo	Descrição
allowedRoles	Coleção calendarRoleType	Lista de níveis de permissão de compartilhamento 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 compartilhamento ou representante que tem acesso ao calendário. Para o compartilhamento "Minha Organização", a propriedade address é nula. Somente leitura.
id	Cadeia de caracteres	O identificador exclusivo do usuário (compartilhamento ou representante) com o qual o calendário foi compartilhado. Somente leitura.
isInsideOrganization	Boolean	True se o usuário no contexto (compartilhamento ou representante) estiver dentro da mesma organização que o proprietário do calendário.
isRemovable	Booliano	True se o usuário puder ser removido da lista de compartilhamentos ou representantes do calendário especificado, false caso contrário. O usuário "Minha organização" determina as permissões que outras pessoas em sua organização têm para o calendário determinado. Não é possível remover "Minha organização" como um compartilhamento para um calendário.
role	calendarRoleType	Nível de permissão atual do compartilhamento de calendário ou representante.

Valores calendarRoleType

Member	Descrição
none	Calendário não é compartilhado com o usuário.
freeBusyRead	O usuário é um compartilhamento que pode exibir o status de livre/ocupado do proprietário no calendário.
limitedRead	O usuário é um compartilhamento que pode exibir o status de livre/ocupado e títulos e locais dos eventos no calendário.
leitura	O usuário é um compartilhamento que pode exibir todos os detalhes dos eventos no calendário, exceto os eventos particulares do proprietário.
gravação	O usuário é um compartilhamento que pode exibir todos os detalhes (exceto eventos particulares) e editar eventos no calendário.
delegateWithoutPrivateEventAccess	O usuário é um representante que tem acesso a gravação, mas não pode exibir informações dos eventos privados do proprietário no calendário.
delegateWithPrivateEventAccess	O usuário é um representante que tem acesso a gravação e pode exibir informações dos eventos privados do proprietário no calendário.
custom	O usuário tem permissões personalizadas para o calendário.

Representação JSON

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

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