tipo de recurso calendarPermission

Namespace: microsoft.graph

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

Listar, criar, obter, atualizar e excluir permissões de calendário são suportadas 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 representante retorna uma coleção de permissões de calendário vazia.

Uma vez que um destinatário de compartilhamento ou representante tenha sido configurado para um calendário, você pode atualizar apenas a propriedade de função para alterar as permissões de um destinatário ou representante. Não é possível atualizar as propriedades allowedRoles, emailAddress, isInsideOrganization ou isRemovable . Para alterar essas propriedades, você deve excluir o objeto calendarPermission correspondente e criar outro destinatário ou representante em um cliente 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.
Get calendarPermission Propriedades de leitura e relações do objeto calendarPermission.
Atualizar calendarPermission Atualizar objeto calendarPermission.
Delete Nenhum Exclua o objeto calendarPermission.

Propriedades

Propriedade Tipo Descrição
allowedRoles Coleção calendarRoleType Lista dos níveis de permissão de compartilhamento ou delegação permitidos para o calendário. Os valores possíveis são: none, freeBusyRead, limitedRead, readwrite, , delegateWithoutPrivateEventAccess, , delegateWithPrivateEventAccess, . custom
emailAddress emailAddress Representa um destinatário ou representante de compartilhamento que tem acesso ao calendário. Para o destinatário do 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 representante) com quem o calendário foi compartilhado. Somente leitura.
isInsideOrganization Booliano Verdadeiro se o usuário no contexto (destinatário ou representante) estiver dentro da mesma organização que o proprietário do calendário.
isRemovable Booliano True Caso contrário, false se o usuário puder ser removido da lista de destinatários ou representantes do calendário especificado. O usuário "Minha organização" determina as permissões que outras pessoas na sua organização têm para o calendário determinado. Não é possível remover "Minha organização" como destinatário de compartilhamento de um calendário.
role calendarRoleType Nível de permissão atual do destinatário ou representante do compartilhamento de calendário.

valores calendarRoleType

Member Descrição
none O Calendar não é compartilhado com o usuário.
freeBusyRead O usuário é um destinatário que pode exibir o status de disponibilidade do proprietário no calendário.
Leitura limitada O usuário é um destinatário que pode exibir o status de disponibilidade, 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 os eventos particulares 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 representante que tem acesso de gravação, mas não pode exibir informações de eventos particulares do proprietário no calendário.
delegateWithPrivateEventAccess O usuário é um representante que tem acesso de gravação e pode exibir informações de eventos particulares 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"
}