REST Resource: products

المرجع: المنتج

منتج واحد.

تمثيل JSON 
{
  "name": string,
  "externalId": string,
  "displayName": string,
  "description": string,
  "labels": {
    string: string,
    ...
  },
  "creativeSpecifications": [
    {
      object (CreativeSpecification)
    }
  ],
  "bookingLeadTime": string,
  "assignmentLeadTime": string,
  "minFlightDuration": string,
  "maxFlightDuration": string,
  "slotDuration": string,
  "createTime": string,
  "updateTime": string,
  "currencyCode": string
}
الحقول
name

string

تمثّل هذه السمة اسم المورد للمنتج بالتنسيق: products/{id}. على سبيل المثال: products/product123.
externalId

string

اختياريّ. رقم تعريف يتم استخدامه لربط هذا الكيان بمصادر خارجية.
displayName

string

مطلوب. الاسم المعروض للمنتج.

يجب أن يكون بترميز UTF-8 بحيث لا يزيد حجمه عن 240 بايت.
description

string

اختياريّ. حقل إضافي حر لوصف المنتج
labels

map (key: string, value: string)

اختياريّ. مجموعة التصنيفات الحرة لوصف هذا المنتج.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }
creativeSpecifications[]

object (CreativeSpecification)

مطلوب. قائمة تصميمات الإعلانات المسموح بها التي يمكن عرضها لهذا المنتج
bookingLeadTime

string (Duration format)

مطلوب. يجب تحديد مهلة زمنية لحجز المنتج. الآن، يجب أن يكون وقت الحجز بعد بدء الرحلة الجوية.

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى، ويتم إنهاؤها بعبارة "s". مثال: "3.5s"
assignmentLeadTime

string (Duration format)

مطلوب. وقت التنفيذ المطلوب لتعيين تصميمات الإعلانات.

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى، ويتم إنهاؤها بعبارة "s". مثال: "3.5s"
minFlightDuration

string (Duration format)

اختياريّ. تمثّل هذه السمة الحد الأدنى لمدة الرحلة الجوية لهذا المنتج.

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى، ويتم إنهاؤها بعبارة "s". مثال: "3.5s"
maxFlightDuration

string (Duration format)

مطلوب. تمثّل هذه السمة الحد الأقصى لمدة الرحلة الجوية لهذا المنتج.

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى، ويتم إنهاؤها بعبارة "s". مثال: "3.5s"
slotDuration

string (Duration format)

مطلوب. مدة الخانة الخاصة بهذا المنتج.

مدة بالثواني مكونة من تسعة أرقام كسور كحد أقصى، ويتم إنهاؤها بعبارة "s". مثال: "3.5s"
createTime

string (Timestamp format)

النتائج فقط. الطابع الزمني لإنشاء المنتج.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

النتائج فقط. تاريخ آخر تعديل للطابع الزمني للمنتج

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
currencyCode

string

تمثّل هذه السمة رمز العملة المكوَّن من 3 أحرف والذي يتم تحديده في ISO 4217.

الطُرق

create

 ينشئ منتجًا جديدًا.

get

 لاسترداد منتج فردي.

list

 يسرد المنتجات.

patch

 تعديل منتج حالي