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)

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

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

currencyCode

string

קוד מטבע באותיות רישיות בן 3 אותיות שמוגדר בתקן ISO 4217.

שיטות

create

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

get

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

list

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

patch

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