Partilhar via

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
List 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.
Create event Criar um novo evento postando na coleção de instâncias.
Get event Ler as propriedades e as relações do objeto event.
Atualizar event Atualizar o objeto event.
Excluir Nenhum Excluir o objeto event.
Excluir permanentemente Nenhum Elimine permanentemente um evento e coloque-o na pasta Remoção na pasta Itens Recuperáveis na caixa de correio do utilizador.
Obter delta Coleção event Obtenha um conjunto de eventos que foram adicionados, eliminados ou atualizados num calendárioVer (um intervalo de eventos) do calendário principal do utilizador.
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 Obter uma coleção de objetos de evento.
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.
cancelledOccurrences Coleção de cadeia de caracteres Contém valores de propriedade occurrenceId de instâncias canceladas numa série periódica, se o evento for o mestre da série. As instâncias de uma série periódica que são canceladas são chamadas cancelledOccurences.

Devolvido somente no $select em uma operaçãoGet que especifica a identidade de uma sériede eventos mestre (ou seja, o valor da propriedade seriesMasterId).
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.
exceptionOccurrences Coleção event Contém os valores da propriedade id das instâncias de evento que são exceções em uma série recorrente.
As exceções podem diferir das outras ocorrências em uma série recorrente, tais como o assunto, o início ou fim do horário, ou os participantes. As exceções não incluem ocorrências canceladas.

Devolvido apenas em $select e $expand numa operação GET que especifica o ID de um evento principal de série (ou seja, o valor da propriedade seriesMasterId ).
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 Boolean Defina como verdadeiro se o utilizador tiver atualizado a reunião no Outlook, mas não tiver enviado 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. Em seguida, o Outlook ignora quaisquer alterações adicionais ao isOnlineMeeting e 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.
occurrenceId Cadeia de caracteres Um identificador para uma ocorrência em uma série de eventos recorrentes. Nulo se o evento não fizer parte de uma série periódica.

O formato do valor da propriedade é OID.{seriesMasterId-value}.{occurrence-start-date}. O fuso horário para {occurrence-start-date} é a propriedade recurrenceTimeZone definida para o recurrenceRange correspondente.

Esta propriedade pode identificar qualquer ocorrência numa série periódica, incluindo uma ocorrência que foi modificada ou cancelada. Você pode usar esta propriedade para executar todas as operações suportadas pelas ocorrências na série recorrente.
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. Quando definida, a reunião permanece disponível online e não pode alterar as propriedades isOnlineMeeting, onlineMeetingProvider e onlneMeeting 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. Posteriormente, não pode alterar onlineMeetingProvider novamente e a reunião permanece 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 é criado inicialmente como uma ocorrência ou exceção numa série periódica. Esta propriedade não é devolvida 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 uma aplicação cliente para o servidor para evitar operações POST redundantes se o cliente tentar criar o mesmo evento novamente. 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 pode alterar o transactionId numa 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
uid Cadeia de Caracteres Um identificador exclusivo para eventos de calendário. Para eventos recorrentes, o valor é o mesmo do mestre da série e todas as suas ocorrências, incluindo as exceções.
webLink String A URL para abrir o evento no Outlook na Web.

O Outlook na Web abre o evento no browser se tiver sessão iniciada na sua caixa de correio. Caso contrário, o Outlook na Web solicitará que você entre.

Não é possível aceder a este URL 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 periodicidade e exceções que foram modificadas. Não inclui ocorrências que foram canceladas da série. 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",
  "cancelledOccurrences":["string"],
  "categories": ["string"],
  "changeKey": "string",
  "createdDateTime": "String (timestamp)",
  "end": {"@odata.type": "microsoft.graph.dateTimeTimeZone"},
  "exceptionOccurrences":["microsoft.graph.event"],
  "hasAttachments": true,
  "hideAttendees": false,
  "iCalUId": "String",
  "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"}],
  "occurrenceId":"string",
  "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",
  "uid": "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