הפונקציה מחליפה את הערך Availability
של Service
קיים של מוכר שמנוהל על ידי אתר האגרגטור שצוין ומחזירה אותו.
בקשת HTTP
POST https://mapsbooking.googleapis.com/v1alpha/inventory/{serviceAvailability.name=partners/*/merchants/*/services/*}/availability:replace
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
serviceAvailability.name |
שם המשאב של השירות שעליו יש להחיל זאת. בפורמט של |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "serviceAvailability": { "name": string, "startTimeRestrict": string, "endTimeRestrict": string, "durationRestrict": string, "resourcesRestrict": { "staffId": string, "staffName": string, "roomId": string, "roomName": string, "partySize": integer }, "availability": [ { "startTime": string, "duration": string, "spotsTotal": string, "spotsOpen": string, "availabilityTag": string, "resources": { object ( |
שדות | |
---|---|
serviceAvailability.startTimeRestrict |
אם תספקו את הפרטים האלה, ישויות הזמינות שסופקו ייחשבו כתמונת מצב מלאה מ-[startTimeRestrict, endTimeRestrict). כלומר, כל הזמינות הקיימת תימחק אם מתקיים התנאי הבא:
אם הוגדרה הודעה לגבי משך הזמן, התנאי יוגבל עוד יותר:
אם מוגדרת הודעה של resourcesRestrict, התנאי יוגבל עוד יותר:
בדרך כלל השדות האלה משמשים כדי לספק עדכון מלא של הזמינות בטווח זמן נתון. אם מגדירים את startTimeLimit בלי להגדיר את endTimeRestrict, המערכת מפרשת את ההגדרה של כל הזמנים שמתחילה ב-startTimeRestrict. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
serviceAvailability.endTimeRestrict |
אם מגדירים את endTimeRestrict לא מוגדרת, המערכת תפרש את הערך של כל הזמנים עד ל-endTimeRestrict. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
serviceAvailability.durationRestrict |
הגדרת משך הזמן מגבילה עוד יותר את היקף העדכון כך שתכלול רק את הזמינות עם משך התאמה מסוים. משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, המסתיים ב-' |
serviceAvailability.resourcesRestrict |
הגדרת משאבים מגבילה עוד יותר את היקף העדכון לקבוצת משאבים זו בלבד. כל שדות המזהה של המשאבים חייבים להתאים בדיוק. |
serviceAvailability.availability[] |
רשימת הזמינות החדשה. |
גוף התגובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
רשימת הזמינות ומי/מתי צריך להחיל אותן.
ייצוג JSON |
---|
{ "name": string, "startTimeRestrict": string, "endTimeRestrict": string, "durationRestrict": string, "resourcesRestrict": { object ( |
שדות | |
---|---|
name |
שם המשאב של השירות שעליו יש להחיל זאת. בפורמט של |
startTimeRestrict |
אם תספקו את הפרטים האלה, ישויות הזמינות שסופקו ייחשבו כתמונת מצב מלאה מ-[startTimeRestrict, endTimeRestrict). כלומר, כל הזמינות הקיימת תימחק אם מתקיים התנאי הבא:
אם הוגדרה הודעה לגבי משך הזמן, התנאי יוגבל עוד יותר:
אם מוגדרת הודעה של resourcesRestrict, התנאי יוגבל עוד יותר:
בדרך כלל השדות האלה משמשים כדי לספק עדכון מלא של הזמינות בטווח זמן נתון. אם מגדירים את startTimeLimit בלי להגדיר את endTimeRestrict, המערכת מפרשת את ההגדרה של כל הזמנים שמתחילה ב-startTimeRestrict. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
endTimeRestrict |
אם מגדירים את endTimeRestrict לא מוגדרת, המערכת תפרש את הערך של כל הזמנים עד ל-endTimeRestrict. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
durationRestrict |
הגדרת משך הזמן מגבילה עוד יותר את היקף העדכון כך שתכלול רק את הזמינות עם משך התאמה מסוים. משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, המסתיים ב-' |
resourcesRestrict |
הגדרת משאבים מגבילה עוד יותר את היקף העדכון לקבוצת משאבים זו בלבד. כל שדות המזהה של המשאבים חייבים להתאים בדיוק. |
availability[] |
רשימת הזמינות החדשה. |
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/mapsbooking