يحل محل Availability
من Services
الحالية. لا يضمن هذا الطلب المجمّع الاتزان. لن يتم عرض سوى خانات مدى التوفّر التي تم تعديلها بنجاح.
طلب HTTP
POST https://mapsbooking.googleapis.com/v1alpha/inventory/{parent=partners/*}/availability:replace
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
parent |
تنسيق |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"extendedServiceAvailability": [
{
object ( |
الحقول | |
---|---|
extendedServiceAvailability[] |
تشير هذه السمة إلى مدى توفّر الخدمة الممتد والذي يُستخدَم لاستبدال خانات مدى التوفّر الحالية. |
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
الرد المجمّع لاستبدال خانات مدى التوفّر المتعددة في Service
. لن تتضمّن هذه الرسالة سوى الخانات التي تم تعديلها بنجاح.
تمثيل JSON |
---|
{
"extendedServiceAvailability": [
{
object ( |
الحقول | |
---|---|
extendedServiceAvailability[] |
الرسائل التي تم تعديلها بنجاح والتي تم استخدامها بدلاً من خانات مدى التوفّر الحالية |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/mapsbooking
ExtendedServiceAvailability
قائمة بمدى التوفّر والأشخاص الذين يجب تقديم طلبهم ومتى يجب تطبيقها.
تمثيل JSON |
---|
{ "merchantId": string, "serviceId": string, "startTimeRestrict": string, "endTimeRestrict": string, "durationRestrict": string, "resourcesRestrict": { object ( |
الحقول | |
---|---|
merchantId |
هذا حقل إلزامي مطلوب لتحديد التاجر الذي تنتمي إليه رسائل التوفّر أدناه. |
serviceId |
هذا حقل إلزامي مطلوب لتحديد الخدمة التي تنتمي إليها رسائل التوفّر أدناه. |
startTimeRestrict |
وفي حال توفير هذه البيانات، سنعتبر كيانات "مدى التوفّر" المُقدَّمة نبذة كاملة من [startTimeRestrict, endTimeRestrict). ويعني ذلك أنّه سيتم حذف جميع بيانات مدى التوفّر الحالية في حال استيفاء الشرط التالي:
في حال ضبط رسالة مدة، يتم تقييد الشرط بشكل أكبر:
في حال ضبط رسالة resourcesRestrict، يتم فرض قيود إضافية على الشرط:
تُستخدَم هذه الحقول عادةً لتقديم معلومات كاملة عن مدى التوفّر في نطاق زمني محدّد. يتم تفسير ضبط startTimeRestrict مع ترك endTimeRestrict على لجميع الأوقات بدءًا من startTimeRestrict. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
endTimeRestrict |
يتم تفسير ضبط endTimeRestrict مع ترك startTimeRestrict على القيمة "جميع الأوقات" حتى endTimeRestrict. طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
durationRestrict |
يؤدي ضبط المدة إلى حصر نطاق التحديث فقط بمدى التوفّر بمدة مطابقة. مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى وتنتهي بالأرقام " |
resourcesRestrict |
يؤدي ضبط الموارد إلى حصر نطاق التحديث على هذه المجموعة من الموارد فقط. يجب أن تتطابق جميع حقول أرقام التعريف للموارد تمامًا. |
availability[] |
تمثّل هذه السمة القائمة الجديدة لمدى التوفّر. |