Bookingappointment aktualisierenUpdate bookingappointment

Namespace: microsoft.graphNamespace: microsoft.graph

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Aktualisieren der Eigenschaften eines bookingAppointment -Objekts in der angegebenen bookingbusiness.Update the properties of a bookingAppointment object in the specified bookingbusiness.

BerechtigungenPermissions

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.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

BerechtigungstypPermission type Berechtigungen (von der Berechtigung mit den wenigsten Rechten zu der mit den meisten Rechten)Permissions (from least to most privileged)
Delegiert (Geschäfts-, Schul- oder Unikonto)Delegated (work or school account) BookingsAppointment. ReadWrite. all, reservations. ReadWrite. all, reservations. Manage. allBookingsAppointment.ReadWrite.All, Bookings.ReadWrite.All, Bookings.Manage.All
Delegiert (persönliches Microsoft-Konto)Delegated (personal Microsoft account) Nicht unterstütztNot supported.
AnwendungApplication Nicht unterstütztNot supported.

HTTP-AnforderungHTTP request

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

Optionale AnforderungsheaderOptional request headers

NameName BeschreibungDescription
AuthorizationAuthorization Bearer {code}Bearer {code}

AnforderungstextRequest body

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. Aus Gründen der Leistung sollten Sie vorhandene Werte, die nicht geändert wurden, nicht angeben.In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.

EigenschaftProperty TypType BeschreibungDescription
customerEmailAddresscustomerEmailAddress ZeichenfolgeString Die SMTP-Adresse des bookingCustomer , der den Termin Bucht.The SMTP address of the bookingCustomer who is booking the appointment.
CustomerIDcustomerId ZeichenfolgeString Die ID des bookingCustomer für diesen Termin.The ID of the bookingCustomer for this appointment. Wenn beim Erstellen eines Termins keine ID angegeben wird, wird ein neues bookingCustomer -Objekt erstellt.If no ID is specified when an appointment is created, then a new bookingCustomer object is created. Nachdem Sie festgelegt haben, sollten Sie die unveränderliche CustomerID berücksichtigen.Once set, you should consider the customerId immutable.
customerLocationcustomerLocation locationlocation Stellt Standortinformationen für die bookingCustomer dar, die den Termin buchen.Represents location information for the bookingCustomer who is booking the appointment.
CustomerNamecustomerName ZeichenfolgeString Der Name des Kunden.The customer's name.
customerNotescustomerNotes ZeichenfolgeString Notizen des Kunden, der diesem Termin zugeordnet ist.Notes from the customer associated with this appointment. Sie können den Wert nur abrufen, wenn Sie diesen bookingAppointment durch seine ID lesen.You can get the value only when reading this bookingAppointment by its ID.
Sie können diese Eigenschaft nur festlegen, wenn Sie zunächst einen Termin mit einem neuen Kunden erstellen.You can set this property only when initially creating an appointment with a new customer. Nach diesem Argument wird der Wert vom Kunden berechnet, der durch CustomerIDdargestellt wird.After that point, the value is computed from the customer represented by customerId.
customerPhonecustomerPhone ZeichenfolgeString Die Telefonnummer des Kunden.The customer's phone number.
durationduration DauerDuration Die im ISO8601 -Format bezeichnete Länge des Termins.The length of the appointment, denoted in ISO8601 format.
endend dateTimeTimeZonedateTimeTimeZone Datum, Uhrzeit und Zeitzone, zu denen der Termin endet.The date, time, and time zone that the appointment ends.
invoiceAmountinvoiceAmount Gleitkommawert mit doppelter GenauigkeitDouble Der abgerechnete Betrag auf der Rechnung.The billed amount on the invoice.
invoiceDateinvoiceDate dateTimeTimeZonedateTimeTimeZone Das Datum, die Uhrzeit und die Zeitzone der Rechnung für diesen Termin.The date, time, and time zone of the invoice for this appointment.
Invoice-NrinvoiceId ZeichenfolgeString Die ID der Rechnung.The ID of the invoice.
invoiceStatusinvoiceStatus stringstring Der Status der Rechnung.The status of the invoice. Mögliche Werte sind: draft, reviewing, open, canceled, paid und corrective.Possible values are: draft, reviewing, open, canceled, paid, corrective.
invoiceUrlinvoiceUrl ZeichenfolgeString Die URL der Rechnung in Microsoft-Buchungen.The URL of the invoice in Microsoft Bookings.
optOutOfCustomerEmailoptOutOfCustomerEmail BooleanBoolean True gibt an, dass die bookingCustomer für diesen Termin keine Bestätigung für diesen Termin erhalten möchte.True indicates that the bookingCustomer for this appointment does not wish to receive a confirmation for this appointment.
postBufferpostBuffer DauerDuration Die Zeitspanne, die nach Beendigung des Termins für die Bereinigung als Beispiel reserviert werden soll.The amount of time to reserve after the appointment ends, for cleaning up, as an example. Der Wert wird im ISO8601 -Format ausgedrückt.The value is expressed in ISO8601 format.
preBufferpreBuffer DauerDuration Die Zeitspanne, die vor Beginn des Termins für die Vorbereitung reserviert werden soll, als Beispiel.The amount of time to reserve before the appointment begins, for preparation, as an example. Der Wert wird im ISO8601 -Format ausgedrückt.The value is expressed in ISO8601 format.
Preisprice Gleitkommawert mit doppelter GenauigkeitDouble Der reguläre Preis für einen Termin für die angegebene bookingService.The regular price for an appointment for the specified bookingService.
priceTypepriceType stringstring Eine Einstellung, die Flexibilität für die Preisstruktur von Diensten bereitstellt.A setting to provide flexibility for the pricing structure of services. Mögliche Werte: undefined, fixedPrice, startingAt, hourly, free, priceVaries, callUs, notSet.Possible values are: undefined, fixedPrice, startingAt, hourly, free, priceVaries, callUs, notSet.
Erinnerungenreminders bookingReminder -SammlungbookingReminder collection Die Sammlung von Kunden Erinnerungen, die für diesen Termin gesendet wurden.The collection of customer reminders sent for this appointment. Der Wert dieser Eigenschaft ist nur verfügbar, wenn dieser bookingAppointment durch seine ID gelesen wird.The value of this property is available only when reading this bookingAppointment by its ID.
selfServiceAppointmentIdselfServiceAppointmentId ZeichenfolgeString Eine zusätzliche Tracking-ID für den Termin, wenn der Termin direkt vom Kunden auf der Seite "Planung" erstellt wurde, im Gegensatz zu einem Mitarbeiter im Namen des Kunden.An additional tracking ID for the appointment, if the appointment has been created directly by the customer on the scheduling page, as opposed to by a staff member on the behalf of the customer.
ServiceIDserviceId ZeichenfolgeString Die ID des bookingService , das diesem Termin zugeordnet ist.The ID of the bookingService associated with this appointment.
serviceLocationserviceLocation locationlocation Der Ort, an dem der Dienst zugestellt wird.The location where the service is delivered.
Wert Service NameserviceName ZeichenfolgeString Der Name der bookingService , die diesem Termin zugeordnet ist.The name of the bookingService associated with this appointment.
Diese Eigenschaft ist beim Erstellen eines neuen Termins optional.This property is optional when creating a new appointment. Wenn kein Wert angegeben ist, wird er aus dem Dienst berechnet, der dem Termin durch die Service -Eigenschaft zugeordnet ist.If not specified, it is computed from the service associated with the appointment by the serviceId property.
serviceNotesserviceNotes ZeichenfolgeString Notizen aus einer bookingStaffMember.Notes from a bookingStaffMember. Der Wert dieser Eigenschaft ist nur verfügbar, wenn dieser bookingAppointment durch seine ID gelesen wird.The value of this property is available only when reading this bookingAppointment by its ID.
staffMemberIdsstaffMemberIds String-SammlungString collection Die ID der einzelnen bookingStaffMember , die in diesem Termin geplant sind.The ID of each bookingStaffMember who is scheduled in this appointment.
startstart dateTimeTimeZonedateTimeTimeZone Das Datum, die Uhrzeit und die Zeitzone, die der Termin beginnt.The date, time, and time zone that the appointment begins.

AntwortResponse

Wenn die Methode erfolgreich verläuft, wird der Antwortcode 204, No Content zurückgegeben. Im Antworttext wird nichts zurückgegeben.If successful, this method returns a 204, No Content response code. It does not return anything in the response body.

BeispielExample

AnforderungRequest

Im folgenden Beispiel wird das Datum des Diensts um einen Tag geändert, und außerdem wird das Rechnungsdatum aktualisiert.The following example changes the date of service by a day, and updated the invoice date as well.

PATCH https://graph.microsoft.com/beta/bookingBusinesses/Contosolunchdelivery@M365B489948.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"
    }
}
AntwortResponse

Nachfolgend sehen Sie ein Beispiel der Antwort.The following is an example of the response.

HTTP/1.1 204 No Content