Method: advertisers.lineItems.generateDefault

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

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

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

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

פרמטרים
advertiserId

string (int64 format)

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

גוף הבקשה

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

ייצוג ב-JSON 
{
  "insertionOrderId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "mobileApp": {
    object (MobileApp)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
שדות
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.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

האם הפריט הזה ישמש להצגת מודעות שקשורות לפוליטיקה באיחוד האירופי.

אם הערך של containsEuPoliticalAds הוגדר ל-DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING במפרסם הראשי ולא צוין ערך אחר, השדה הזה יקבל את הערך DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING. אחר כך אפשר לעדכן את השדה הזה באמצעות ממשק המשתמש, ה-API או קבצים של נתונים מובנים.

צריך להקצות את השדה הזה כשיוצרים פריט חדש. אחרת, בקשת ה-advertisers.lineItems.create תיכשל.

גוף התשובה

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

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.