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)

אם יסופקו, נתייחס לישות הזמינות שסופקו כקובץ snapshot מלא מ-[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.

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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)

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

object (Availability)

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