Compartilhar via

Atualizar o bookingservice

  • Artigo

Namespace: microsoft.graph

Atualize as propriedades de um objeto bookingService no bookingBusiness especificado.

Seguem-se alguns exemplos que pode personalizar para um serviço:

  • Price
  • Duração típica de um compromisso
  • Lembretes
  • A qualquer momento da memória intermédia para configurar ou concluir após o serviço
  • Parâmetros de política de agendamento , como aviso mínimo para reservar ou cancelar, e se os clientes podem selecionar docentes específicos para um compromisso.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet
✅ ✅ ✅ ❌

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) Bookings.ReadWrite.All Bookings.Manage.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application Bookings.ReadWrite.All Bookings.Manage.All

Solicitação HTTP

PATCH /solutions/bookingBusinesses/{id}/services/{id}

Cabeçalhos de solicitação

Nome Descrição
Autorização Portador {código}. Obrigatório.

Corpo da solicitação

No corpo do pedido, forneça apenas os valores das propriedades a atualizar. As propriedades existentes que não estão incluídas no corpo do pedido mantêm os valores anteriores ou são recalculadas com base em alterações a outros valores de propriedade.

A tabela a seguir especifica as propriedades que podem ser atualizadas.

Propriedade Tipo Descrição
customQuestions coleção bookingQuestionAssignment Isto contém um conjunto de perguntas personalizadas associadas a um determinado serviço. Opcional.
defaultDuration Duração O comprimento predefinido do serviço representado em números de dias, horas, minutos e segundos. Por exemplo, P11D23H59M59.9999999999999S.
defaultLocation location A localização física predefinida do serviço.
defaultPrice Duplo O preço monetário predefinido do serviço.
defaultPriceType bookingPriceType A forma predefinida como o serviço é cobrado. Os valores possíveis são: undefined, fixedPrice, startingAt, hourly, free, priceVaries, callUs, notSet, unknownFutureValue.
defaultReminders coleção bookingReminder O conjunto predefinido de lembretes para um compromisso deste serviço. O valor desta propriedade só está disponível ao ler este bookingService pelo respetivo ID.
description Cadeia de caracteres Uma descrição de texto para o serviço.
displayName Cadeia de caracteres Um nome de serviço.
id Cadeia de caracteres O identificador exclusivo do bookingService. Somente leitura.
isAnonymousJoinEnabled Booliano True se o URL para aderir ao compromisso anonimamente (anonymousJoinWebUrl) for gerado para o compromisso reservado para este serviço.
isCustomerAllowedToManageBooking Booliano Indica que o cliente pode gerir as reservas criadas pela equipa. O valor padrão é false.
isHiddenFromCustomers Booliano True indica que o serviço não está disponível para os clientes para reserva.
isLocationOnline Booliano True indica que os compromissos do serviço são mantidos online. O valor padrão é false.
languageTag Cadeia de caracteres O idioma da página de reservas self-service.
maximumAttendeesCount Int32 O número máximo de clientes permitidos num serviço.
notes String Informações adicionais sobre este serviço.
postBuffer Duração O tempo de colocação em memória intermédia após o fim de um compromisso para este serviço e antes do próximo compromisso do cliente pode ser reservado.
preBuffer Duração O tempo de colocação em memória intermédia antes de um compromisso para este serviço poder ser iniciado.
schedulingPolicy bookingSchedulingPolicy O conjunto de políticas que determinam a forma como os compromissos para este tipo de serviço devem ser criados e geridos.
smsNotificationsEnabled Booliano True indica que as notificações por SMS podem ser enviadas aos clientes para o compromisso do serviço. O valor padrão é false.
staffMemberIds Coleção String Representa os docentes que prestam este serviço.

Resposta

Se tiver êxito, este método retornará um código de resposta 204 No Content. Não devolve nada no corpo da resposta.

Exemplo

Solicitação

O exemplo seguinte atualiza a duração do serviço especificado.

PATCH https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/Contosolunchdelivery@contoso.com/services/57da6774-a087-4d69-b0e6-6fb82c339976
Content-type: application/json

{
    "@odata.type":"#microsoft.graph.bookingService",
    "defaultDuration":"PT30M"
}

Resposta

O exemplo seguinte mostra a resposta.

HTTP/1.1 204 No Content