Method: advertisers.lineItems.generateDefault

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

לא ניתן ליצור או לעדכן פריטים של YouTube ו-Partners באמצעות ה-API.

בקשת HTTP

POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:generateDefault

בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.

פרמטרים של נתיב

פרמטרים
advertiserId

string (int64 format)

חובה. המזהה של המפרסם שאליו שייך הפריט.

גוף הבקשה

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

ייצוג JSON 
{
  "insertionOrderId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "mobileApp": {
    object (MobileApp)
  }
}
שדות
insertionOrderId

string (int64 format)

חובה. המזהה הייחודי של הזמנת הקמפיין שאליה שייך הפריט.
displayName

string

חובה. השם המוצג של הפריט.

חייב להיות בקידוד UTF-8 ובגודל מקסימלי של 240 בייטים.
lineItemType

enum (LineItemType)

חובה. סוג הפריט.
mobileApp

object (MobileApp)

האפליקציה לנייד שהפריט מקדם.

רלוונטי רק כאשר הערך של lineItemType הוא LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL או LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.

גוף התשובה

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

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/display-video

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.