bookingservice aktualisieren

Artikel
07/18/2022
5 Minuten Lesedauer

Namespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können geändert werden. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in Version 1.0 verfügbar ist, verwenden Sie die Versionsauswahl .

Dient zum Aktualisieren der Eigenschaften eines bookingService-Objekts im angegebenen bookingBusiness-Objekt.

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

Kurs
Typische Länge eines Termins
Erinnerungen
Jeder Zeitpuffer, der vor oder nach dem Dienst eingerichtet werden soll
Planen von Richtlinienparametern , z. B. mindeste Benachrichtigung zu buchen oder abzubrechen, und ob Kunden bestimmte Mitarbeiter für einen Termin auswählen können.

Berechtigungen

Eine der nachfolgenden Berechtigungen ist erforderlich, um diese API aufrufen zu können. Weitere Informationen, unter anderem zur Auswahl von Berechtigungen, finden Sie im Artikel zum Thema Berechtigungen.

Berechtigungstyp	Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)
Delegiert (Geschäfts-, Schul- oder Unikonto)	Bookings.ReadWrite.All, Bookings.Manage.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	Nicht unterstützt

HTTP-Anforderung

PATCH /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 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 Zahlen von Tagen, Stunden, Minuten und Sekunden. Beispiel: P11D23H59M59.9999999999999S.
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 Standardmethode für die Abrechnung des Diensts. 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	Zeichenfolge	Eine Textbeschreibung für den Dienst.
displayName	Zeichenfolge	Ein Dienstname.
id	Zeichenfolge	Schreibgeschützt.
languageTag	Zeichenfolge	Die Sprache der Self-Service-Buchungsseite.
isHiddenFromCustomers	Boolesch	"True" bedeutet, dass dieser Dienst nicht für Kunden zur Buchung verfügbar ist.
isLocationOnline	Boolesch	True gibt an, dass die Termine für den Dienst online gehalten werden. Standardwert ist "false".
notes	String	Zusätzliche Informationen zu diesem Dienst.
postBuffer	Dauer	Die Pufferzeit nach Ablauf eines Termins für diesen Dienst und vor dem nächsten Kundentermin kann gebucht werden.
preBuffer	Dauer	Die Zeit zum Puffern vor einem Termin für diesen Dienst kann beginnen.
schedulingPolicy	bookingSchedulingPolicy	Der Satz von Richtlinien, die bestimmen, wie Termine für diesen Diensttyp erstellt und verwaltet werden sollen.
smsNotificationsEnabled	Boolesch	"True" gibt an, SMS Benachrichtigungen für den Diensttermin an die Kunden gesendet werden können. Standardwert ist "false".
staffMemberIds	String-Sammlung	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. Im Antworttext wird nichts zurückgegeben.

Beispiel

Anforderung

Im folgenden Beispiel wird die Dauer des angegebenen Diensts aktualisiert.

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

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


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var bookingService = new BookingService
{
    DefaultDuration = new Duration("PT30M")
};

await graphClient.BookingBusinesses["{bookingBusiness-id}"].Services["{bookingService-id}"]
    .Request()
    .UpdateAsync(bookingService);

Wichtig

Microsoft Graph SDKs verwenden standardmäßig die Version 1.0 der API und unterstützen nicht alle Typen, Eigenschaften und APIs, die in der Betaversion verfügbar sind. Ausführliche Informationen zum Zugreifen auf die Beta-API mit dem SDK finden Sie unter Verwenden der Microsoft Graph-SDKs mit der Beta-API.

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz 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('/bookingBusinesses/Contosolunchdelivery@contoso.onmicrosoft.com/services/57da6774-a087-4d69-b0e6-6fb82c339976')
    .version('beta')
    .update(bookingService);

Wichtig

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.


MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/bookingBusinesses/Contosolunchdelivery@contoso.onmicrosoft.com/services/57da6774-a087-4d69-b0e6-6fb82c339976"]]];
[urlRequest setHTTPMethod:@"PATCH"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphBookingService *bookingService = [[MSGraphBookingService alloc] init];
[bookingService setDefaultDuration:@"PT30M"];

NSError *error;
NSData *bookingServiceData = [bookingService getSerializedDataWithError:&error];
[urlRequest setHTTPBody:bookingServiceData];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

Wichtig

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.


GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

BookingService bookingService = new BookingService();
bookingService.defaultDuration = DatatypeFactory.newInstance().newDuration("PT30M");

graphClient.bookingBusinesses("Contosolunchdelivery@contoso.onmicrosoft.com").services("57da6774-a087-4d69-b0e6-6fb82c339976")
    .buildRequest()
    .patch(bookingService);

Wichtig

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.


//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.NewBookingService()
defaultDuration := "PT30M"
requestBody.SetDefaultDuration(&defaultDuration)
requestBody.SetAdditionalData(map[string]interface{}{
    "@odata.type": "#microsoft.graph.bookingService",
}
bookingBusinessId := "bookingBusiness-id"
bookingServiceId := "bookingService-id"
graphClient.BookingBusinessesById(&bookingBusinessId).ServicesById(&bookingServiceId).Patch(requestBody)

Wichtig

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.


Import-Module Microsoft.Graph.Bookings

$params = @{
    "@odata.type" = "#microsoft.graph.bookingService"
    DefaultDuration = "PT30M"
}

Update-MgBookingBusinessService -BookingBusinessId $bookingBusinessId -BookingServiceId $bookingServiceId -BodyParameter $params

Wichtig

Ausführliche Informationen zum Hinzufügen des SDK zu Ihrem Projekt und zum Erstellen einer authProvider-Instanz finden Sie in der SDK-Dokumentation.

Antwort

Nachfolgend sehen Sie ein Beispiel der Antwort.

HTTP/1.1 204 No Content

bookingservice aktualisieren

Berechtigungen

HTTP-Anforderung

Optionale Anforderungsheader

Anforderungstext

Antwort

Beispiel

Anforderung

Antwort

Feedback