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 remove-o na pasta Itens recuperáveis na caixa de correio do utilizador.
Obter delta Coleção event Obter um conjunto de eventos 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 Envie uma mensagem de cancelamento do organizador a todos os participantes e cancele a reunião especificada.
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.
participantes 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. 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 for verdadeiro, independentemente de ser um evento de um dia ou de vários dias, o início e a hora de fim têm de estar definidos 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. Posteriormente, 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). Também se aplica se um delegado 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 atualizar a propriedade de localização , quaisquer localizações anteriores na coleção de localizações serão removidas e substituídas pelo novo valor de localização .
onlineMeeting OnlineMeetingInfo Detalhes para o participante entrar na reunião online. A predefinição é nula. 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. 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, e 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. É útil quando a baixa conectividade de rede faz com que o cliente exceda o tempo limite antes de receber uma resposta do servidor para o pedido de criação-evento anterior 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
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.

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 modificadas, mas não inclui ocorrências 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",
  "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