tipo de recurso calendar
Namespace: microsoft.graph
Representa um contêiner para recursos de evento. Pode ser um calendário para um usuárioou o calendário padrão de um grupo do Microsoft 365.
Observação: existem algumas pequenas diferenças na maneira como você pode interagir com calendários de usuários e calendários de grupos:
- Você pode organizar apenas os calendários de usuários em calendarGroup.
- O Outlook aceita automaticamente todas as solicitações de reunião em nome de grupos. Pode aceitar, aceitar em modo de tentativa ou recusar pedidos de reunião apenas para calendários de utilizador.
- O Outlook não oferece suporte a lembretes de eventos do grupo. Você pode adiar ou descartar um lembrete apenas para calendários do usuário.
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Listar calendários | Coleção calendar | Obtenha todos os calendários do usuário ou os calendários no grupo de calendários padrão ou em outro grupo de calendários específico. |
| Criar calendário | calendar | Crie um novo calendário no grupo de calendário padrão ou no grupo de calendários especificado para um usuário. |
| Obter calendário | calendar | Obtenha as propriedades e as relações de um objeto calendar. O calendário pode ser um para um usuário ou o calendário padrão de um grupo do Microsoft 365. |
| Atualizar calendário | calendar | Atualize as propriedades de um objeto calendar. O calendário pode ser um para um usuário ou o calendário padrão de um grupo do Microsoft 365. |
| Excluir calendário | Nenhum | Exclua um objeto calendar. |
| Listar modo de exibição de calendário | Coleção event | Obtenha as ocorrências, as exceções e as instâncias de eventos únicas em uma visão de calendário definida por um intervalo de tempo, do calendário principal do usuário (../me/calendarview) ou de um calendário especificado. |
| Listar eventos | Coleção event | Recupere uma lista de eventos em um calendário. A lista contém reuniões de instância única e reuniões mestres em série. |
| Criar Evento | event | Crie um novo evento no calendário especificado ou padrão. |
| Obter agenda de disponibilidade | Coleção scheduleInformation | Obtenha as informações de disponibilidade para um conjunto de usuários, listas de distribuição ou recursos para um período especificado. |
| Encontrar horários de reunião | meetingTimeSuggestionsResult | Sugira horários e locais para a reunião com base no organizador e na disponibilidade dos participantes, além de restrições de horário ou local. |
| Criar uma propriedade de valor único | calendar | Criar uma ou mais propriedades estendidas de valor único em um calendário novo ou existente. |
| Obter uma propriedade de valor único | calendar | Obter calendários que contenham uma propriedade estendida de valor único usando $expand ou $filter. |
| Criar propriedade com múltiplos valores | calendar | Criar uma ou mais propriedades estendidas de vários valores em um calendário novo ou existente. |
| Obter propriedade de múltiplos valores | calendar | Obter um calendário que contenha uma propriedade estendida de vários valores usando $expand. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| allowedOnlineMeetingProviders | onlineMeetingProviderType collection | Represente os provedores de serviços de reunião online que podem ser usados para criar reuniões online neste calendário. Os valores possíveis são: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness. |
| canEdit | Booliano |
true se o usuário pode escrever no calendário, false caso contrário. Esta propriedade é true para o usuário que criou o calendário. Esta propriedade também é true para um usuário que compartilhou uma agenda e recebeu acesso de gravação. |
| canShare | Boolean |
true se o usuário tiver permissão para compartilhar a agenda, false caso contrário. Apenas o usuário que criou o calendário pode compartilhá-lo. |
| canViewPrivateItems | Boolean |
true se o usuário pode ler itens de calendário que foram marcados como privados, false caso contrário. |
| changeKey | String | Identifica a versão do objeto calendar. Sempre que o calendário é alterado, changeKey também é alterado. Isso permite que o Exchange aplique as alterações na versão correta do objeto. Somente leitura. |
| color | calendarColor | Especifica o tema de cores para distinguir o calendário de outros calendários em uma interface do usuário. Os valores das propriedades são: auto, lightBlue, lightGreen, lightOrange, lightGray, lightYellow, lightTeal, lightPink, lightBrown, lightRed, maxColor |
| defaultOnlineMeetingProvider | onlineMeetingProviderType | O provedor de reunião online padrão para reuniões enviadas deste calendário. Os valores possíveis são: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness. |
| hexColor | String | A cor do calendário, expressa em um código de cor hexadecimal de três valores hexadecimais, cada um variando de 00 a FF e representando os componentes vermelho, verde ou azul da cor no espaço de cores RGB. Se o usuário nunca tiver definido explicitamente uma cor para o calendário, esta propriedade estará vazia. Somente leitura. |
| id | String | Identificador exclusivo do calendário. Somente leitura. |
| isDefaultCalendar | Booliano |
true se este for o calendário padrão onde novos eventos são criados por padrão, false caso contrário. |
| isRemovable | Booliano | Indica se o calendário deste usuário pode ser excluído da caixa de correio do usuário. |
| isTallyingResponses | Booliano | Indica se o calendário deste usuário dá suporte ao acompanhamento de respostas de reunião. Somente os convites para reuniões enviados do calendário principal do usuário oferecem suporte para respostas de reunião. |
| nome | String | O nome do calendário. |
| owner | emailAddress | Se definida, representa o usuário que criou ou adicionou o calendário. Para um calendário que o usuário criou ou adicionou, a propriedade owner é definida para o usuário. Para um calendário compartilhado com o usuário, a propriedade owner é definida para a pessoa que compartilhou o calendário com o usuário. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| calendarPermissions | Coleção de calendarPermission | As permissões dos usuários com os quais o calendário é compartilhado. |
| calendarView | Coleção Event | O modo de exibição do calendário. Propriedade de navegação. Somente leitura. |
| events | Coleção Event | Os eventos do calendário. Propriedade de navegação. Somente leitura. |
| multiValueExtendedProperties | Coleção multiValueLegacyExtendedProperty | A coleção de propriedades estendidas de vários valores definidas para o calendário. Somente leitura. Anulável. |
| singleValueExtendedProperties | Coleção singleValueLegacyExtendedProperty | A coleção de propriedades estendidas de vários valores definidas para a mensagem. Somente leitura. Anulável. |
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"allowedOnlineMeetingProviders": ["string"],
"canEdit": "boolean",
"canShare": "boolean",
"canViewPrivateItems": "boolean",
"changeKey": "string",
"color": "String",
"defaultOnlineMeetingProvider": "string",
"hexColor": "String",
"id": "string (identifier)",
"isDefaultCalendar": "boolean",
"isRemovable": "boolean",
"isTallyingResponses": "boolean",
"name": "string",
"owner": {"@odata.type": "microsoft.graph.emailAddress"}
}