bookingAppointment aktualisieren

Artikel
07/18/2022
8 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 bookingAppointment-Objekts im angegebenen bookingBusiness.Update the properties of a bookingAppointment object in the specified bookingBusiness.

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)	BookingsAppointment.ReadWrite.All, Bookings. ReadWrite.All, Bookings. Manage.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt
Anwendung	BookingsAppointment.ReadWrite.All, Bookings. Read.All

Hinweis

Wenn Sie eine benutzerdefinierte App mithilfe von Anwendungsberechtigungen erstellen, müssen Sie die Überprüfung der Geschäftsregeln befolgen.

HTTP-Anforderung

PATCH /bookingBusinesses/{id}/appointments/{id}

Optionale Anforderungsheader

Name	Beschreibung
Authorization	Bearer {code}. Erforderlich.

Anforderungstext

Stellen Sie im Anforderungstext nur die Werte für Eigenschaften bereit, 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.

In der folgenden Tabelle sind die Eigenschaften angegeben, die aktualisiert werden können.

Eigenschaft	Typ	Beschreibung
customerEmailAddress	Zeichenfolge	Die SMTP-Adresse des bookingCustomers , der den Termin buchen soll.
customerId	Zeichenfolge	Die ID des bookingCustomer für diesen Termin. Wenn beim Erstellen eines Termins keine ID angegeben wird, wird ein neues bookingCustomer-Objekt erstellt. Nach dem Festlegen sollten Sie die customerId als unveränderlich betrachten.
customerLocation	location	Stellt Standortinformationen für den bookingCustomer dar, der den Termin buchen wird.
Customername	Zeichenfolge	Der Name des Kunden.
customerNotes	String	Notizen des Kunden, der diesem Termin zugeordnet ist. Sie können den Wert nur abrufen, wenn Sie dieses bookingAppointment anhand seiner ID lesen. Sie können diese Eigenschaft nur festlegen, wenn Sie zunächst einen Termin mit einem neuen Kunden erstellen. Danach wird der Wert aus dem Kunden berechnet, der durch customerId dargestellt wird.
customerPhone	Zeichenfolge	Die Telefonnummer des Kunden.
Kunden	bookingCustomerInformation-Sammlung	Es listet die Kundeneigenschaften für einen Termin auf. Ein Termin enthält eine Liste mit Kundeninformationen, und jede Einheit gibt die Eigenschaften eines Kunden an, der Teil dieses Termins ist. Optional.
customerTimeZone	Zeichenfolge	Die Zeitzone des Kunden. Eine Liste der möglichen Werte finden Sie unter dateTimeTimeZone.
Dauer	Dauer	Die Länge des Termins im ISO8601-Format .
end	dateTimeTimeZone	Das Datum, die Uhrzeit und die Zeitzone, mit der der Termin endet.
invoiceAmount	Gleitkommawert mit doppelter Genauigkeit	Der rechnungsmäßige Betrag auf der Rechnung.
invoiceDate	dateTimeTimeZone	Datum, Uhrzeit und Zeitzone der Rechnung für diesen Termin.
invoiceId	String	Die ID der Rechnung.
invoiceStatus	string	Der Status der Rechnung. Mögliche Werte sind: `draft`, `reviewing`, `open`, `canceled`, `paid` und `corrective`.
invoiceUrl	Zeichenfolge	Die URL der Rechnung in Microsoft Bookings.
filledAttendeesCount	Int32	Die aktuelle Anzahl der Kunden im Termin. Erforderlich.
isLocationOnline	Boolesch	True gibt an, dass der Termin online abgehalten wird. Standardwert ist "false".
maximumAttendeesCount	Int32	Die maximale Anzahl von Kunden, die im Termin zulässig sind. Erforderlich.
optOutOfCustomerEmail	Boolesch	True gibt an, dass bookingCustomer für diesen Termin keine Bestätigung für diesen Termin erhalten möchte.
postBuffer	Dauer	Die Zeitdauer, die nach Ablauf des Termins für die Bereinigung reserviert werden muss, als Beispiel. Der Wert wird im ISO8601-Format ausgedrückt.
preBuffer	Dauer	Der Zeitraum, der reserviert werden muss, bevor der Termin beginnt, als Beispiel für die Vorbereitung. Der Wert wird im ISO8601-Format ausgedrückt.
Preis	Gleitkommawert mit doppelter Genauigkeit	Der reguläre Preis für einen Termin für den angegebenen bookingService.
priceType	bookingPriceType	Eine Einstellung, die Flexibilität für die Preisstruktur von Diensten bietet. Mögliche Werte: `undefined`, `fixedPrice`, `startingAt`, `hourly`, `free`, `priceVaries`, `callUs`, `notSet`, `unknownFutureValue`.
Erinnerungen	bookingReminder-Sammlung	Die Sammlung von Kundenerinnerungen, die für diesen Termin gesendet wurden. Der Wert dieser Eigenschaft ist nur verfügbar, wenn dieser bookingAppointment anhand seiner ID gelesen wird.
selfServiceAppointmentId	String	Eine zusätzliche Tracking-ID für den Termin, wenn der Termin direkt vom Kunden auf der Terminplanungsseite erstellt wurde, im Gegensatz zu einem Mitarbeiter im Auftrag des Kunden.
ServiceID	Zeichenfolge	Die ID des bookingService, der diesem Termin zugeordnet ist.
serviceLocation	location	Der Ort, an dem der Dienst bereitgestellt wird.
Servicename	Zeichenfolge	Der Name des bookingService, der diesem Termin zugeordnet ist. Diese Eigenschaft ist optional beim Erstellen eines neuen Termins. Wenn nicht angegeben, wird es aus dem Dienst berechnet, der dem Termin durch die eigenschaft serviceId zugeordnet ist.
serviceNotes	String	Notizen von einem bookingStaffMember. Der Wert dieser Eigenschaft ist nur verfügbar, wenn dieser bookingAppointment anhand seiner ID gelesen wird.
smsNotificationsEnabled	Boolesch	"True" gibt an, dass SMS-Benachrichtigungen für den Termin an die Kunden gesendet werden. Standardwert ist "false".
staffMemberIds	String collection	Die ID jedes bookingStaffMembers , der in diesem Termin geplant ist.
start	dateTimeTimeZone	Das Datum, die Uhrzeit und die Zeitzone, mit der der Termin beginnt.

Hinweis

Wenn die maximal zulässige Anzahl von Kunden (maximumAttedeesCount) im Dienst größer als 1 ist:

Stellen Sie sicher, dass die Kunden im Buchungskalender vorhanden sind. Andernfalls erstellen Sie mithilfe des Vorgangs "bookingCustomer erstellen ".
Übergeben Sie gültige Kunden-IDs, wenn Sie den Termin erstellen oder aktualisieren. Wenn die Kunden-ID ungültig ist, wird dieser Kunde nicht in das Terminobjekt eingeschlossen.

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 das Datum des Diensts um einen Tag geändert und das Rechnungsdatum aktualisiert.

PATCH https://graph.microsoft.com/beta/bookingBusinesses/Contosolunchdelivery@contoso.onmicrosoft.com/appointments/AAMkADKnAAA=
Content-type: application/json

{
    "@odata.type":"#microsoft.graph.bookingAppointment",
    "end":{
        "@odata.type":"#microsoft.graph.dateTimeTimeZone",
        "dateTime":"2018-05-06T12:30:00.0000000+00:00",
        "timeZone":"UTC"
    },
    "invoiceDate":{
        "@odata.type":"#microsoft.graph.dateTimeTimeZone",
        "dateTime":"2018-05-06T12:30:00.0000000+00:00",
        "timeZone":"UTC"
    },
    "start":{
        "@odata.type":"#microsoft.graph.dateTimeTimeZone",
        "dateTime":"2018-05-06T12:00:00.0000000+00:00",
        "timeZone":"UTC"
    }
}


GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var bookingAppointment = new BookingAppointment
{
    End = new DateTimeTimeZone
    {
        DateTime = "2018-05-06T12:30:00+00:00",
        TimeZone = "UTC"
    },
    InvoiceDate = new DateTimeTimeZone
    {
        DateTime = "2018-05-06T12:30:00+00:00",
        TimeZone = "UTC"
    },
    Start = new DateTimeTimeZone
    {
        DateTime = "2018-05-06T12:00:00+00:00",
        TimeZone = "UTC"
    }
};

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

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 bookingAppointment = {
    '@odata.type':'#microsoft.graph.bookingAppointment',
    end: {
        '@odata.type':'#microsoft.graph.dateTimeTimeZone',
        dateTime: '2018-05-06T12:30:00.0000000+00:00',
        timeZone: 'UTC'
    },
    invoiceDate: {
        '@odata.type':'#microsoft.graph.dateTimeTimeZone',
        dateTime: '2018-05-06T12:30:00.0000000+00:00',
        timeZone: 'UTC'
    },
    start: {
        '@odata.type':'#microsoft.graph.dateTimeTimeZone',
        dateTime: '2018-05-06T12:00:00.0000000+00:00',
        timeZone: 'UTC'
    }
};

await client.api('/bookingBusinesses/Contosolunchdelivery@contoso.onmicrosoft.com/appointments/AAMkADKnAAA=')
    .version('beta')
    .update(bookingAppointment);

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/appointments/AAMkADKnAAA="]]];
[urlRequest setHTTPMethod:@"PATCH"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphBookingAppointment *bookingAppointment = [[MSGraphBookingAppointment alloc] init];
MSGraphDateTimeTimeZone *end = [[MSGraphDateTimeTimeZone alloc] init];
[end setDateTime: "2018-05-06T12:30:00+00:00"];
[end setTimeZone:@"UTC"];
[bookingAppointment setEnd:end];
MSGraphDateTimeTimeZone *invoiceDate = [[MSGraphDateTimeTimeZone alloc] init];
[invoiceDate setDateTime: "2018-05-06T12:30:00+00:00"];
[invoiceDate setTimeZone:@"UTC"];
[bookingAppointment setInvoiceDate:invoiceDate];
MSGraphDateTimeTimeZone *start = [[MSGraphDateTimeTimeZone alloc] init];
[start setDateTime: "2018-05-06T12:00:00+00:00"];
[start setTimeZone:@"UTC"];
[bookingAppointment setStart:start];

NSError *error;
NSData *bookingAppointmentData = [bookingAppointment getSerializedDataWithError:&error];
[urlRequest setHTTPBody:bookingAppointmentData];

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

BookingAppointment bookingAppointment = new BookingAppointment();
DateTimeTimeZone end = new DateTimeTimeZone();
end.dateTime = "2018-05-06T12:30:00+00:00";
end.timeZone = "UTC";
bookingAppointment.end = end;
DateTimeTimeZone invoiceDate = new DateTimeTimeZone();
invoiceDate.dateTime = "2018-05-06T12:30:00+00:00";
invoiceDate.timeZone = "UTC";
bookingAppointment.invoiceDate = invoiceDate;
DateTimeTimeZone start = new DateTimeTimeZone();
start.dateTime = "2018-05-06T12:00:00+00:00";
start.timeZone = "UTC";
bookingAppointment.start = start;

graphClient.bookingBusinesses("Contosolunchdelivery@contoso.onmicrosoft.com").appointments("AAMkADKnAAA=")
    .buildRequest()
    .patch(bookingAppointment);

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.NewBookingAppointment()
end := msgraphsdk.NewDateTimeTimeZone()
requestBody.SetEnd(end)
dateTime := "2018-05-06T12:30:00.0000000+00:00"
end.SetDateTime(&dateTime)
timeZone := "UTC"
end.SetTimeZone(&timeZone)
end.SetAdditionalData(map[string]interface{}{
    "@odata.type": "#microsoft.graph.dateTimeTimeZone",
}
invoiceDate := msgraphsdk.NewDateTimeTimeZone()
requestBody.SetInvoiceDate(invoiceDate)
dateTime := "2018-05-06T12:30:00.0000000+00:00"
invoiceDate.SetDateTime(&dateTime)
timeZone := "UTC"
invoiceDate.SetTimeZone(&timeZone)
invoiceDate.SetAdditionalData(map[string]interface{}{
    "@odata.type": "#microsoft.graph.dateTimeTimeZone",
}
start := msgraphsdk.NewDateTimeTimeZone()
requestBody.SetStart(start)
dateTime := "2018-05-06T12:00:00.0000000+00:00"
start.SetDateTime(&dateTime)
timeZone := "UTC"
start.SetTimeZone(&timeZone)
start.SetAdditionalData(map[string]interface{}{
    "@odata.type": "#microsoft.graph.dateTimeTimeZone",
}
requestBody.SetAdditionalData(map[string]interface{}{
    "@odata.type": "#microsoft.graph.bookingAppointment",
}
bookingBusinessId := "bookingBusiness-id"
bookingAppointmentId := "bookingAppointment-id"
graphClient.BookingBusinessesById(&bookingBusinessId).AppointmentsById(&bookingAppointmentId).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.bookingAppointment"
    End = @{
        "@odata.type" = "#microsoft.graph.dateTimeTimeZone"
        DateTime = "2018-05-06T12:30:00.0000000+00:00"
        TimeZone = "UTC"
    }
    InvoiceDate = @{
        "@odata.type" = "#microsoft.graph.dateTimeTimeZone"
        DateTime = "2018-05-06T12:30:00.0000000+00:00"
        TimeZone = "UTC"
    }
    Start = @{
        "@odata.type" = "#microsoft.graph.dateTimeTimeZone"
        DateTime = "2018-05-06T12:00:00.0000000+00:00"
        TimeZone = "UTC"
    }
}

Update-MgBookingBusinessAppointment -BookingBusinessId $bookingBusinessId -BookingAppointmentId $bookingAppointmentId -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

bookingAppointment aktualisieren

Berechtigungen

HTTP-Anforderung

Optionale Anforderungsheader

Anforderungstext

Antwort

Beispiel

Anforderung

Antwort

Feedback