הפונקציה יוצרת פריט חדש עם ההגדרות (כולל טירגוט) שעברו בירושה מהזמנת הקמפיין וentityStatus
ENTITY_STATUS_DRAFT
. מחזירה את הפריט החדש שנוצר, אם הפעולה בוצעה בהצלחה. יש ערכי ברירת מחדל על סמך שלושת השדות:
- מספר
insertionOrderType
של הזמנת הקמפיין - מספר
automationType
של הזמנת הקמפיין lineItemType
הנתון
לא ניתן ליצור או לעדכן פריטים של YouTube ו-Partners באמצעות ה-API.
בקשת HTTP
POST https://displayvideo.googleapis.com/v3/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.