Compartilhar via


tipo de recurso calendarPermission

Namespace: microsoft.graph

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 devolve uma coleção de permissões de calendário vazia.

Assim que um destinatário ou delegado de partilha tiver sido configurado para um calendário, só pode atualizara propriedade da função para alterar as permissões de um destinatário ou delegado. 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 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 (destinatário ou delegado) com quem o calendário foi partilhado. Somente leitura.
isInsideOrganization Booliano Verdadeiro se o utilizador no contexto (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 um destinatário de partilha para 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 que pode ver status de disponibilidade do proprietário no calendário.
limitedRead O utilizador é um destinatário que pode ver status de disponibilidade e títulos e localizações dos eventos no calendário.
leitura O utilizador é um destinatário 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 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"
}