Actualizar bookingservice

Artículo
10/28/2023

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

Actualice las propiedades de un objeto bookingService en el objeto bookingBusiness especificado.

A continuación se muestran algunos ejemplos que puede personalizar para un servicio:

Precio
Longitud típica de una cita
Reminders
Cualquier búfer de tiempo para configurar antes o finalizar después del servicio
Programar parámetros de directiva, como el aviso mínimo para reservar o cancelar, y si los clientes pueden seleccionar miembros del personal específicos para una cita.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global	Gobierno de EE. UU. L4	Us Government L5 (DOD)	China operada por 21Vianet
✅	✅	✅	❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso	Permisos con privilegios mínimos	Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)	Bookings.ReadWrite.All	Bookings.Manage.All
Delegado (cuenta personal de Microsoft)	No admitida.	No admitida.
Aplicación	Bookings.ReadWrite.All	Bookings.Manage.All

Solicitud HTTP

PATCH /solutions/bookingbusinesses/{id}/services/{id}

Encabezados de solicitud opcionales

Nombre	Descripción
Autorización	{code} del portador. Necesario.

Cuerpo de solicitud

En el cuerpo de la solicitud, proporcione los valores de los campos relevantes que deben actualizarse. Las propiedades existentes que no se incluyen en el cuerpo de la solicitud mantienen sus valores anteriores o se recalculan en función de los cambios realizados en otros valores de propiedad. Para obtener el mejor rendimiento, no incluya valores existentes que no hayan cambiado.

Propiedad	Tipo	Descripción
defaultDuration	Duración	Longitud predeterminada del servicio, representada en números de días, horas, minutos y segundos. Por ejemplo, P11D23H59M59.99999999999999999999S.
defaultLocation	location	Ubicación física predeterminada del servicio.
defaultPrice	Doble	Precio monetario predeterminado para el servicio.
defaultPriceType	bookingPriceType	La forma predeterminada en que se cobra el servicio. Los valores posibles son: `undefined`, `fixedPrice`, `startingAt`, `hourly`, `free`, `priceVaries`, `callUs`, `notSet` y `unknownFutureValue`.
defaultReminders	bookingReminder collection	Conjunto predeterminado de recordatorios para una cita de este servicio. El valor de esta propiedad solo está disponible al leer este bookingService por su identificador.
description	Cadena	Una descripción de texto para el servicio.
displayName	Cadena	Un nombre de servicio.
id	Cadena	Solo lectura.
isAnonymousJoinEnabled	Booleano	`True` si se genera la dirección URL para unirse a la cita de forma anónima (anonymousJoinWebUrl) para la cita reservada para este servicio.
isCustomerAllowedToManageBooking	Booleano	Indica que el cliente puede administrar las reservas creadas por el personal. El valor predeterminado es `false`.
isHiddenFromCustomers	Booleano	True significa que este servicio no está disponible para los clientes para la reserva.
isLocationOnline	Booleano	True indica que las citas para el servicio se mantienen en línea. El valor predeterminado es `false`.
languageTag	Cadena	Idioma de la página de reserva de autoservicio.
notas	Cadena	Información adicional sobre este servicio.
postBuffer	Duración	El tiempo que se debe almacenar en búfer después de que finalice una cita para este servicio y antes de que se pueda reservar la siguiente cita del cliente.
preBuffer	Duración	El tiempo que se debe almacenar en búfer antes de una cita para este servicio puede iniciarse.
schedulingPolicy	bookingSchedulingPolicy	Conjunto de directivas que determinan cómo se deben crear y administrar las citas para este tipo de servicio.
smsNotificationsEnabled	Booleano	True indica que se pueden enviar notificaciones SMS a los clientes para la cita del servicio. El valor predeterminado es `false`.
staffMemberIds	Colección string	Representa a los miembros del personal que proporcionan este servicio.
customQuestions	colección bookingQuestionAssignment	Contiene el conjunto de preguntas personalizadas asociadas a un servicio determinado. Opcional.
maximumAttendeesCount	Int32	Número máximo de clientes permitido en un servicio.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No content. No devuelve nada en el cuerpo de la respuesta.

Ejemplo

Solicitud

En el ejemplo siguiente se actualiza la duración del servicio especificado.

PATCH https://graph.microsoft.com/beta/solutions/bookingbusinesses/contosolunchdelivery@contoso.com/services/57da6774-a087-4d69-b0e6-6fb82c339976
Content-type: application/json

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


// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new BookingService
{
	OdataType = "#microsoft.graph.bookingService",
	DefaultDuration = TimeSpan.Parse("PT30M"),
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Solutions.BookingBusinesses["{bookingBusiness-id}"].Services["{bookingService-id}"].PatchAsync(requestBody);

Importante

Los SDK de Microsoft Graph usan la versión v1.0 de la API de manera predeterminada y no admiten todos los tipos, propiedades y API disponibles en la versión beta. Para obtener más información sobre cómo acceder a la API beta con el SDK, consulte Uso de los SDK de Microsoft Graph con la API beta.

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc-beta solutions booking-businesses services patch --booking-business-id {bookingBusiness-id} --booking-service-id {bookingService-id} --body '{\
    "@odata.type":"#microsoft.graph.bookingService",\
    "defaultDuration":"PT30M"\
}\
'

Importante

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.



import (
	  "context"
	  abstractions "github.com/microsoft/kiota-abstractions-go"
	  msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-beta-sdk-go/models"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)


requestBody := graphmodels.NewBookingService()
defaultDuration , err := abstractions.ParseISODuration("PT30M")
requestBody.SetDefaultDuration(&defaultDuration) 

services, err := graphClient.Solutions().BookingBusinesses().ByBookingBusinessId("bookingBusiness-id").Services().ByBookingServiceId("bookingService-id").Patch(context.Background(), requestBody, nil)

Importante

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

BookingService bookingService = new BookingService();
bookingService.setOdataType("#microsoft.graph.bookingService");
PeriodAndDuration defaultDuration = PeriodAndDuration.ofDuration(Duration.parse("PT30M"));
bookingService.setDefaultDuration(defaultDuration);
BookingService result = graphClient.solutions().bookingBusinesses().byBookingBusinessId("{bookingBusiness-id}").services().byBookingServiceId("{bookingService-id}").patch(bookingService);

Importante

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.


const options = {
	authProvider,
};

const client = Client.init(options);

const bookingService = {
    '@odata.type':'#microsoft.graph.bookingService',
    defaultDuration: 'PT30M'
};

await client.api('/solutions/bookingbusinesses/contosolunchdelivery@contoso.com/services/57da6774-a087-4d69-b0e6-6fb82c339976')
	.version('beta')
	.update(bookingService);

Importante

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.


<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\BookingService;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);

$requestBody = new BookingService();
$requestBody->setOdataType('#microsoft.graph.bookingService');
$requestBody->setDefaultDuration(new \DateInterval('PT30M'));

$result = $graphServiceClient->solutions()->bookingBusinesses()->byBookingBusinessId('bookingBusiness-id')->services()->byBookingServiceId('bookingService-id')->patch($requestBody)->wait();

Importante

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.


from msgraph import GraphServiceClient
from msgraph.generated.models.booking_service import BookingService

graph_client = GraphServiceClient(credentials, scopes)

request_body = BookingService(
	odata_type = "#microsoft.graph.bookingService",
	default_duration = "PT30M",
)

result = await graph_client.solutions.booking_businesses.by_booking_business_id('bookingBusiness-id').services.by_booking_service_id('bookingService-id').patch(request_body)

Importante

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 204 No Content

Actualizar bookingservice

Permissions

Solicitud HTTP

Encabezados de solicitud opcionales

Cuerpo de solicitud

Respuesta

Ejemplo

Solicitud

Respuesta

Comentarios

Comentarios

Recursos adicionales