Method: advertisers.lineItems.bulkUpdate

מעדכנות מספר פריטים.

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

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

בקשת HTTP

POST https://displayvideo.googleapis.com/v3/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.