מעדכן פריט קיים. אם הפעולה בוצעה בהצלחה, הפונקציה מחזירה את פריט העלויות המעודכן.
לא ניתן לשלוח בקשות לנקודת הקצה הזו בו-זמנית עם הבקשות הבאות שמעדכנות את אותו פריט:
lineItems.bulkEditAssignedTargetingOptions
lineItems.bulkUpdate
assignedTargetingOptions.create
assignedTargetingOptions.delete
לא ניתן ליצור או לעדכן פריטי YouTube ושותפים באמצעות ה-API.
זמן האחזור של השיטה הזו ארוך באופן קבוע. כדי למנוע שגיאות, מומלץ להגדיל את זמן הקצאת הזמן שמוגדר כברירת מחדל.
בקשת HTTP
PATCH https://displayvideo.googleapis.com/v3/advertisers/{lineItem.advertiserId}/lineItems/{lineItem.lineItemId}
כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
line |
פלט בלבד. המזהה הייחודי של המפרסם שאליו שייך הפריט. |
line |
פלט בלבד. המזהה הייחודי של הפריט. המערכת מקצה את השם. |
פרמטרים של שאילתה
פרמטרים | |
---|---|
update |
חובה. המסכה שמאפשרת לקבוע אילו שדות יעודכנו. זוהי רשימה של שמות שדות מוגדרים במלואם, שמופרדים בפסיקים. דוגמה: |
גוף הבקשה
גוף הבקשה מכיל מופע של LineItem
.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של LineItem
.
היקפי הרשאה
נדרש היקף הרשאות OAuth הבא:
https://www.googleapis.com/auth/display-video
למידע נוסף, ראו סקירה כללית על OAuth 2.0.