Method: notification.partners.bookings.patch

既存の Booking を更新します。

HTTP リクエスト

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

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
booking.name

string

予約のリソース名: partners/{partner ID}/bookings/{booking ID}

クエリ パラメータ

パラメータ
updateMask

string (FieldMask format)

更新するすべての予約フィールドのフィールド マスク。

完全修飾フィールド名のカンマ区切りリスト。例: "user.displayName,photo"

bookingFailure

object (BookingFailure)

非同期で確認された予約リクエストの処理が失敗し、予約のステータスが FAILED に更新されている場合、このフィールドはビジネス ロジック エラー(たとえば、「ユーザーがこの時間の近くにすでに予約を行っている」)を反映します。このフィールドは、予約ステータスを FAILED に更新する場合にのみ設定してください。それ以外の場合は無視されます。

リクエスト本文

リクエストの本文には Booking のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には Booking のインスタンスが含まれます。

承認スコープ

次の OAuth スコープが必要です。

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

BookingFailure

予約の処理が非同期で失敗した理由を示すステータス データ。BookingFailure は、主にビジネス ロジックのエラーを取得することを目的としています。

JSON 表現
{
  "cause": enum (Cause),
  "rejectedCardType": enum (CreditCardType),
  "description": string,
  "paymentFailure": {
    object (PaymentFailureInformation)
  }
}
フィールド
cause

enum (Cause)

予約が失敗した理由。(必須)

rejectedCardType

enum (CreditCardType)

(原因が PAYMENT_ERROR_CARD_TYPE_REJECTED の場合のみ必須)

description

string

パートナーはこのフィールドを使って、デバッグ専用の追加情報を含めることができます。(省略可)

paymentFailure

object (PaymentFailureInformation)

支払いのエラーに関する情報。

原因

エラーの原因の列挙。

列挙型
CAUSE_UNSPECIFIED デフォルト値: 使用しないでください。「不明なエラー」になります
SLOT_UNAVAILABLE 参照された予約枠は利用できなくなっています。
SLOT_ALREADY_BOOKED_BY_USER ユーザーは参照された予約枠をすでに予約しています。
LEASE_EXPIRED リース(指定されている場合)が期限切れになり、リクエストされた予約を完了するために使用できなくなりました。
OUTSIDE_CANCELLATION_WINDOW リクエストされたキャンセルは、販売者のキャンセル ポリシーの時間制限により、現時点では実行できません。
PAYMENT_ERROR_CARD_TYPE_REJECTED 指定されたクレジット カードの種類が販売者に受け入れられなかったため、支払いの処理中にエラーが発生しました。クレジット カードのタイプは、rejectedCardType で指定する必要があります。
PAYMENT_ERROR_CARD_DECLINED 指定されたクレジット カードが承認されなかったため、支払いの処理中にエラーが発生しました。
PAYMENT_OPTION_NOT_VALID 予約の支払いに使用されたパック / メンバーシップでエラーが発生しました。有効な残高がなかったか、有効期限が切れている可能性があります。
PAYMENT_ERROR この予約の支払いの処理中にエラーが発生しました。上記の支払いエラーと一致しない場合にのみ、この値を使って一般的な支払い関連のエラーを示します。
USER_CANNOT_USE_PAYMENT_OPTION ユーザーは指定された支払いオプションを使用できません(1 回限りの価格を 2 回目に使用しようとしているユーザーなど)。
BOOKING_ALREADY_CANCELLED ユーザーがキャンセルしようとした予約はすでにキャンセルされています。
BOOKING_NOT_CANCELLABLE ユーザーがキャンセルしようとした予約はキャンセルできません。
OVERLAPPING_RESERVATION ユーザーがこの時間の近くにすでに予約を行っています。
USER_OVER_BOOKING_LIMIT アグリゲータのユーザーあたりの予約制限を超えているため、予約が失敗しました。
PAYMENT_REQUIRES_3DS1

取り引きの再試行をリクエストしていますが、今回は 3DS1 のチャレンジ / レスポンスを行った後にリクエストしたため、支払いが拒否された場合に設定されます。現在のトランザクションのエラー状態はエラーのままになります。再試行は完全に別に行われます。

これがエラーの理由である場合は、paymentFailure.3DS1_parameters を設定する必要があります。そうでない場合は、現在の原因は PAYMENT_ERROR のように扱われます。

PaymentFailureInformation

支払いのエラーに関する情報。

JSON 表現
{
  "threeds1Parameters": {
    object (ThreeDS1Parameters)
  }
}
フィールド
threeds1Parameters

object (ThreeDS1Parameters)

ユーザーとの 3DS1 認証プロトコルを開始するために、RwG アグリゲータによって使用されるパラメータ。BookingFailure.cause が PAYMENT_REQUIRES_3DS1 に設定されていない限り、無視されます。

ThreeDS1Parameters

RwG が 3DS1 チャレンジを実行するようリクエストするパラメータ。

パラメータは、3DS1 プロトコルの EMVCo の説明によって設定されます。

JSON 表現
{
  "acsUrl": string,
  "paReq": string,
  "transactionId": string,
  "mdMerchantData": string
}
フィールド
acsUrl

string

認証のためにユーザーに提示するフォームの読み込み元となる URL。

paReq

string

PaymentAuthentication リクエスト。ACSUrl フォームに送信されます(指定されている場合)。

transactionId

string

ACS プロバイダにより使用される識別子。ACSUrl フォームに送信されます(指定されている場合)。

mdMerchantData

string

販売者データ。ACSUrl フォームに送信されます(指定されている場合)。