tipo de recurso bookingStaffMember

Namespace: microsoft.graph

Representa um membro da equipe que presta serviços em um bookingBusiness.

Os membros da equipe podem fazer parte do locatário do Microsoft 365 onde o negócio de reservas está configurado ou podem usar serviços de email de outros provedores de email.

Ao agendar compromissos, a API Bookings considera as seguintes configurações para determinar a disponibilidade de um membro da equipe:

  1. Por padrão, o horário de funcionamento da empresa (a propriedade businessHours da entidade bookingBusiness ) representa a disponibilidade geral do membro da equipe.
  2. Se useBusinessHours for false, as horas de trabalho específicas do membro da equipe (propriedade workingHours da entidade bookingStaffmember ) representarão a disponibilidade geral desse membro.
  3. Se availabilityIsAffectedByPersonalCalendar for true, a API Bookings primeiro examinará o horário geralmente disponível do membro da equipe (conforme determinado por #1 ou #2) e verificará a disponibilidade durante esse horário no calendário pessoal do membro da equipe, antes de fazer uma reserva.

Herda de bookingStaffMemberBase.

O Microsoft Bookings suporta um máximo de 100 membros da equipe em um 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 os relacionamentos de um bookingStaffMember no bookingBusiness especificado.
Atualizar Nenhum(a) Atualize as propriedades de um bookingStaffMember no bookingBusiness especificado.
Delete Nenhum Exclua um membro da equipe no bookingBusiness especificado.

Propriedades

Propriedade Tipo Descrição
availabilityIsAffectedByPersonalCalendar Booliano Verdadeiro significa que, se o membro da equipe for um usuário do Microsoft 365, a API de reservas verificará a disponibilidade do membro da equipe em seu calendário pessoal no Microsoft 365, antes de fazer uma reserva.
createdDateTime DateTimeOffset A data, a hora e o fuso horário em que o membro da equipe foi criado. O tipo de carimbo de data/hora representa informações de data e hora usando 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 membro da equipe, conforme exibido aos clientes. Obrigatório.
emailAddress Cadeia de caracteres O endereço de email do membro da equipe. Esse endereço de email pode estar no mesmo locatário do Microsoft 365 que a empresa ou em um domínio de email diferente. Esse endereço de email poderá ser usado se a propriedade sendConfirmationsToOwner estiver definida como true na política de agendamento da empresa. Obrigatório.
id Cadeia de caracteres A ID do membro da equipe, em um formato GUID. Somente leitura.
isEmailNotificationEnabled Booliano Indica que um membro da equipe é notificado por email quando uma reserva atribuída a ele é criada ou alterada. O valor padrão é true.
membershipStatus bookingStaffMembershipStatus O status de associação do membro da equipe na empresa. Os valores possíveis são: active, pendingAcceptance, rejectedByStaff, unknownFutureValue.
lastUpdatedDateTime DateTimeOffset A data, a hora e o fuso horário em que o membro da equipe foi atualizado pela última vez. O tipo de carimbo de data/hora representa informações de data e hora usando 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 A função do membro da equipe no negócio. Os valores possíveis são guest, administrator, viewer, externalGuest, unknownFutureValue, scheduler, teamMember. Você deve usar o Prefer: include-unknown-enum-members cabeçalho da solicitação para obter os seguintes valores dessa enumeração evolutiva: scheduler, teamMember. Obrigatório.
timeZone Cadeia de caracteres O fuso horário do membro da equipe. Para obter uma lista de valores possíveis, consulte dateTimeTimeZone.
useBusinessHours Booliano Verdadeiro significa que a disponibilidade do membro da equipe é conforme especificado na propriedade businessHours da empresa. Falso significa que a disponibilidade é determinada pela configuração da propriedade workingHours do membro da equipe.
workingHours Coleção bookingWorkHours O intervalo de horas a cada dia da semana em que o membro da equipe está disponível para reserva. Por padrão, eles são inicializados para serem iguais à propriedade businessHours da empresa.

Relações

Nenhum

Representação JSON

A representação JSON a seguir 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"}]
}