Method: advertisers.lineItems.generateDefault

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

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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 Overview.