Method: advertisers.lineItems.generateDefault

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

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

בקשת HTTP

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