Method: advertisers.lineItems.bulkUpdate

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

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

YouTube ו- אי אפשר ליצור או לעדכן פריטי שותפים באמצעות ה-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.