Method: advertisers.lineItems.patch

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

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

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

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

בקשת HTTP

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

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

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

פרמטרים
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 Overview.