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