Method: advertisers.lineItems.generateDefault

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

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

בקשת HTTP

POST https://displayvideo.googleapis.com/v2/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.