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

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

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

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

אם קובעים את הערך startTimeRestrict בזמן שלא מגדירים את endTimeRestrict, המערכת תפרש את כל משך הזמן שמתחיל בנקודת startTimeRestrict.

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

string (Timestamp format)

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

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

string (Duration format)

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

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

object (Resources)

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

object (Availability)

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