מעדכנות מספר פריטים.
אי אפשר לשלוח בקשות לנקודת הקצה הזאת בו-זמנית עם הבקשות הבאות שמעדכנות את אותו פריט:
lineItems.bulkEditAssignedTargetingOptions
lineItems.patch
assignedTargetingOptions.create
assignedTargetingOptions.delete
לא ניתן ליצור או לעדכן פריטים של YouTube ו-Partners באמצעות ה-API.
בקשת HTTP
POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:bulkUpdate
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
advertiserId |
חובה. המזהה של המפרסם שאליו שייך הפריט. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"lineItemIds": [
string
],
"targetLineItem": {
object ( |
שדות | |
---|---|
lineItemIds[] |
חובה. מזהים של פריטים לעדכון. |
targetLineItem |
חובה. אובייקט של פריט שמכיל את השדות לעדכון והערכים החדשים להקצאה לכל הפריטים שצוינו ב- |
updateMask |
חובה. אנונימיזציה של שדות שמציינת אילו שדות צריך לעדכן. כרגע יש תמיכה רק בשדות הבאים: זוהי רשימה של שמות שדות מלאים, שמופרדים בפסיקים. דוגמה: |
גוף התשובה
הודעת תגובה עבור LineItemService.BulkUpdateLineItems.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"updatedLineItemIds": [
string
],
"failedLineItemIds": [
string
],
"skippedLineItemIds": [
string
],
"errors": [
{
object ( |
שדות | |
---|---|
updatedLineItemIds[] |
המזהים של הפריטים שעודכנו בהצלחה. |
failedLineItemIds[] |
המזהים של הפריטים שהעדכון שלהם נכשל. |
skippedLineItemIds[] |
המזהים של הפריטים שהמערכת מדלגת עליהם לצורך עדכון. לדוגמה, המערכת תדלג על שינויים מיותרים שיובילו בפועל לשינויים בפריטים, וכאן אפשר לעקוב אחר מזהי הפריטים התואמים. |
errors[] |
שגיאות שהוחזרו על ידי פריטים שהעדכון שלהם נכשל. |
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/display-video
למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.