Method: inventory.partners.availability.replace

מחליף את Availability של Services הקיימים. הקריאה המרובת הזו לא מבטיחה אטימות. יוחזרו רק משבצות זמינות שעודכנו בהצלחה.

בקשת HTTP

POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*}/availability:replace

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

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

פרמטרים
parent

string

פורמט של partners/{partner_id}.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
שדות
extendedServiceAvailability[]

object (ExtendedServiceAvailability)

הזמינות המורחבת של השירות שמשמשת להחלפת משבצות הזמינות הקיימות.

גוף התגובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:

התשובה בכמות גדולה שהחלפת מספר משבצות זמינות של Service. רק משבצות שידור שעודכנו בהצלחה ייכללו בהודעה הזו

ייצוג JSON 
{
  "extendedServiceAvailability": [
    {
      object (ExtendedServiceAvailability)
    }
  ]
}
שדות
extendedServiceAvailability[]

object (ExtendedServiceAvailability)

ההודעות על זמינות השירות המורחבות עודכנו בהצלחה ונעשה בהן שימוש להחלפת משבצות הזמינות הקיימות.

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/mapsbooking

ExtendedServiceAvailability

רשימת הזמינות ומי/מתי צריך להחיל אותן.

ייצוג JSON 
{
  "merchantId": string,
  "serviceId": string,
  "startTimeRestrict": string,
  "endTimeRestrict": string,
  "durationRestrict": string,
  "resourcesRestrict": {
    object (Resources)
  },
  "availability": [
    {
      object (Availability)
    }
  ]
}
שדות
merchantId

string

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

string

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

string (Timestamp format)

אם תספקו את הפרטים האלה, ישויות הזמינות שסופקו ייחשבו כתמונת מצב מלאה מ-[startTimeRestrict, endTimeRestrict). כלומר, כל הזמינות הקיימת תימחק אם מתקיים התנאי הבא:

   startTimeRestrict <= availability.start_sec &&
   availability.start_sec < endTimeRestrict

אם הוגדרה הודעה לגבי משך הזמן, התנאי יוגבל עוד יותר:

  availability.duration == durationRestrict

אם מוגדרת הודעה של resourcesRestrict, התנאי יוגבל עוד יותר:

   availability.resources.staff_id == resourcesRestrict.staff_id &&
   availability.resources.room_id == resourcesRestrict.room_id

בדרך כלל השדות האלה משמשים כדי לספק עדכון מלא של הזמינות בטווח זמן נתון.

אם מגדירים את startTimeLimit בלי להגדיר את endTimeRestrict, המערכת מפרשת את ההגדרה של כל הזמנים שמתחילה ב-startTimeRestrict.

חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
endTimeRestrict

string (Timestamp format)

אם מגדירים את endTimeRestrict לא מוגדרת, המערכת תפרש את הערך של כל הזמנים עד ל-endTimeRestrict.

חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
durationRestrict

string (Duration format)

הגדרת משך הזמן מגבילה עוד יותר את היקף העדכון כך שתכלול רק את הזמינות עם משך התאמה מסוים.

משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, המסתיים ב-'s'. דוגמה: "3.5s".
resourcesRestrict

object (Resources)

הגדרת משאבים מגבילה עוד יותר את היקף העדכון לקבוצת משאבים זו בלבד. כל שדות המזהה של המשאבים חייבים להתאים בדיוק.
availability[]

object (Availability)

רשימת הזמינות החדשה.