Compartilhar via

bookingStaffMember tipo de recurso

  • Artigo

Namespace: microsoft.graph

Representa um membro da equipa que presta serviços num bookingBusiness.

Os docentes podem fazer parte do inquilino do Microsoft 365 onde a empresa de reservas está configurada ou podem utilizar serviços de e-mail de outros fornecedores de e-mail.

Ao marcar compromissos, a API do Bookings considera as seguintes definições para determinar a disponibilidade de um membro da equipa:

  1. Por predefinição, as horas de funcionamento da empresa (a propriedade businessHours da entidade bookingBusiness ) representam a disponibilidade geral do membro do pessoal.
  2. Se useBusinessHours for falso, o horário de trabalho específico do docente (propriedade workingHours da entidade bookingStaffmember ) representa a disponibilidade geral desse membro.
  3. Se availabilityIsAffectedByPersonalCalendar for verdadeiro, a API do Bookings analisará primeiro as horas disponíveis geralmente do docente (conforme determinado pelo n.º 1 ou n.º 2) e verificará a disponibilidade durante essas horas no calendário pessoal do docente, antes de fazer uma reserva.

Herda de bookingStaffMemberBase.

O Microsoft Bookings suporta um máximo de 100 funcionários num calendário de reservas.

Métodos

Método Tipo de retorno Descrição
List coleção bookingStaffMember Obtenha uma lista de objetos bookingStaffMember no bookingBusiness especificado.
Create coleção bookingStaffMember Crie um novo bookingStaffMember no bookingBusiness especificado.
Get bookingStaffMember Obtenha as propriedades e relações de um bookingStaffMember no bookingBusiness especificado.
Atualizar Nenhum(a) Atualize as propriedades de um bookingStaffMember no bookingBusiness especificado.
Delete Nenhum Elimine um membro da equipa no bookingBusiness especificado.

Propriedades

Propriedade Tipo Descrição
availabilityIsAffectedByPersonalCalendar Booliano Verdadeiro significa que, se o membro da equipa for um utilizador do Microsoft 365, a API do Bookings verificará a disponibilidade do docente no seu calendário pessoal no Microsoft 365, antes de efetuar uma reserva.
createdDateTime DateTimeOffset A data, hora e fuso horário em que o docente foi criado. O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.
displayName Cadeia de caracteres O nome do docente, conforme apresentado aos clientes. Obrigatório.
emailAddress Cadeia de caracteres O endereço de e-mail do docente. Este endereço de e-mail pode estar no mesmo inquilino do Microsoft 365 que a empresa ou num domínio de e-mail diferente. Este endereço de e-mail pode ser utilizado se a propriedade sendConfirmationsToOwner estiver definida como true na política de agendamento da empresa. Obrigatório.
id Cadeia de caracteres O ID do docente, num formato GUID. Somente leitura.
isEmailNotificationEnabled Booliano Indica que um funcionário é notificado por e-mail quando uma reserva atribuída é criada ou alterada. O valor padrão é true.
membershipStatus bookingStaffMembershipStatus O estatuto de membro da associação do docente da empresa. Os valores possíveis são: active, pendingAcceptance, rejectedByStaff, unknownFutureValue.
lastUpdatedDateTime DateTimeOffset A data, hora e fuso horário em que o docente foi atualizado pela última vez. O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC em 1 de janeiro de 2014 é 2014-01-01T00:00:00Z.
role bookingStaffRole O papel do docente na empresa. Os valores possíveis são: guest, administrator, viewer, externalGuest, unknownFutureValue, scheduler, teamMember. Tem de utilizar o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores desta enumeração evoluível: scheduler, teamMember. Obrigatório.
timeZone Cadeia de caracteres O fuso horário do docente. Para obter uma lista de valores possíveis, veja dateTimeTimeZone.
useBusinessHours Booliano Verdadeiro significa que a disponibilidade do docente é conforme especificado na propriedade businessHours da empresa. Falso significa que a disponibilidade é determinada pela definição da propriedade workingHours do docente.
workingHours coleção bookingWorkHours O intervalo de horas por dia da semana em que o docente está disponível para reserva. Por predefinição, são inicializados para serem os mesmos que a propriedade businessHours da empresa.

Relações

Nenhum

Representação JSON

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

{
  "@odata.type": "#microsoft.graph.bookingStaffMember",
  "availabilityIsAffectedByPersonalCalendar": "Boolean",
  "createdDateTime": "String (timestamp)",
  "displayName": "String",
  "emailAddress": "String",
  "id": "String (identifier)",
  "isEmailNotificationEnabled": "Boolean",
  "lastUpdatedDateTime": "String (timestamp)",
  "role": "String",
  "timeZone": "String",
  "useBusinessHours": "Boolean",
  "workingHours": [{"@odata.type": "microsoft.graph.bookingWorkHours"}]
}