الفهرس
TimeOfDayRange(رسالة)TimeOfDayWindow(رسالة)ValidTimeException(رسالة)ValidityPeriod(رسالة)ValidityRange(رسالة)ValidityScope(تعداد)
TimeOfDayRange
[START time_range_definition] نطاق زمني مغلق ومفتوح
| الحقول | |
|---|---|
open_time |
وقت يشير إلى وقت بداية اليوم من النطاق (شامل). إذا لم يتم ضبطها، يعني ذلك 00:00:00. اختياريّ. |
close_time |
وقت يشير إلى وقت انتهاء اليوم من النطاق (حصري). إذا لم يتم ضبطها، يعني ذلك 23:59:59. اختياريّ. |
TimeOfDayWindow
عنصر TimeWindow هو كيان مركّب يصف قائمة بالنوافذ التي يمكن فيها إما تقديم طلب المستخدم أو تنفيذه. [START time_window_definition]
| الحقول | |
|---|---|
time_windows |
الفترة الزمنية التي يمكن فيها تقديم الطلب أو تنفيذه الحقل مطلوب. |
day_of_week[] |
قائمة بأيام الأسبوع التي يتم تطبيق النوافذ عليها في حال عدم ضبط أي أيام، يعني ذلك أنّ السياسة تنطبق على جميع أيام الأسبوع. اختياريّ. |
ValidTimeException
[START valid_time_exception_definition]
| الحقول | |
|---|---|
exceptional_period |
الطابع الزمني للبدء والانتهاء الذي لا يكون العرض الترويجي صالحًا خلاله يجب أن تمثّل هذه الأوقات أيامًا مختلفة، أي يجب أن يكون وقت البدء هو 00:00 (بداية اليوم) ووقت الانتهاء هو 00:00 (باستثناء) في اليوم الذي تنتهي فيه فترة الاستثناء. |
ValidityPeriod
[START validity_period_definition]
| الحقول | |
|---|---|
valid_period |
الطابع الزمني للبدء والانتهاء الذي يكون العرض ساريًا خلاله يجب أن تمثّل هذه الأوقات أيامًا مختلفة، أي يجب أن يكون وقت البدء هو 00:00 (بداية اليوم) ووقت الانتهاء هو 00:00 (باستثناء) في اليوم الذي تنتهي فيه فترة الصلاحية. |
time_of_day[] |
تحدّد هذه السمة الفاصل الزمني الصالح في يوم معيّن والأيام التي يتوفّر فيها العرض. بالنسبة إلى الأُطر الزمنية التي تتجاوز منتصف الليل (مثل من الساعة 10 مساءً إلى الساعة 2 صباحًا)، استخدِم نوافذ منفصلة لكل يوم: نافذة تنتهي في الساعة 11:59:59 مساءً وأخرى تبدأ في الساعة 12:00 صباحًا في اليوم التالي. على سبيل المثال: الاثنين: من الساعة 10 صباحًا إلى الساعة 5 مساءً الثلاثاء: من الساعة 10 صباحًا إلى الساعة 2 ظهرًا الثلاثاء: من الساعة 5 مساءً إلى الساعة 7 مساءً الأربعاء والخميس والجمعة والسبت والأحد: من الساعة 3 مساءً إلى الساعة 7 مساءً إذا لم يتم ضبط أي وقت، يعني ذلك أنّ العرض الترويجي متاح طوال الوقت ضمن |
time_exceptions[] |
تحدّد هذه السمة الاستثناءات من السمتَين valid_period وvalid_time_of_week المذكورتَين أعلاه. |
date_exceptions[] |
تحدّد هذه السمة الاستثناءات بالأيام من السمتَين valid_period وtime_of_day أعلاه |
validity_scope |
تحدّد هذه السمة نطاق فترة الصلاحية. |
validity_duration_in_days |
مدة صلاحية القسيمة (بالأيام) بعد شرائها |
ValidityRange
[START validity_range_definition] نطاق طابع زمني مغلق ومفتوح
| الحقول | |
|---|---|
valid_from_time |
تمثّل هذه السمة وقت بدء النطاق (شامل). الحقل مطلوب. |
valid_through_time |
تمثّل هذه السمة وقت انتهاء النطاق (غير مشمول). في حال عدم ضبطها، يعني ذلك أنّ هذه الفترة لا تنتهي أبدًا. اختياريّ. |
ValidityScope
[START validity_scope_definition] نطاق فترة الصلاحية، أي الإجراءات التي تنطبق عليها فترة الصلاحية هذه بالضبط
| عمليات التعداد | |
|---|---|
VALIDITY_SCOPE_UNSPECIFIED |
|
VALIDITY_SCOPE_CLAIM |
|
VALIDITY_SCOPE_REDEEM |
|