Method: advertisers.lineItems.patch

מעדכן פריט קיים. אם הפעולה בוצעה בהצלחה, הפונקציה מחזירה את פריט העלויות המעודכן.

לא ניתן לשלוח בקשות לנקודת הקצה הזו בו-זמנית עם הבקשות הבאות שמעדכנות את אותו פריט:

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

זמן האחזור של השיטה הזו ארוך באופן קבוע. כדי למנוע שגיאות, מומלץ להגדיל את זמן הקצאת הזמן שמוגדר כברירת מחדל.

בקשת HTTP

PATCH https://displayvideo.googleapis.com/v3/advertisers/{lineItem.advertiserId}/lineItems/{lineItem.lineItemId}

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

פרמטרים של נתיב

פרמטרים
lineItem.advertiserId

string (int64 format)

פלט בלבד. המזהה הייחודי של המפרסם שאליו שייך הפריט.

lineItem.lineItemId

string (int64 format)

פלט בלבד. המזהה הייחודי של הפריט. המערכת מקצה את השם.

פרמטרים של שאילתה

פרמטרים
updateMask

string (FieldMask format)

חובה. המסכה שמאפשרת לקבוע אילו שדות יעודכנו.

זוהי רשימה של שמות שדות מוגדרים במלואם, שמופרדים בפסיקים. דוגמה: "user.displayName,photo"

גוף הבקשה

גוף הבקשה מכיל מופע של LineItem.

גוף התשובה

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

היקפי הרשאה

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

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

למידע נוסף, ראו סקירה כללית על OAuth 2.0.