Method: advertisers.lineItems.bulkUpdate

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

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

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של 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)

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

object (Status)

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

היקפי הרשאה

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

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

למידע נוסף, ראו סקירה כללית על OAuth 2.0.