Buchungsservice aktualisieren

Artikel
03/21/2024

Namespace: microsoft.graph

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Aktualisieren Sie die Eigenschaften eines bookingService-Objekts im angegebenen bookingBusiness.Update the properties of a bookingService object in the specified bookingBusiness.

Im Folgenden finden Sie einige Beispiele, die Sie für einen Dienst anpassen können:

Kurs
Typische Länge eines Termins
Erinnerungen
Beliebig, Zeitpuffer, der vor oder nach dem Dienst eingerichtet werden soll
Zeitplanungsrichtlinienparameter , z. B. Mindesthinweise zum Buchen oder Stornieren, und ob Kunden bestimmte Mitarbeiter für einen Termin auswählen können.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst	US Government L4	US Government L5 (DOD)	China, betrieben von 21Vianet
✅	✅	✅	❌

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp	Berechtigungen mit den geringsten Berechtigungen	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	Bookings.ReadWrite.All	Bookings.Manage.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt	Nicht unterstützt
Anwendung	Bookings.ReadWrite.All	Bookings.Manage.All

HTTP-Anforderung

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

Optionale Anforderungsheader

Name	Beschreibung
Authorization	Bearer {code}. Erforderlich.

Anforderungstext

Geben Sie im Anforderungstext die Werte für die relevanten Felder an, die aktualisiert werden sollen. Vorhandene Eigenschaften, die nicht im Anforderungstext enthalten sind, behalten ihre vorherigen Werte bei oder werden basierend auf Änderungen an anderen Eigenschaftswerten neu berechnet. Geben Sie aus Gründen der Leistung vorhandene Werte, die nicht geändert wurden, nicht an.

Eigenschaft	Typ	Beschreibung
defaultDuration	Dauer	Die Standardlänge des Diensts, dargestellt in Anzahl von Tagen, Stunden, Minuten und Sekunden. Beispiel: P11D23H59M59.999999999999999.
Defaultlocation	location	Der physische Standardspeicherort für den Dienst.
defaultPrice	Gleitkommawert mit doppelter Genauigkeit	Der Standardmäßige Geldpreis für den Dienst.
defaultPriceType	bookingPriceType	Die Standardgebühr für den Dienst. Mögliche Werte: `undefined`, `fixedPrice`, `startingAt`, `hourly`, `free`, `priceVaries`, `callUs`, `notSet`, `unknownFutureValue`.
defaultReminders	bookingReminder-Sammlung	Der Standardsatz von Erinnerungen für einen Termin dieses Diensts. Der Wert dieser Eigenschaft ist nur verfügbar, wenn dieser bookingService anhand seiner ID gelesen wird.
description	String	Eine Textbeschreibung für den Dienst.
displayName	String	Ein Dienstname.
id	String	Schreibgeschützt.
isAnonymousJoinEnabled	Boolesch	`True` , wenn die URL für die anonyme Teilnahme am Termin (anonymousJoinWebUrl) für den für diesen Dienst gebuchten Termin generiert wird.
isCustomerAllowedToManageBooking	Boolesch	Gibt an, dass der Kunde buchungen verwalten kann, die vom Personal erstellt wurden. Der Standardwert ist `false`.
isHiddenFromCustomers	Boolesch	True bedeutet, dass dieser Dienst für Kunden nicht für Buchungen verfügbar ist.
isLocationOnline	Boolesch	True gibt an, dass die Termine für den Dienst online gehalten werden. Der Standardwert ist `false`.
languageTag	String	Die Sprache der Self-Service-Buchungsseite.
notes	String	Zusätzliche Informationen zu diesem Dienst.
postBuffer	Dauer	Die Zeit, die nach Ablauf eines Termins für diesen Dienst gepuffert werden muss und bevor der nächste Kundentermin gebucht werden kann.
preBuffer	Dauer	Die Zeit, die gepuffert werden soll, bevor ein Termin für diesen Dienst beginnen kann.
schedulingPolicy	bookingSchedulingPolicy	Der Satz von Richtlinien, die bestimmen, wie Termine für diesen Diensttyp erstellt und verwaltet werden sollen.
smsNotificationsEnabled	Boolesch	True gibt an, dass SMS-Benachrichtigungen zum Termin des Diensts an die Kunden gesendet werden können. Der Standardwert ist `false`.
staffMemberIds	String collection	Stellt die Mitarbeiter dar , die diesen Dienst bereitstellen.
customQuestions	bookingQuestionAssignment-Sammlung	Dies enthält den Satz von benutzerdefinierten Fragen, die einem bestimmten Dienst zugeordnet sind. Optional.
maximumAttendeesCount	Int32	Die maximale Anzahl von Kunden, die in einem Dienst zulässig sind.

Antwort

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204 No content zurückgegeben. Es gibt nichts im Antworttext zurück.

Beispiel

Anforderung

Im folgenden Beispiel wird die Dauer des angegebenen Diensts aktualisiert.

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);

Wichtig

Die Microsoft Graph SDKs verwenden standardmäßig die Version v1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Beta-Version verfügbar sind. Einzelheiten zum Zugriff auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph SDKs mit der Beta-API.

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.


// 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"\
}\
'

Wichtig

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.



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)

Wichtig

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.


// 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);

Wichtig

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.


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);

Wichtig

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.


<?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();

Wichtig

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.


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)

Wichtig

Einzelheiten darüber, wie Sie das SDK zu Ihrem Projekt hinzufügen und eine authProvider-Instanz erstellen, finden Sie in der SDK-Dokumentation.

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 204 No Content

Buchungsservice aktualisieren

Berechtigungen

HTTP-Anforderung

Optionale Anforderungsheader

Anforderungstext

Antwort

Beispiel

Anforderung

Antwort

Feedback

Feedback

Zusätzliche Ressourcen