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.