Method: advertisers.lineItems.generateDefault

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

YouTube ו- אי אפשר ליצור או לעדכן פריטי שותפים באמצעות ה-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.