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 + bookLeadDuration ควรอยู่หลังเริ่มเที่ยวบิน

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก สิ้นสุดด้วย "s" ตัวอย่างเช่น "3.5s"
assignmentLeadDuration

string (Duration format)

ต้องระบุ ต้องระบุระยะเวลาของโอกาสในการขายเพื่อกำหนดครีเอทีฟโฆษณา

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก สิ้นสุดด้วย "s" ตัวอย่างเช่น "3.5s"
minFlightDuration

string (Duration format)

ระยะเวลาบินขั้นต่ำสำหรับผลิตภัณฑ์นี้

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก สิ้นสุดด้วย "s" ตัวอย่างเช่น "3.5s"
maxFlightDuration

string (Duration format)

ต้องระบุ ระยะเวลาบินสูงสุดสำหรับผลิตภัณฑ์นี้

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก สิ้นสุดด้วย "s" ตัวอย่างเช่น "3.5s"
slotDuration

string (Duration format)

ต้องระบุ ระยะเวลาของสล็อตสำหรับผลิตภัณฑ์นี้

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก สิ้นสุดด้วย "s" ตัวอย่างเช่น "3.5s"
createTime

string (Timestamp format)

เอาต์พุตเท่านั้น การประทับเวลาการสร้างผลิตภัณฑ์

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
updateTime

string (Timestamp format)

เอาต์พุตเท่านั้น การประทับเวลาที่อัปเดตล่าสุดสำหรับผลิตภัณฑ์

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"
state

enum (State)

เอาต์พุตเท่านั้น สถานะของผลิตภัณฑ์นี้
currencyCode

string

ต้องระบุ รหัสสกุลเงินตัวพิมพ์ใหญ่ 3 ตัวอักษรที่กำหนดไว้ใน ISO 4217

รัฐ

ค่าที่เป็นไปได้สำหรับสถานะผลิตภัณฑ์

Enum
STATE_UNSPECIFIED ค่าเริ่มต้นเมื่อไม่ได้ระบุสถานะผลิตภัณฑ์หรือไม่รู้จักในเวอร์ชันนี้
STATE_ACTIVE ผลิตภัณฑ์อยู่ในสถานะใช้งานอยู่
STATE_DELETED ลบผลิตภัณฑ์แล้ว

เมธอด

create

 สร้างผลิตภัณฑ์ใหม่

delete

 ลบผลิตภัณฑ์ที่มีอยู่

get

 เรียกข้อมูลผลิตภัณฑ์แต่ละรายการ

list

 แสดงรายการผลิตภัณฑ์

patch

 อัปเดตผลิตภัณฑ์ที่มีอยู่