tipo de recurso calendarPermission

Namespace: microsoft.graph

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

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 destinatário ou delegado retorna uma coleção de permissões de calendário vazias.

Depois que um destinatário ou delegado de compartilhamento tiver sido configurado para um calendário, você poderá atualizar apenas a propriedade de função para alterar as permissões de um destinatário ou delegado. Você não pode atualizar a propriedade allowedRoles, emailAddress, isInsideOrganization ou isRemovable . Para alterar essas propriedades, você deve excluir o objeto calendarPermission correspondente e criar outro destinatário ou delegado em um 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 usuários com os quais o calendário especificado foi compartilhado ou delegado.
Create calendarPermission Criar objeto calendarPermission.
Obter calendarPermission calendarPermission Ler propriedades e relações do objeto calendarPermission.
Atualizar 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 destinatário ou delegado de compartilhamento que tem acesso ao calendário. Para o destinatário de compartilhamento "Minha Organização", a propriedade de endereço é nula. Somente leitura.
id Cadeia de caracteres O identificador exclusivo do usuário (destinatário ou delegado) com quem o calendário foi compartilhado. Somente leitura.
isInsideOrganization Booliano True se o usuário no contexto (destinatário ou delegado) 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 destinatários ou delegados para o 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. Você não pode remover "Minha organização" como destinatário de compartilhamento para um calendário.
role calendarRoleType Nível de permissão atual do destinatário ou delegado do compartilhamento de calendário.

valores calendarRoleType

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

Representação JSON

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

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