יצירת פריט חדש עם הגדרות (כולל טירגוט) שעברו בירושה מהזמנת הקמפיין ו-entityStatus
של ENTITY_STATUS_DRAFT
. מחזירה את הפריט החדש שנוצר, אם הפעולה בוצעה בהצלחה. יש ערכי ברירת מחדל על סמך שלושת השדות:
insertionOrderType
של הזמנת הקמפייןautomationType
של הזמנת הקמפייןlineItemType
הנתון
לא ניתן ליצור או לעדכן פריטים של YouTube ו-Partner באמצעות ה-API.
בקשת HTTP
POST https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/lineItems:generateDefault
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
advertiserId |
חובה. המזהה של המפרסם שאליו שייך הפריט. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "insertionOrderId": string, "displayName": string, "lineItemType": enum ( |
שדות | |
---|---|
insertionOrderId |
חובה. המזהה הייחודי של הזמנת הקמפיין שאליה שייך הפריט. |
displayName |
חובה. השם המוצג של הפריט. חייב להיות בקידוד UTF-8 ובגודל מקסימלי של 240 בייטים. |
lineItemType |
חובה. סוג הפריט. |
mobileApp |
האפליקציה לנייד שהפריט מקדם. הדבר רלוונטי רק כאשר |
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה מכיל מופע של LineItem
.
היקפי הרשאות
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/display-video
למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.