Method: notification.partners.bookings.patch

Aktualisiert eine vorhandene Buchung (Booking).

HTTP-Anfrage

PATCH https://mapsbooking.googleapis.com/v1alpha/notification/{booking.name=partners/*/bookings/*}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
booking.name

string

Ressourcenname der Buchung: partners/{partner ID}/bookings/{booking ID}

Abfrageparameter

Parameter
updateMask

string (FieldMask format)

Feldmaske aller Buchungsfelder, die aktualisiert werden sollen

Dies ist eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen. Beispiel: "user.displayName,photo".

bookingFailure

object (BookingFailure)

Wenn die Verarbeitung einer asynchron bestätigten Buchungsanfrage fehlschlägt und der Buchungsstatus zu FAILED geändert wird, sollte in diesem Feld der Fehler in der Geschäftslogik angezeigt werden. Beispielsweise kann der Nutzer zu dieser Zeit schon eine Reservierung haben. Das Feld sollte nur beim Aktualisieren des Buchungsstatus auf FAILED gesetzt werden. Ansonsten wird es ignoriert.

Anfragetext

Der Anfragetext enthält eine Instanz von Booking.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Booking.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/mapsbooking

BookingFailure

Statusdaten, die Aufschluss darüber geben, warum die asynchrone Verarbeitung einer Buchung fehlgeschlagen ist. Mit "BookingFailure" sollen in erster Linie Fehler in der Geschäftslogik erfasst werden.

JSON-Darstellung
{
  "cause": enum (Cause),
  "rejectedCardType": enum (CreditCardType),
  "description": string,
  "paymentFailure": {
    object (PaymentFailureInformation)
  }
}
Felder
cause

enum (Cause)

Der Grund, warum die Buchung fehlgeschlagen ist (Pflichtfeld)

rejectedCardType

enum (CreditCardType)

(nur erforderlich, wenn der Grund PAYMENT_ERROR_CARD_TYPE_REJECTED ist)

description

string

In diesem optionalen Feld kann der Partner zusätzliche Angaben zu Debugging-Zwecken machen. (optional)

paymentFailure

object (PaymentFailureInformation)

Informationen zu Zahlungsfehlern

Cause

Optionen für Fehlerursachen

Optionen
CAUSE_UNSPECIFIED Standardwert: Nicht verwenden; entspricht "Unbekannter Fehler"
SLOT_UNAVAILABLE Der referenzierte verfügbare Slot ist nicht mehr verfügbar.
SLOT_ALREADY_BOOKED_BY_USER Der Nutzer hat bereits einen Termin für den referenzierten verfügbaren Slot gebucht.
LEASE_EXPIRED Die Lease (falls vorhanden) ist abgelaufen und kann nicht mehr für die angeforderte Buchung verwendet werden.
OUTSIDE_CANCELLATION_WINDOW Aufgrund von Zeitbeschränkungen in den Stornierungsrichtlinien des Händlers ist die angeforderte Stornierung derzeit nicht möglich.
PAYMENT_ERROR_CARD_TYPE_REJECTED Bei der Verarbeitung der Zahlung ist ein Fehler aufgetreten, weil der angegebene Kreditkartentyp vom Händler nicht akzeptiert wurde. Der Kreditkartentyp muss in "rejectedCardType" angegeben werden.
PAYMENT_ERROR_CARD_DECLINED Bei der Verarbeitung der Zahlung ist ein Fehler aufgetreten, weil die angegebene Kreditkarte abgelehnt wurde.
PAYMENT_OPTION_NOT_VALID Bei Paketen oder Mitgliedschaften, die für die Buchung verwendet wurden, ist ein Fehler aufgetreten. Möglicherweise sind sie aufgebraucht oder abgelaufen.
PAYMENT_ERROR Bei der Verarbeitung der Zahlung für diese Buchung ist ein Fehler aufgetreten. Verwende diesen Wert, um einen allgemeinen zahlungsbezogenen Fehler anzugeben, wenn der Fehler keinem bestimmten oben angegebenen Zahlungsfehler entspricht.
USER_CANNOT_USE_PAYMENT_OPTION Der Nutzer darf die angegebene Zahlungsoption nicht verwenden, z. B. ein Nutzer, der zum zweiten Mal den Preis für Neueinsteiger auswählt.
BOOKING_ALREADY_CANCELLED Eine Buchung, die der Nutzer stornieren wollte, ist bereits storniert.
BOOKING_NOT_CANCELLABLE Eine Buchung, die der Nutzer stornieren wollte, kann nicht storniert werden.
OVERLAPPING_RESERVATION Der Nutzer hat eine bestehende Reservierung, die zu nahe bei dieser Reservierung liegt.
USER_OVER_BOOKING_LIMIT Die Buchung ist fehlgeschlagen, weil der Nutzer das Limit für Buchungen pro Nutzer des Aggregators überschritten hat.
PAYMENT_REQUIRES_3DS1

Lege diese Option fest, wenn die Transaktion nach einer abgelehnten Zahlung wiederholt werden soll, diesmal aber nach der 3DS1-Challenge/Response-Authentifizierung. Am Fehlerstatus der aktuellen Transaktion ändert sich dadurch nichts. Die Wiederholung ist ein komplett eigenständiger Vorgang.

Wenn das die Fehlerursache ist, MUSS "paymentFailure.3DS1_parameters" festgelegt werden. Andernfalls wird die aktuelle Ursache wie PAYMENT_ERROR behandelt.

PaymentFailureInformation

Informationen zu Zahlungsfehlern

JSON-Darstellung
{
  "threeds1Parameters": {
    object (ThreeDS1Parameters)
  }
}
Felder
threeds1Parameters

object (ThreeDS1Parameters)

Parameter, die von einem RwG-Aggregator verwendet werden, um ein 3DS1-Authentifizierungsprotokoll mit dem Nutzer zu initiieren. Wird ignoriert, wenn "BookingFailure.cause" nicht auf PAYMENT_REQUIRES_3DS1 gesetzt ist.

ThreeDS1Parameters

Parameter, über die angefordert wird, dass RwG eine 3DS1-Bestätigung durchführt.

Die Parameter beruhen auf der EMVCo-Beschreibung des 3DS1-Protokolls.

JSON-Darstellung
{
  "acsUrl": string,
  "paReq": string,
  "transactionId": string,
  "mdMerchantData": string
}
Felder
acsUrl

string

Die URL, von der aus ein Formular geladen wird, das dem Nutzer zur Authentifizierung angezeigt wird.

paReq

string

Eine "PaymentAuthentication"-Anfrage. Wird an das ACSUrl-Formular gesendet, falls angegeben.

transactionId

string

Eine vom ACS-Anbieter verwendete Kennung. Wird an das ACSUrl-Formular gesendet, falls angegeben.

mdMerchantData

string

Händlerdaten: Wird an das ACSUrl-Formular gesendet, falls angegeben.