Method: advertisers.lineItems.bulkUpdate

מתבצע עדכון של מספר פריטים.

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

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

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

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

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