ValidityPeriod

[START validity_period_definition]

تمثيل JSON
{
  "validPeriod": {
    object (ValidityRange)
  },
  "timeOfDay": [
    {
      object (TimeOfDayWindow)
    }
  ],
  "timeExceptions": [
    {
      object (ValidTimeException)
    }
  ],
  "dateExceptions": [
    {
      object (Date)
    }
  ],
  "validityScope": enum (ValidityScope),
  "validityDurationInDays": integer
}
الحقول
validPeriod

object (ValidityRange)

الطابع الزمني للبدء والانتهاء الذي يكون العرض ساريًا خلاله يجب أن تمثّل هذه الأوقات أيامًا مختلفة، أي يجب أن يكون وقت البدء هو 00:00 (بداية اليوم) ووقت الانتهاء هو 00:00 (باستثناء) في اليوم الذي تنتهي فيه فترة الصلاحية.

timeOfDay[]

object (TimeOfDayWindow)

تحدّد هذه السمة الفاصل الزمني الصالح في يوم معيّن والأيام التي يتوفّر فيها العرض. بالنسبة إلى الأُطر الزمنية التي تتجاوز منتصف الليل (مثل من الساعة 10 مساءً إلى الساعة 2 صباحًا)، استخدِم نوافذ منفصلة لكل يوم: نافذة تنتهي في الساعة 11:59:59 مساءً وأخرى تبدأ في الساعة 12:00 صباحًا في اليوم التالي. على سبيل المثال: الاثنين: من الساعة 10 صباحًا إلى الساعة 5 مساءً الثلاثاء: من الساعة 10 صباحًا إلى الساعة 2 ظهرًا الثلاثاء: من الساعة 5 مساءً إلى الساعة 7 مساءً الأربعاء والخميس والجمعة والسبت والأحد: من الساعة 3 مساءً إلى الساعة 7 مساءً إذا لم يتم ضبط أي وقت، يعني ذلك أنّ العرض الترويجي متاح طوال الوقت ضمن validPeriod.

timeExceptions[]

object (ValidTimeException)

تحدّد هذه السمة استثناءات للسمتَين validPeriod وvalid_time_of_week المذكورتَين أعلاه.

dateExceptions[]

object (Date)

تحدّد هذه السمة الاستثناءات بالأيام من السمتَين validPeriod وtimeOfDay أعلاه

validityScope

enum (ValidityScope)

تحدّد هذه السمة نطاق فترة الصلاحية.

validityDurationInDays

integer

مدة صلاحية القسيمة (بالأيام) بعد شرائها