tipo de recurso bookingStaffMember
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:
- 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.
- 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.
- 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)"
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de