tipo de recurso de evento

  • Artigo

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.

Um evento em um calendário de usuário ou o calendário padrão de um grupo do Microsoft 365.

O número máximo de participantes incluídos em um evento e o número máximo de destinatários em uma eventMessage enviada de uma caixa de correio do Exchange Online é 500. Para obter mais informações, veja limites de envio.

Esse recurso permite:

Observação: existem algumas pequenas diferenças na maneira como você pode interagir com calendários de usuários, calendários de grupos e seus eventos:

  • Você pode organizar apenas os calendários de usuários em calendarGroup.
  • Você pode adicionar objetos anexos a apenas eventos de calendários de usuário, mas não a eventos em calendários de grupo.
  • 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 de usuário.

Métodos

Método Tipo de retorno Descrição
Listar eventos Event collection Recuperar uma lista de objetos event na caixa de correio do usuário. A lista contém reuniões de instância única e reuniões mestres em série.
Criar evento event Criar um novo evento postando na coleção de instâncias.
Obter evento event Ler as propriedades e as relações do objeto event.
Atualizar evento event Atualizar o objeto event.
Excluir evento Nenhum Excluir o objeto event.
Obter delta Coleção event Obtenha um conjunto de eventos que foram adicionados, excluídos ou atualizados em um calendarView (um intervalo de eventos) do calendário principal do usuário.
Encaminhar evento Nenhum Permite que o organizador ou os participantes de um evento de reunião encaminhe a solicitação de reunião para um novo destinatário.
Cancelar evento Nenhum Enviar a mensagem de cancelamento do organizador para todos os participantes e cancelar a reunião específica.
Aceitar evento Nenhum Aceite o evento específico em um calendário do usuário.
Aceitar provisoriamente Nenhum Aceitar provisoriamente o evento específico em um calendário de usuário.
Recusar evento Nenhum Recusar o convite para o evento específico em um calendário de usuário.
Descartar lembrete Nenhum Descarte o lembrete do evento específico em um calendário de usuário.
Adiar lembrete Nenhum Adie um lembrete de evento específico em um calendário do usuário até um novo horário.
Listar instâncias de eventos Event collection Obtenha uma coleção do objeto Event.
Anexos
Listar anexos Attachment collection Obtenha todos os anexos em um evento.
Add attachment Attachment Adicione um novo anexo a um evento postando na coleção attachments.
Extensões abertas
Criar extensão aberta openTypeExtension Crie uma extensão aberta e adicione propriedades personalizadas a uma instância nova ou existente de um recurso.
Obter extensão aberta Coleção openTypeExtension Obtenha uma extensão aberta identificada pelo nome da extensão.
Propriedades estendidas
Criar uma propriedade de valor único event Criar uma ou mais propriedades estendidas de valor único em um evento novo ou existente.
Obter uma propriedade de valor único event Obter eventos que contenham uma propriedade estendida de valor único usando $expand ou $filter.
Criar propriedade com múltiplos valores event Criar uma ou mais propriedades estendidas de vários valores em um evento novo ou existente.
Obter propriedade de múltiplos valores event Obter um evento que contenha uma propriedade estendida de vários valores usando $expand.

Propriedades

Propriedade Tipo Descrição
allowNewTimeProposals Booliano true se o organizador da reunião permitir que os convidados proponham uma nova hora ao responder; caso contrário, false. Opcional. O padrão é true.
attendees Coleção de participantes A coleção de participantes do evento.
corpo ItemBody O corpo da mensagem associada ao evento. Pode estar no formato HTML ou no formato de texto.
bodyPreview String A visualização da mensagem associada ao evento. Está no formato de texto.
categories Coleção de cadeias de caracteres As categorias associadas ao evento. Cada categoria corresponde à propriedade displayName de uma outlookCategory definida para o usuário.
changeKey String Identifica a versão do objeto event. Toda vez que o evento muda, ChangeKey também muda. Isso permite que o Exchange aplique alterações à versão correta do objeto.
createdDateTime DateTimeOffset O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z
end DateTimeTimeZone A data, a hora e o fuso horário em que o evento termina. Por padrão, a hora de término é em UTC.
hasAttachments Booliano Defina como true se o evento tiver anexos.
hideAttendees Booliano Quando definido como true, cada participante só se vê na solicitação de reunião e na lista de Rastreamento da reunião. O padrão é false.
iCalUId Cadeia de caracteres Um único identificador para um evento em todos os calendários. Esta identificação é diferente para cada ocorrência em uma série recorrente. Somente leitura.
id Cadeia de caracteres Identificador exclusivo do evento. Por padrão, esse valor muda quando o item é transferido de um contêiner (como uma pasta ou calendário) para outro. Para alterar esse comportamento, use o cabeçalho Prefer: IdType="ImmutableId". Para obter mais informações, consulte o artigo Obter identificadores imutáveis para recursos do Outlook. Sensível a maiúsculas e minúsculas e somente leitura.
importância Cadeia de caracteres A importância do evento. Os valores possíveis são: low, normal, high.
isAllDay Booliano Defina como true se o evento durar o dia inteiro. Se estiver definido como true, independentemente de ser um evento de um ou de vários dias, a hora de início e término deve ser definida como meia-noite e estar no mesmo fuso horário.
isCancelled Booliano Defina como true se o evento tiver sido cancelado.
isDraft Boleano Defina como verdadeiro se o usuário atualizou a reunião no Outlook mas não enviou as atualizações aos participantes. Defina como falso se todas as alterações forem enviadas, ou se o evento for um compromisso sem participantes.
isOnlineMeeting Booliano TrueSe esse evento tiver informações de reunião online (ou seja, onlineMeeting aponta para um recurso onlineMeetingInfo), caso contrário false. O padrão é false (onlineMeeting é null). Opcional.
Depois de definir isOnlineMeeting como true, o Microsoft Graph Inicializa onlineMeeting. Subsequentemente, o Outlook ignora todas as alterações feitas em isOnlineMeetinge a reunião permanece disponível online.
isOrganizer Booliano Defina como verdadeiro se o proprietário do calendário (especificado pela propriedade do proprietário do calendário) for o organizador do evento (especificado pela propriedade do organizador do evento). Isso também se aplica se um representante organizou o evento em nome do proprietário.
isReminderOn Booliano Defina como true se um alerta estiver definido para lembrar o usuário sobre o evento.
lastModifiedDateTime DateTimeOffset O tipo Timestamp representa informações de data e hora usando o formato ISO 8601 e está sempre no horário UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z
location Location O local do evento.
locations location collection Locais onde o evento é realizado ou onde participar. As propriedades location e locations sempre correspondem entre si. Se você atualizar a propriedade location, os locais anteriores na coleção locations deverão ser removidos e substituídos pelo novo valor location.
onlineMeeting OnlineMeetingInfo Detalhes para o participante entrar na reunião online. O padrão é nulo. Apenas leitura.
Depois de definir as propriedades isOnlineMeeting e onlineMeetingProvider para habilitar uma reunião online, o Microsoft Graph Inicializa onlineMeeting. Depois de definida, a reunião ficará disponível on-line e você não poderá alterar as propriedades isOnlineMeeting, onlineMeetingProvider e onlineMeeting novamente.
onlineMeetingProvider onlineMeetingProviderType Representa o provedor de serviços de reunião online. Por padrão, onlineMeetingProvider é unknown. Os valores possíveis são unknown, teamsForBusiness, skypeForBusiness e skypeForConsumer. Opcional.
Depois de definir onlineMeetingProvider, o Microsoft Graph Inicializa onlineMeeting. Em seguida, não será possível alterar onlineMeetingProvider novamente, e a reunião permanecerá disponível online.
onlineMeetingUrl String Uma URL para uma reunião online. A propriedade só é definida quando um organizador especifica no Outlook que um evento é uma reunião online como o Skype. Somente leitura.
Acesse a URL para entrar em uma reunião online usando joinUrl, exposto por meio da propriedade onlineMeeting do evento. A propriedade onlineMeetingUrl será substituído no futuro.
organizer Recipient O organizador do evento.
originalEndTimeZone String O fuso horário de término que foi definido quando o evento foi criado. Um valor de tzone://Microsoft/Custom indica que um fuso horário personalizado herdado foi definido no Outlook para área de trabalho.
originalStart DateTimeOffset Representa a hora de início de um evento quando ele é inicialmente criado como uma ocorrência ou exceção em uma série recorrente. Essa propriedade não é retornada para eventos que são instâncias individuais. As informações de data e hora são expressas no formato ISO 8601 e estão sempre em UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z
originalStartTimeZone String O fuso horário de início que foi definido quando o evento foi criado. Um valor de tzone://Microsoft/Custom indica que um fuso horário personalizado herdado foi definido no Outlook para área de trabalho.
recurrence PatternedRecurrence O padrão de recorrência do evento.
reminderMinutesBeforeStart Int32 O número de minutos antes da hora de início do evento em que o alerta de lembrete ocorre.
responseRequested Booliano O padrão é true, representando que o organizador gostaria de ter um convidado para enviar uma resposta para o evento.
responseStatus ResponseStatus Indica o tipo de resposta enviada em resposta a uma mensagem de evento.
sensitivity String Os valores possíveis são: normal, personal, private, confidential.
seriesMasterId Cadeia de caracteres A ID do item mestre da série recorrente se este evento for parte de uma série recorrente.
showAs String O status a ser exibido. Os possíveis valores são: free, tentative, busy, oof, workingElsewhere, unknown.
iniciar DateTimeTimeZone A data, a hora e o fuso horário do evento. Por padrão, a hora de início é em UTC.
assunto String O texto da linha de assunto do evento.
transactionId Cadeia de caracteres Um identificador personalizado especificado por um aplicativo cliente para o servidor para evitar operações POST redundantes caso o cliente tente criar o mesmo evento. Isso é útil quando a conectividade de rede baixa faz com que o cliente expire antes de receber uma resposta do servidor para a solicitação anterior de criação de evento do cliente. Depois de definir transactionId ao criar um evento, não será possível alterar a transactionId em uma atualização subsequente. Essa propriedade só será retornada em um conteúdo de resposta se um aplicativo a tiver definido. Opcional.
type String O tipo de evento. Os valores possíveis são: singleInstance, occurrence, exception, seriesMaster. Somente leitura
webLink String A URL para abrir o evento no Outlook na Web.

O Outlook na Web abre o evento no navegador se você estiver conectado à sua caixa de correio. Caso contrário, o Outlook na Web solicitará que você entre.

Este URL não pode ser acessado a partir de um iFrame.

Observação

A propriedadewebLink especifica uma URL que abre o evento apenas em versões anteriores do Outlook na Web. Este é o formato da URL, com {event-id} sendo o valor codificado na URL da propriedadeid:

  • Para contas corporativas ou de estudante: https://outlook.office365.com/owa/?itemid={event-id}&exvsurl=1&path=/calendar/item

  • Para contas da Microsoft: https://outlook.live.com/owa/?itemid={event-id}&exvsurl=1&path=/calendar/item

Para abrir o evento em uma versão atual do Outlook na Web, converta a URL em um dos seguintes formatos e use essa URL para abrir o evento:

  • Para contas corporativas ou de estudante: https://outlook.office365.com/calendar/item/{event-id}

  • Para contas da Microsoft: https://outlook.live.com/calendar/item/{event-id}

Relações

Relação Tipo Descrição
attachments Attachment collection A coleção de anexos FileAttachment, ItemAttachment e referenceAttachment do evento. Propriedade de navegação. Somente leitura. Anulável.
calendar Calendar O calendário que contém o evento. Propriedade de navegação. Somente leitura.
extensions Coleção Extension A coleção de extensões abertas definidas para o evento. Anulável.
instances Event collection São as ocorrências de uma série recorrente, se o evento for um mestre de série. Esta propriedade inclui ocorrências que fazem parte do padrão de recorrência e de exceções que foram modificadas, mas não inclui ocorrências da série que foram canceladas. Propriedade de navegação. Somente leitura. Anulável.
multiValueExtendedProperties Coleção multiValueLegacyExtendedProperty A coleção de propriedades estendidas de vários valores definidas para o evento. Somente leitura. Anulável.
singleValueExtendedProperties Coleção singleValueLegacyExtendedProperty A coleção de propriedades estendidas de valor único definidas para o evento. Somente leitura. Anulável.

Representação JSON

A representação JSON seguinte mostra o tipo de recurso.

{
  "allowNewTimeProposals": "Boolean",
  "attendees": [{"@odata.type": "microsoft.graph.attendee"}],
  "body": {"@odata.type": "microsoft.graph.itemBody"},
  "bodyPreview": "string",
  "categories": ["string"],
  "changeKey": "string",
  "createdDateTime": "String (timestamp)",
  "end": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "hasAttachments": true,
  "hideAttendees": false,
  "id": "string (identifier)",
  "importance": "String",
  "isAllDay": true,
  "isCancelled": true,
  "isDraft": false,
  "isOnlineMeeting": true,
  "isOrganizer": true,
  "isReminderOn": true,
  "lastModifiedDateTime": "String (timestamp)",
  "location": {"@odata.type": "microsoft.graph.location"},
  "locations": [{"@odata.type": "microsoft.graph.location"}],
  "onlineMeeting": {"@odata.type": "microsoft.graph.onlineMeetingInfo"},
  "onlineMeetingProvider": "string",
  "onlineMeetingUrl": "string",
  "organizer": {"@odata.type": "microsoft.graph.recipient"},
  "originalEndTimeZone": "string",
  "originalStart": "String (timestamp)",
  "originalStartTimeZone": "string",
  "recurrence": {"@odata.type": "microsoft.graph.patternedRecurrence"},
  "reminderMinutesBeforeStart": 1024,
  "responseRequested": true,
  "responseStatus": {"@odata.type": "microsoft.graph.responseStatus"},
  "sensitivity": "String",
  "seriesMasterId": "string",
  "showAs": "String",
  "start": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "subject": "string",
  "type": "String",
  "webLink": "string",

  "attachments": [ { "@odata.type": "microsoft.graph.attachment" } ],
  "calendar": { "@odata.type": "microsoft.graph.calendar" },
  "extensions": [ { "@odata.type": "microsoft.graph.extension" } ],
  "instances": [ { "@odata.type": "microsoft.graph.event" }],
  "singleValueExtendedProperties": [ { "@odata.type": "microsoft.graph.singleValueLegacyExtendedProperty" }],
  "multiValueExtendedProperties": [ { "@odata.type": "microsoft.graph.multiValueLegacyExtendedProperty" }]
}

Conteúdo relacionado