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 اساساً برای گرفتن خطاهای منطقی تجاری در نظر گرفته شده است.

نمایندگی 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 )

اطلاعات مربوط به عدم پرداخت

علت

برشمردن علل شکست

Enums
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 کاربر نمی تواند از گزینه پرداخت داده شده استفاده کند (مثلاً کاربر سعی می کند برای بار دوم از قیمت بار اول استفاده کند).
BOOKING_ALREADY_CANCELLED رزروی که کاربر سعی کرده آن را لغو کند قبلاً لغو شده است.
BOOKING_NOT_CANCELLABLE رزروی که کاربر سعی کرده آن را لغو کند قابل لغو نیست.
OVERLAPPING_RESERVATION کاربر یک رزرو موجود بسیار نزدیک به این زمان دارد.
USER_OVER_BOOKING_LIMIT به دلیل اینکه کاربر بیش از حد مجاز رزرو برای هر کاربر جمع‌آوری‌کننده بود، رزرو انجام نشد.
PAYMENT_REQUIRES_3DS1

زمانی را تنظیم کنید که پرداخت رد شود زیرا شما درخواست می‌کنید که تراکنش دوباره امتحان شود، اما این بار پس از انجام چالش/پاسخ 3DS1. توجه داشته باشید که وضعیت شکست تراکنش فعلی ناموفق خواهد ماند. تلاش مجدد کاملاً مجزا خواهد بود.

وقتی این دلیل شکست است، payFailure.3DS1_parameters باید تنظیم شود. اگر اینطور نیست، با علت فعلی به گونه‌ای برخورد می‌شود که گویی PAYMENT_ERROR است.

اطلاعات خطای پرداخت

اطلاعات مربوط به عدم پرداخت

نمایندگی JSON
{
  "threeds1Parameters": {
    object (ThreeDS1Parameters)
  }
}
زمینه های
threeds1Parameters

object ( ThreeDS1Parameters )

پارامترهایی که توسط یک تجمیع کننده RwG برای شروع پروتکل احراز هویت 3DS1 با کاربر استفاده می شود. نادیده گرفته می شود مگر اینکه BookingFailure.cause روی PAYMENT_REQUIRES_3DS1 تنظیم شود.

ThreeDS1Parameters

پارامترهایی که درخواست می کنند RwG یک چالش 3DS1 را انجام دهد.

پارامترها توسط توضیحات EMVCo از پروتکل 3DS1 تنظیم می شوند.

نمایندگی JSON
{
  "acsUrl": string,
  "paReq": string,
  "transactionId": string,
  "mdMerchantData": string
}
زمینه های
acsUrl

string

نشانی اینترنتی که از آن فرم بارگیری می شود تا برای احراز هویت به کاربر ارائه شود.

paReq

string

یک درخواست احراز هویت Payment. در صورت ارائه به فرم ACSUrl ارسال می شود.

transactionId

string

شناسه ای که توسط ارائه دهنده ACS استفاده می شود. در صورت ارائه به فرم ACSUrl ارسال می شود.

mdMerchantData

string

داده های تجاری در صورت ارائه به فرم ACSUrl ارسال می شود.