Method: advertisers.lineItems.bulkUpdate

עדכון של כמה פריטים.

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

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של gRPC Transcoding.

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

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