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)

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

גוף הבקשה

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

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

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

string

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

string

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

string

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

string

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