Method: creatives.create

יצירת קריאייטיב. הפונקציה מחזירה נכס קריאייטיב בשדה response כשהיא מסתיימת בהצלחה, או google.rpc.Code במקרה של כשל. הפונקציה מחזירה את CreateCreativeOperationMetadata, כולל סטטוס הטמעת הנתונים בשדה metadata.

בקשת HTTP

POST https://dai.googleapis.com/v1/creatives

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON
{
  "creative": {
    object (Creative)
  },
  "dynamicCreativeInfo": {
    object (DynamicCreativeInfo)
  }
}
שדות
creative

object (Creative)

הקריאייטיב שרוצים להטמיע.

dynamicCreativeInfo

object (DynamicCreativeInfo)

מידע על הקריאייטיב הדינמי. חובה לציין אם הקריאייטיב שרוצים להטמיע הוא דינמי.

גוף התשובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע חדש של Operation.

DynamicCreativeInfo

מידע הנדרש לקריאייטיב דינמי כדי לבצע עיבוד VCL.

ייצוג ב-JSON
{
  "dynamicGroupId": string,
  "activeDuration": string
}
שדות
dynamicGroupId

string

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

activeDuration

string (Duration format)

משך הזמן שבו הקריאייטיב נחשב לפעיל ולשימוש. לאחר פרק הזמן הזה, הקריאייטיב ימוחק במאגר הקריאייטיב של הווידאו. משך הזמן המקסימלי הוא 180 ימים. אם השדה הזה לא יצוין, ייקבע לו משך זמן ברירת מחדל של 30 יום.

משך הזמן בשניות, עם עד תשע ספרות עשרוניות, שמסתיימים ב-'s'. דוגמה: "3.5s".