تستبدل هذه الدالة Availability
بقيمة Service
حالية لتاجر يديره المجمّع المحدّد، وتُرجعها.
طلب HTTP
POST https://mapsbooking.googleapis.com/v1alpha/inventory/{serviceAvailability.name=partners/*/merchants/*/services/*}/availability:replace
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
service |
اسم مصدر الخدمة المطلوب تطبيق ذلك عليها. بتنسيق |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "serviceAvailability": { "name": string, "startTimeRestrict": string, "endTimeRestrict": string, "durationRestrict": string, "resourcesRestrict": { "staffId": string, "staffName": string, "roomId": string, "roomName": string, "partySize": integer, "roomDescription": { object ( |
الحقول | |
---|---|
service |
في حال توفّرها، سنعتبر كيانات مدى التوفّر المقدَّمة بمثابة لقطة كاملة من [startTimeRestrict، endTimeRestrict). وهذا يعني أنّه سيتم حذف جميع بيانات مدى التوفّر الحالية إذا كان الشرط التالي صحيحًا:
في حال ضبط رسالة مدة، يتم فرض قيود إضافية على الشرط:
في حال ضبط رسالة resourcesRestrict، يتم فرض قيود إضافية على الشرط:
تُستخدَم هذه الحقول عادةً لتقديم تعديل كامل على مدى التوفّر في نطاق زمني معيّن. إنّ ضبط startTimeRestrict مع ترك endTimeRestrict بدون ضبط يعني كل الوقت بدءًا من startTimeRestrict. يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: |
service |
إنّ ضبط endTimeRestrict مع ترك startTimeRestrict بدون ضبط يعني كل الوقت حتى endTimeRestrict. يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: |
service |
يؤدي ضبط المدة إلى حصر نطاق التعديل في مدى التوفّر فقط مع المدة المطابقة. المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ " |
service |
تؤدي إضافة "قيود" إلى حصر نطاق التعديل بهذه المجموعة من الموارد فقط. يجب أن تتطابق جميع حقول ids للموارد تمامًا. |
service |
قائمة مدى التوفّر الجديدة. |
نص الاستجابة
قائمة بمدى التوفّر والجهات التي يجب تطبيقها عليها أو الحالات التي يجب تطبيقها فيها
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "name": string, "startTimeRestrict": string, "endTimeRestrict": string, "durationRestrict": string, "resourcesRestrict": { object ( |
الحقول | |
---|---|
name |
اسم مصدر الخدمة المطلوب تطبيق ذلك عليها. بتنسيق |
start |
في حال توفّرها، سنعتبر كيانات مدى التوفّر المقدَّمة بمثابة لقطة كاملة من [startTimeRestrict، endTimeRestrict). وهذا يعني أنّه سيتم حذف جميع بيانات مدى التوفّر الحالية إذا كان الشرط التالي صحيحًا:
في حال ضبط رسالة مدة، يتم فرض قيود إضافية على الشرط:
في حال ضبط رسالة resourcesRestrict، يتم فرض قيود إضافية على الشرط:
تُستخدَم هذه الحقول عادةً لتقديم تعديل كامل على مدى التوفّر في نطاق زمني معيّن. إنّ ضبط startTimeRestrict مع ترك endTimeRestrict بدون ضبط يعني كل الوقت بدءًا من startTimeRestrict. يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: |
end |
إنّ ضبط endTimeRestrict مع ترك startTimeRestrict بدون ضبط يعني كل الوقت حتى endTimeRestrict. يجب أن يكون طابعًا زمنيًا بالتنسيق RFC3339 UTC "Zulu" وبدقة تصل إلى نانوثانية وما يصل إلى تسعة أرقام كسور. أمثلة: |
duration |
يؤدي ضبط المدة إلى حصر نطاق التعديل في مدى التوفّر فقط مع المدة المطابقة. المدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ " |
resources |
تؤدي إضافة "قيود" إلى حصر نطاق التعديل بهذه المجموعة من الموارد فقط. يجب أن تتطابق جميع حقول ids للموارد تمامًا. |
availability[] |
قائمة مدى التوفّر الجديدة. |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/mapsbooking