REST Resource: sellers.products

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

منتج واحد.

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

string

تمثّل هذه السمة اسم المورد للمنتج بالتنسيق: sellers/{seller}/products/{product}. على سبيل المثال: sellers/seller111/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)

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

string (Duration format)

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

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

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".
state

enum (State)

النتائج فقط. حالة هذا المنتج.
currencyCode

string

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

الحالة

القيم المحتملة لحالة المنتج

عمليات التعداد
STATE_UNSPECIFIED تشير هذه السمة إلى القيمة التلقائية عندما تكون حالة المنتج غير محدّدة أو غير معروفة في هذا الإصدار.
STATE_ACTIVE المنتج نشط.
STATE_DELETED تم حذف المنتج.

الطُرق

create

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

delete

 حذف منتج حالي

get

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

list

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

patch

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