Method: advertisers.lineItems.patch

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

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

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

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של 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.