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)

مورد نیاز. مدت زمان مورد نیاز برای رزرو محصول Now + bookingLeadDuration باید بعد از شروع پرواز باشد.

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' 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 "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

updateTime

string ( Timestamp format)

فقط خروجی آخرین مهر زمانی به روز شده برای محصول.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

state

enum ( State )

فقط خروجی وضعیت این محصول

currencyCode

string

مورد نیاز. کد ارز 3 حرفی بزرگ تعریف شده در ISO 4217.

ایالت

مقادیر ممکن برای وضعیت محصول

Enums
STATE_UNSPECIFIED مقدار پیش‌فرض زمانی که وضعیت محصول در این نسخه مشخص نشده است یا ناشناخته است.
STATE_ACTIVE محصول فعال است
STATE_DELETED محصول حذف می شود.

روش ها

create

 یک محصول جدید ایجاد می کند.

delete

 یک محصول موجود را حذف می کند.

get

 یک محصول جداگانه را بازیابی می کند.

list

 محصولات را فهرست می کند.

patch

 یک محصول موجود را به روز می کند.