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