tipo de recurso bookingStaffMember

  • Artigo

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 equipe que fornece serviços em um bookingBusiness.

Os funcionários 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 reservar compromissos, a API Bookings considera as seguintes configurações para determinar a disponibilidade de um membro da equipe:

  1. Por padrão, as horas de operação do negócio (a propriedade businessHours da entidade bookingBusiness ) representam a disponibilidade geral do membro da equipe.
  2. Se useBusinessHours for falso, as horas de trabalho específicas do membro da equipe (propriedade workingHours da entidade bookingStaffmember) representarão a disponibilidade geral desse membro.
  3. Se a disponibilidadeIsAffectedByPersonalCalendar for verdadeira, a API Bookings examinará primeiro as horas geralmente disponíveis do membro da equipe (conforme determinado por #1 ou #2) e verificará a disponibilidade durante essas horas no calendário pessoal do membro da equipe, antes de fazer uma reserva.

Microsoft Bookings dá suporte a no máximo 100 funcionários em um calendário de reservas.

Métodos

Método Tipo de retorno Descrição
Listar membros da equipe coleção bookingStaffMember Obtenha uma lista de objetos bookingStaffMember no bookingBusiness especificado.
Criar bookingStaff coleção bookingStaffMember Crie um novo bookingStaffMember no bookingBusiness especificado.
Obter bookingStaffMember bookingStaffMember Obtenha as propriedades e as relações 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 True significa que, se o membro da equipe for um usuário do Microsoft 365, a API Bookings verificará a disponibilidade do membro da equipe em seu calendário pessoal no Microsoft 365, antes de fazer uma reserva.
colorIndex Int32 Identifica uma cor para representar o membro da equipe. A cor corresponde à paleta de cores na página detalhes do Staff no aplicativo Bookings.
createdDateTime DateTimeOffset A data, hora e fuso horário quando o membro da equipe foi criado.
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 for definida como true na política de agendamento do negócio. Obrigatório.
id Cadeia de caracteres A ID do membro da equipe, em um formato GUID. Somente leitura.
isEmailNotificationEnabled Booliano Indica que os membros da equipe são notificados por email quando uma reserva atribuída a eles é criada ou alterada. O valor padrão é true
lastUpdatedDateTime DateTimeOffset A data, hora e fuso horário quando o membro da equipe foi atualizado pela última vez.
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 cabeçalho de Prefer: include-unknown-enum-members solicitação para obter os seguintes valores deste enumerável em evolução: 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 True significa que a disponibilidade do membro da equipe é conforme especificado na propriedade businessHours do negócio. False 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 que o membro da equipe está disponível para reserva. Por padrão, eles são inicializados para serem os mesmos que a propriedade businessHours do negócio.

Relações

Nenhum

Representação JSON

O JSON a seguir é 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)"
}