Method: advertisers.lineItems.generateDefault

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

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

בקשת 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 או קובצי נתונים מובנים.

גוף התשובה

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

היקפי הרשאה

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

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

מידע נוסף זמין במאמר בנושא OAuth 2.0 Overview.