tipo de recurso calendarcalendar resource type

Namespace: microsoft.graphNamespace: microsoft.graph

Representa um contêiner para recursos de evento.Represents a container for event resources. Pode ser um calendário para um usuárioou o calendário padrão de um grupo do Microsoft 365.It can be a calendar for a user, or the default calendar of a Microsoft 365 group.

Observação: existem algumas pequenas diferenças na maneira como você pode interagir com calendários de usuários e calendários de grupos:Note: There are a few minor differences in the way you can interact with user calendars and group calendars:

  • Você pode organizar apenas os calendários de usuários em calendarGroup.You can organize only user calendars in a calendarGroup.
  • O Outlook aceita automaticamente todas as solicitações de reunião em nome de grupos.Outlook automatically accepts all meeting requests on behalf of groups. Você pode aceitar, aceitar provisoriamente ou recusar solicitações de reuniões apenas para calendários do usuário.You can accept, tentatively accept, or decline meeting requests for user calendars only.
  • O Outlook não oferece suporte a lembretes de eventos do grupo.Outlook doesn't support reminders for group events. Você pode adiar ou descartar um lembrete apenas para calendários do usuário.You can snooze or dismiss a reminder for user calendars only.

MétodosMethods

MétodoMethod Tipo de retornoReturn Type DescriçãoDescription
Listar calendáriosList calendars Coleção calendarcalendar collection 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.Get all the user's calendars, or the calendars in the default or other specific calendar group.
Criar calendárioCreate calendar calendarcalendar Crie um novo calendário no grupo de calendário padrão ou no grupo de calendários especificado para um usuário.Create a new calendar in the default calendar group or specified calendar group for a user.
Obter calendárioGet calendar calendarcalendar Obtenha as propriedades e as relações de um objeto calendar.Get the properties and relationships of a calendar object. O calendário pode ser um para um usuário ou o calendário padrão de um grupo do Microsoft 365.The calendar can be one for a user, or the default calendar of a Microsoft 365 group.
UpdateUpdate calendarcalendar Atualize as propriedades de um objeto calendar.Update the properties of a calendar object. O calendário pode ser um para um usuário ou o calendário padrão de um grupo do Microsoft 365.The calendar can be one for a user, or the default calendar of a Microsoft 365 group.
DeleteDelete NenhumNone Exclua um objeto calendar.Delete calendar object.
Listar calendarViewList calendarView Coleção eventevent collection 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.Get the occurrences, exceptions, and single instances of events in a calendar view defined by a time range, from the user's primary calendar (../me/calendarview) or from a specified calendar.
Listar eventosList events Coleção eventevent collection Recupera uma lista de eventos em um calendário. A lista contém reuniões de instância única e reuniões mestres da série.Retrieve a list of events in a calendar. The list contains single instance meetings and series masters.
Criar eventoCreate event eventevent Crie um novo evento no calendário especificado ou padrão.Create a new event in the default or specified calendar.
getSchedulegetSchedule Coleção scheduleInformationscheduleInformation collection Obtenha as informações de disponibilidade para um conjunto de usuários, listas de distribuição ou recursos para um período especificado.Get the free/busy availability information for a collection of users, distributions lists, or resources, for a specified time period.
findMeetingTimesfindMeetingTimes meetingTimeSuggestionsResultmeetingTimeSuggestionsResult 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.Suggest meeting times and locations based on organizer and attendee availability, and time or location constraints.
Criar uma propriedade estendida de valor únicoCreate single-value extended property calendarcalendar Criar uma ou mais propriedades estendidas de valor único em um calendário novo ou existente.Create one or more single-value extended properties in a new or existing calendar.
Obter calendário com propriedade estendida de valor únicoGet calendar with single-value extended property calendarcalendar Obter calendários que contenham uma propriedade estendida de valor único usando $expand ou $filter.Get calendars that contain a single-value extended property by using $expand or $filter.
Criar propriedade estendida de vários valoresCreate multi-value extended property calendarcalendar Criar uma ou mais propriedades estendidas de vários valores em um calendário novo ou existente.Create one or more multi-value extended properties in a new or existing calendar.
Obter calendário com propriedade estendida de vários valoresGet calendar with multi-value extended property calendarcalendar Obter um calendário que contenha uma propriedade estendida de vários valores usando $expand.Get a calendar that contains a multi-value extended property by using $expand.

PropriedadesProperties

PropriedadeProperty TipoType DescriçãoDescription
allowedOnlineMeetingProvidersallowedOnlineMeetingProviders onlineMeetingProviderType collectiononlineMeetingProviderType collection Represente os provedores de serviços de reunião online que podem ser usados para criar reuniões online neste calendário.Represent the online meeting service providers that can be used to create online meetings in this calendar. Os valores possíveis são: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.Possible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
canEditcanEdit BoolianoBoolean true se o usuário pode escrever no calendário, false caso contrário.true if the user can write to the calendar, false otherwise. Esta propriedade é true para o usuário que criou o calendário.This property is true for the user who created the calendar. Esta propriedade também é true para um usuário que compartilhou uma agenda e recebeu acesso de gravação.This property is also true for a user who has been shared a calendar and granted write access.
canSharecanShare BooleanBoolean true se o usuário tiver permissão para compartilhar a agenda, false caso contrário.true if the user has the permission to share the calendar, false otherwise. Apenas o usuário que criou o calendário pode compartilhá-lo.Only the user who created the calendar can share it.
canViewPrivateItemscanViewPrivateItems BooleanBoolean true se o usuário pode ler itens de calendário que foram marcados como privados, false caso contrário.true if the user can read calendar items that have been marked private, false otherwise.
changeKeychangeKey StringString Identifica a versão do objeto calendar. Toda vez que o calendário é alterado, a changeKey também muda. Isso permite que o Exchange aplique as alterações na versão correta do objeto. Somente leitura.Identifies the version of the calendar object. Every time the calendar is changed, changeKey changes as well. This allows Exchange to apply changes to the correct version of the object. Read-only.
colorcolor calendarColorcalendarColor Especifica o tema de cores para distinguir o calendário de outros calendários em uma interface do usuário.Specifies the color theme to distinguish the calendar from other calendars in a UI. Os valores das propriedades são: auto, lightBlue, lightGreen, lightOrange, lightGray, lightYellow, lightTeal, lightPink, lightBrown, lightRed, maxColorThe property values are: auto, lightBlue, lightGreen, lightOrange, lightGray, lightYellow, lightTeal, lightPink, lightBrown, lightRed, maxColor.
defaultOnlineMeetingProviderdefaultOnlineMeetingProvider onlineMeetingProviderTypeonlineMeetingProviderType O provedor de reunião online padrão para reuniões enviadas deste calendário.The default online meeting provider for meetings sent from this calendar. Os valores possíveis são: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.Possible values are: unknown, skypeForBusiness, skypeForConsumer, teamsForBusiness.
hexColorhexColor StringString 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.The calendar color, expressed in a hex color code of three hexadecimal values, each ranging from 00 to FF and representing the red, green, or blue components of the color in the RGB color space. Se o usuário nunca tiver definido explicitamente uma cor para o calendário, esta propriedade estará vazia.If the user has never explicitly set a color for the calendar, this property is empty. Somente leitura.Read-only.
idid StringString O identificador exclusivo do calendário. Somente leitura.The calendar's unique identifier. Read-only.
isDefaultCalendarisDefaultCalendar BoolianoBoolean true se este for o calendário padrão onde novos eventos são criados por padrão, false caso contrário.true if this is the default calendar where new events are created by default, false otherwise.
isRemovableisRemovable BoolianoBoolean Indica se o calendário deste usuário pode ser excluído da caixa de correio do usuário.Indicates whether this user calendar can be deleted from the user mailbox.
isTallyingResponsesisTallyingResponses BoolianoBoolean Indica se o calendário deste usuário dá suporte ao acompanhamento de respostas de reunião.Indicates whether this user calendar supports tracking of meeting responses. Somente os convites para reuniões enviados do calendário principal do usuário oferecem suporte para respostas de reunião.Only meeting invites sent from users' primary calendars support tracking of meeting responses.
nomename StringString O nome do calendário.The calendar name.
ownerowner emailAddressemailAddress 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.If set, this represents the user who created or added the calendar. For a calendar that the user created or added, the owner property is set to the user. For a calendar shared with the user, the owner property is set to the person who shared that calendar with the user.

RelaçõesRelationships

RelaçãoRelationship TipoType DescriçãoDescription
calendarPermissionscalendarPermissions Coleção de calendarPermissioncalendarPermission collection As permissões dos usuários com os quais o calendário é compartilhado.The permissions of the users with whom the calendar is shared.
calendarViewcalendarView Coleção EventEvent collection O modo de exibição do calendário. Propriedade de navegação. Somente leitura.The calendar view for the calendar. Navigation property. Read-only.
eventsevents Coleção EventEvent collection Os eventos do calendário. Propriedade de navegação. Somente leitura.The events in the calendar. Navigation property. Read-only.
multiValueExtendedPropertiesmultiValueExtendedProperties Coleção multiValueLegacyExtendedPropertymultiValueLegacyExtendedProperty collection A coleção de propriedades estendidas de vários valores definidas para o calendário. Somente leitura. Anulável.The collection of multi-value extended properties defined for the calendar. Read-only. Nullable.
singleValueExtendedPropertiessingleValueExtendedProperties Coleção singleValueLegacyExtendedPropertysingleValueLegacyExtendedProperty collection A coleção de propriedades estendidas de vários valores definidas para a mensagem. Somente leitura. Anulável.The collection of single-value extended properties defined for the calendar. Read-only. Nullable.

Representação JSONJSON representation

Veja a seguir uma representação JSON do recursoHere is a JSON representation of the resource

{
  "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"}
}