Method: notification.partners.bookings.patch

یک Booking موجود را به‌روزرسانی می‌کند.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
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 )

اطلاعات مربوط به شکست پرداخت‌ها

علت

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

انوم‌ها
CAUSE_UNSPECIFIED مقدار پیش‌فرض: استفاده نشود؛ به معنای «خطای ناشناخته» است
SLOT_UNAVAILABLE جایگاه مورد نظر دیگر در دسترس نیست.
SLOT_ALREADY_BOOKED_BY_USER کاربر قبلاً برای بازه زمانی مورد نظر وقت ملاقات رزرو کرده است.
LEASE_EXPIRED اجاره نامه (در صورت وجود) منقضی شده است و دیگر نمی‌توان از آن برای تکمیل رزرو درخواستی استفاده کرد.
OUTSIDE_CANCELLATION_WINDOW لغو درخواستی به دلیل محدودیت‌های زمانی در سیاست لغو سفارش فروشنده، در حال حاضر قابل انجام نیست.
PAYMENT_ERROR_CARD_TYPE_REJECTED هنگام پردازش پرداخت خطایی رخ داد زیرا نوع کارت اعتباری ارائه شده توسط فروشنده پذیرفته نشد. نوع کارت اعتباری باید در قسمت rejectCardType وارد شود.
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. توجه داشته باشید که وضعیت شکست تراکنش فعلی همچنان ناموفق خواهد ماند. تلاش مجدد کاملاً جداگانه خواهد بود.

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

اطلاعات شکست پرداخت

اطلاعات مربوط به شکست پرداخت‌ها

نمایش JSON 
{
  "threeds1Parameters": {
    object (ThreeDS1Parameters)
  }
}
فیلدها
threeds1Parameters

object ( ThreeDS1Parameters )

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

پارامترهای ThreeDS1

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

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

نمایش JSON 
{
  "acsUrl": string,
  "paReq": string,
  "transactionId": string,
  "mdMerchantData": string
}
فیلدها
acsUrl

string

آدرس اینترنتی (URL) که از طریق آن فرمی برای ارائه به کاربر جهت احراز هویت بارگذاری می‌شود.

paReq

string

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

transactionId

string

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

mdMerchantData

string

اطلاعات فروشنده. در صورت ارائه، در فرم ACSUrl ارسال شود.