Method: advertisers.lineItems.bulkUpdate

מעדכן כמה פריטים.

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

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

בקשת HTTP

POST https://displayvideo.googleapis.com/v5/advertisers/{advertiserId}/lineItems:bulkUpdate

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

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

פרמטרים
advertiserId

string (int64 format)

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

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "lineItemIds": [
    string
  ],
  "targetLineItem": {
    object (LineItem)
  },
  "updateMask": string
}
שדות
lineItemIds[]

string (int64 format)

חובה. מזהים של פריטים שצריך לעדכן.
targetLineItem

object (LineItem)

חובה. אובייקט של פריט שמכיל את השדות שצריך לעדכן ואת הערכים החדשים שצריך להקצות לכל הפריטים שצוינו ב-lineItemIds."
updateMask

string (FieldMask format)

חובה. מסכת שדות שמזהה אילו שדות לעדכן.

כרגע יש תמיכה רק בשדות הבאים:

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

גוף התשובה

הודעת תגובה ל-LineItemService.BulkUpdateLineItems.

אם הפעולה בוצעה בהצלחה, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "updatedLineItemIds": [
    string
  ],
  "failedLineItemIds": [
    string
  ],
  "skippedLineItemIds": [
    string
  ],
  "errors": [
    {
      object (Status)
    }
  ]
}
שדות
updatedLineItemIds[]

string (int64 format)

המזהים של הפריטים שעודכנו בהצלחה.
failedLineItemIds[]

string (int64 format)

המזהים של הפריטים שלא עודכנו.
skippedLineItemIds[]

string (int64 format)

המזהים של הפריטים שדילגתם על העדכון שלהם. לדוגמה, המערכת תדלג על שינויים מיותרים שלא יגרמו לשינויים בפריטים, ותעקוב אחרי מזהי הפריטים המתאימים כאן.
errors[]

object (Status)

שגיאות שהוחזרו על ידי פריטים שלא עודכנו.

היקפי הרשאות

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

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

ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.