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 Overview.