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)

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

סיבה

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

טיפוסים בני מנייה (enum)
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. חשוב לדעת: מצב הכשל של העסקה הנוכחית יישאר כשל. הניסיון החוזר יהיה נפרד לגמרי.

אם זו הסיבה לכשל, צריך להגדיר את paymentFailure.3DS1_parameters. אם לא, הסיבה הנוכחית תטופל כאילו היא PAYMENT_ERROR.

PaymentFailureInformation

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

ייצוג ב-JSON 
{
  "threeds1Parameters": {
    object (ThreeDS1Parameters)
  }
}
שדות
threeds1Parameters

object (ThreeDS1Parameters)

פרמטרים שמשמשים את המצטבר של RwG כדי להפעיל פרוטוקול אימות 3DS1 עם המשתמש. המערכת תתעלם מהשדה הזה אלא אם הערך של BookingFailure.cause הוא PAYMENT_REQUIRES_3DS1.

ThreeDS1Parameters

פרמטרים שמבקשים מ-RwG לבצע אתגר 3DS1.

הפרמטרים מוגדרים על ידי התיאור של פרוטוקול 3DS1 של EMVCo.

ייצוג ב-JSON 
{
  "acsUrl": string,
  "paReq": string,
  "transactionId": string,
  "mdMerchantData": string
}
שדות
acsUrl

string

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

string

בקשה לאימות תשלום. הערך הזה יפורסם בטופס ACSUrl אם הוא יסופק.
transactionId

string

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

string

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