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)

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

סיבה

חישוב הסיבות לכשל.

טיפוסים בני מנייה (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, אם צוין.