Method: notification.partners.bookings.patch

עדכון של Booking קיים.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
booking.name

string

שם המשאב של ההזמנה: partners/{partner ID}/bookings/{booking ID}

פרמטרים של שאילתה

פרמטרים
updateMask

string (FieldMask format)

אנונימיזציה של שדות בכל שדות ההזמנה שצריך לעדכן

זוהי רשימה של שמות שדות מלאים, שמופרדים בפסיקים. דוגמה: "user.displayName,photo"
bookingFailure

object (BookingFailure)

אם העיבוד של בקשת הזמנה שאושרה באופן אסינכרוני נכשל וסטטוס ההזמנה מתעדכן ל'נכשל', השדה הזה אמור לשקף את השגיאה הלוגית העסקית (למשל, יש למשתמש הזמנה קיימת שקרובה מדי למועד הזה). צריך להגדיר את השדה הזה רק כשמעדכנים את סטטוס ההזמנה ל'נכשל', אחרת המערכת תתעלם ממנו.

גוף הבקשה

גוף הבקשה מכיל מופע של 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)

מידע על כשלים בתשלומים.

סיבה

פירוט הסיבות לכשל.

טיפוסים בני מנייה (enums)
CAUSE_UNSPECIFIED ערך ברירת המחדל: לא לשימוש, מוגדר כ"שגיאה לא ידועה"
SLOT_UNAVAILABLE משבצת הזמינות שצוינה לא זמינה יותר.
SLOT_ALREADY_BOOKED_BY_USER המשתמש כבר קבע פגישה במשבצת הזמינות שצוינה.
LEASE_EXPIRED פג התוקף של השכירות (אם סופקה) ואי אפשר יותר להשתמש בה כדי להשלים את ההזמנה המבוקשת.
OUTSIDE_CANCELLATION_WINDOW לא ניתן לבצע את הביטול המבוקש כרגע עקב הגבלות זמן במדיניות הביטולים של המוכר.
PAYMENT_ERROR_CARD_TYPE_REJECTED אירעה שגיאה במהלך עיבוד התשלום מכיוון שהמוכר לא קיבל את סוג כרטיס האשראי שצוין. יש לציין את סוג כרטיס האשראי בשדה deniedCardType.
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.

PaymentFailureInformation

מידע על כשלים בתשלומים.

ייצוג 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

כתובת ה-URL שממנה יש לטעון טופס ולהציג אותו למשתמש לצורך אימות.
paReq

string

בקשת PaymentAuthentication. ההודעה תפורסם בטופס ACSUrl, אם סופק.
transactionId

string

מזהה המשמש את ספק ה-ACS. ההודעה תפורסם בטופס ACSUrl, אם סופק.
mdMerchantData

string

נתוני מוכרים. ההודעה תפורסם בטופס ACSUrl, אם סופק.