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"
}