bookingStaffMember tipo de recurso

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.
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. Isto 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	True indica que um funcionário será notificado por e-mail quando for criada ou alterada uma reserva atribuída.
membershipStatus	bookingStaffMembershipStatus	O estatuto de membro da associação do docente da empresa. Os valores possíveis são: active, pendingAcceptance, rejectedByStaff, unknownFutureValue.
role	bookingStaffRole	O papel do docente na empresa. Os valores possíveis são: guest, administrator, viewer, externalGuest, unknownFutureValue, scheduler, teamMember. Tenha em atenção que tem de utilizar o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores desta enumeração em evolução: 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

Veja a seguir uma representação JSON do recurso.

{
  "availabilityIsAffectedByPersonalCalendar": "Boolean",
  "displayName": "String",
  "emailAddress": "String",
  "id": "String (identifier)",
  "isEmailNotificationEnabled": "Boolean",
  "membershipStatus": {"@odata.type": "microsoft.graph.bookingStaffMembershipStatus"},
  "role": {"@odata.type": "microsoft.graph.bookingStaffRole"},
  "timeZone": "String",
  "useBusinessHours": "Boolean",
  "workingHours": [{"@odata.type": "microsoft.graph.bookingWorkHours"}]
}