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

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

string

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

string

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