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)

חובה. משך הליד נדרש להזמנת המוצר. עכשיו הערך בשדה 'משך הזמן להשארת פרטים' צריך להיות אחרי תחילת הטיסה.

משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-'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.

מדינה

ערכים אפשריים למצב המוצר.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED ערך ברירת המחדל כשמצב המוצר לא מצוין או לא ידוע בגרסה הזו.
STATE_ACTIVE המוצר פעיל.
STATE_DELETED המוצר נמחק.

שיטות

create

יצירת מוצר חדש.

delete

מחיקת מוצר קיים.

get

מאחזרים מוצר בודד.

list

מציגה מוצרים.

patch

מעדכן מוצר קיים.