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