מתבצע עדכון של מספר פריטים.
אי אפשר לשלוח בקשות לנקודת הקצה הזו בו-זמנית עם הבקשות הבאות שמעדכנות את אותו פריט:
lineItems.bulkEditAssignedTargetingOptions
lineItems.patch
assignedTargetingOptions.create
assignedTargetingOptions.delete
לא ניתן ליצור או לעדכן פריטים של YouTube ו-Partner באמצעות ה-API.
בקשת HTTP
POST https://displayvideo.googleapis.com/v2/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.