Atualizar bookingstaffmemberUpdate bookingstaffmember

Namespace: microsoft.graphNamespace: microsoft.graph

Importante

As APIs na /beta versão do Microsoft Graph estão sujeitas a alterações.APIs under the /beta version in Microsoft Graph are subject to change. Não há suporte para o uso dessas APIs em aplicativos de produção.Use of these APIs in production applications is not supported.

Atualiza as propriedades de um bookingStaffMember no bookingbusinessespecificado.Update the properties of a bookingStaffMember in the specified bookingbusiness.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) Bookings. ReadWrite. All, bookings. Manage. AllBookings.ReadWrite.All, Bookings.Manage.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication Sem suporte.Not supported.

Solicitação HTTPHTTP request

PATCH /bookingBusinesses/{id}/staffMembers/{id}

Cabeçalhos de solicitação opcionaisOptional request headers

NomeName DescriçãoDescription
AuthorizationAuthorization Portador {código}Bearer {code}

Corpo da solicitaçãoRequest body

No corpo da solicitação, forneça os valores para os campos relevantes que devem ser atualizados. Propriedades existentes que não estão incluídas no corpo da solicitação terão seus valores anteriores mantidos ou serão recalculadas com base nas alterações a outros valores de propriedade. Para obter melhor desempenho, não inclua valores existentes que não foram alterados.In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.

PropriedadeProperty TipoType DescriçãoDescription
availabilityIsAffectedByPersonalCalendaravailabilityIsAffectedByPersonalCalendar BooleanBoolean True significa que, se o membro da equipe for um usuário do Microsoft 365, a API Books usa o calendário pessoal do membro da equipe no Microsoft 365, bem como a propriedade workingHours para determinar a disponibilidade.True means that if the staff member is a Microsoft 365 user, the Bookings API uses the staff member's personal calendar in Microsoft 365 as well as the workingHours property to determine availability.
colorIndexcolorIndex Int32Int32 Identifica uma cor para representar o membro da equipe.Identifies a color to represent the staff member. A cor corresponde à paleta de cores na página de detalhes da equipe no aplicativo de reservas.The color corresponds to the color palette in the Staff details page in the Bookings app.
displayNamedisplayName StringString O nome do membro da equipe, conforme exibido para os clientes.The name of the staff member, as displayed to customers.
emailAddressemailAddress StringString O endereço de email do membro da equipe.The email address of the staff member. Isso pode ser no mesmo locatário do Microsoft 365 que a empresa ou em um domínio de email diferente.This can be in the same Microsoft 365 tenant as the business, or in a different email domain. Esse endereço de email será usado se a propriedade sendConfirmationsToOwner estiver definida como true na política de agendamento da empresa.This email address is used if the sendConfirmationsToOwner property is set to true in the scheduling policy of the business.
rolerole stringstring A função do membro da equipe na empresa.The role of the staff member in the business. Os valores possíveis são: guest, administrator, viewer, externalGuest.Possible values are: guest, administrator, viewer, externalGuest.
useBusinessHoursuseBusinessHours BooleanBoolean True significa que a disponibilidade do membro da equipe é determinada pela propriedade businessHours da empresa.True means the staff member's availability is determined by the businessHours property of the business. False significa que a disponibilidade é determinada pela configuração da propriedade workingHouse do membro da equipe.False means the availability is determined by the staff member's workingHouse property setting.
workingHoursworkingHours coleção bookingWorkHoursbookingWorkHours collection O intervalo de horas por dia da semana em que o membro da equipe está disponível para reserva.The range of hours each day of the week that the staff member is available for booking.

RespostaResponse

Se bem-sucedido, este método retorna um código de resposta 204 No content. Não retorna nada no corpo da resposta.If successful, this method returns a 204 No content response code. It does not return anything in the response body.

ExemploExample

SolicitaçãoRequest

O exemplo a seguir altera a agenda do membro da equipe para que ela tenha opções de segunda-feira.The following example changes the staff member's schedule to have Mondays off.

PATCH https://graph.microsoft.com/beta/bookingBusinesses/Contosolunchdelivery@M365B489948.onmicrosoft.com/staffmembers/8ee1c803-a1fa-406d-8259-7ab53233f148
Content-type: application/json

{
    "workingHours":[
        {
            "@odata.type":"#microsoft.graph.bookingWorkHours",
            "day@odata.type":"#microsoft.graph.dayOfWeek",
            "day":"monday",
            "timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
            "timeSlots":[

            ]
        },
        {
            "@odata.type":"#microsoft.graph.bookingWorkHours",
            "day@odata.type":"#microsoft.graph.dayOfWeek",
            "day":"tuesday",
            "timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
            "timeSlots":[
                {
                    "@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
                    "end":"17:00:00.0000000",
                    "start":"08:00:00.0000000"
                }
            ]
        },
        {
            "@odata.type":"#microsoft.graph.bookingWorkHours",
            "day@odata.type":"#microsoft.graph.dayOfWeek",
            "day":"wednesday",
            "timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
            "timeSlots":[
                {
                    "@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
                    "end":"17:00:00.0000000",
                    "start":"08:00:00.0000000"
                }
            ]
        },
        {
            "@odata.type":"#microsoft.graph.bookingWorkHours",
            "day@odata.type":"#microsoft.graph.dayOfWeek",
            "day":"thursday",
            "timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
            "timeSlots":[
                {
                    "@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
                    "end":"17:00:00.0000000",
                    "start":"08:00:00.0000000"
                }
            ]
        },
        {
            "@odata.type":"#microsoft.graph.bookingWorkHours",
            "day@odata.type":"#microsoft.graph.dayOfWeek",
            "day":"friday",
            "timeSlots@odata.type":"#Collection(microsoft.graph.bookingWorkTimeSlot)",
            "timeSlots":[
                {
                    "@odata.type":"#microsoft.graph.bookingWorkTimeSlot",
                    "end":"17:00:00.0000000",
                    "start":"08:00:00.0000000"
                }
            ]
        }
    ]
}
RespostaResponse

Este é um exemplo de resposta.The following is an example of the response.

HTTP/1.1 204 No Content