bookingStaffMember tipo de recurso

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.

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 reservar compromissos, a API de Bookings considera as seguintes definições para determinar a disponibilidade de um funcionário:

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 de Bookings analisará primeiro as horas disponíveis geralmente do membro do pessoal (conforme determinado pelo n.º 1 ou n.º 2) e verificará a disponibilidade durante essas horas no calendário pessoal do docente, antes de efetuar uma reserva.

Microsoft Bookings suporta um máximo de 100 docentes 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	Create 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 de Bookings verificará a disponibilidade do docente no seu calendário pessoal no Microsoft 365, antes de efetuar uma reserva.
colorIndex	Int32	Identifica uma cor para representar o docente. A cor corresponde à paleta de cores na página Detalhes da equipa na aplicação Bookings.
createdDateTime	DateTimeOffset	A data, hora e fuso horário em que o docente foi criado.
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 os docentes são notificados por e-mail quando uma reserva atribuída é criada ou alterada. O valor predefinido é true
lastUpdatedDateTime	DateTimeOffset	A data, hora e fuso horário em que o docente foi atualizado pela última vez.
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

O seguinte JSON é uma representação do recurso.

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