تستبدل 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، يتم فرض قيود إضافية على الشرط:
تُستخدَم هذه الحقول عادةً لتقديم معلومات كاملة عن مدى التوفّر في نطاق زمني محدّد. يتم تفسير ضبط startTimeRestrict مع ترك endTimeRestrict على لجميع الأوقات بدءًا من startTimeRestrict. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
serviceAvailability.endTimeRestrict |
يتم تفسير ضبط endTimeRestrict مع ترك startTimeRestrict على القيمة "جميع الأوقات" حتى 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، يتم فرض قيود إضافية على الشرط:
تُستخدَم هذه الحقول عادةً لتقديم معلومات كاملة عن مدى التوفّر في نطاق زمني محدّد. يتم تفسير ضبط startTimeRestrict مع ترك endTimeRestrict على لجميع الأوقات بدءًا من startTimeRestrict. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
endTimeRestrict |
يتم تفسير ضبط endTimeRestrict مع ترك startTimeRestrict على القيمة "جميع الأوقات" حتى endTimeRestrict. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
durationRestrict |
يؤدي ضبط المدة إلى حصر نطاق التحديث فقط بمدى التوفّر بمدة مطابقة. مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
resourcesRestrict |
يؤدي ضبط الموارد إلى حصر نطاق التحديث على هذه المجموعة من الموارد فقط. يجب أن تتطابق جميع حقول أرقام التعريف للموارد تمامًا. |
availability[] |
تمثّل هذه السمة القائمة الجديدة لمدى التوفّر. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/mapsbooking