החל מ-
8 בספטמבר 2025, בכל פריט חדש צריך להצהיר אם הוא יציג מודעות פוליטיות באיחוד האירופי (EU) או לא. העלאות של קובצי SDF ושל Display & Video 360 API שלא כוללות הצהרות ייכשלו. מידע נוסף על אופן העדכון של האינטגרציה כדי להוסיף את ההצהרה הזו זמין ב
דף ההוצאה משימוש.
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.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-21 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-21 (שעון UTC)."],[],["The Display & Video 360 API v4, in beta, allows bulk updates of multiple line items via a POST request to a specific URL, using gRPC Transcoding syntax. Requests require an advertiser ID and specify `lineItemIds`, `targetLineItem` data, and an `updateMask` in the request body, which is in JSON format. The response indicates successful, failed, or skipped updates and returns respective line item IDs. Specific updates on a same item cannot be concurrent, and YouTube & Partners line items are not supported.\n"],null,["# Method: advertisers.lineItems.bulkUpdate\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.BulkUpdateLineItemsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUpdates multiple line items.\n\nRequests to this endpoint cannot be made concurrently with the following requests updating the same line item:\n\n- [lineItems.bulkEditAssignedTargetingOptions](/display-video/api/reference/rest/v4/advertisers.lineItems/bulkEditAssignedTargetingOptions#google.ads.displayvideo.v4.LineItemAssignedTargetingOptionsService.BulkEditAssignedTargetingOptions)\n- [lineItems.patch](/display-video/api/reference/rest/v4/advertisers.lineItems/patch#google.ads.displayvideo.v4.LineItemService.UpdateLineItem)\n- [assignedTargetingOptions.create](/display-video/api/reference/rest/v4/advertisers.lineItems.targetingTypes.assignedTargetingOptions/create#google.ads.displayvideo.v4.LineItemAssignedTargetingOptionsService.CreateLineItemAssignedTargetingOption)\n- [assignedTargetingOptions.delete](/display-video/api/reference/rest/v4/advertisers.lineItems.targetingTypes.assignedTargetingOptions/delete#google.ads.displayvideo.v4.LineItemAssignedTargetingOptionsService.DeleteLineItemAssignedTargetingOption)\n\nYouTube \\& Partners line items cannot be created or updated using the API.\n\n### HTTP request\n\n`POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/lineItems:bulkUpdate`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------|\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the advertiser this line item belongs to. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"lineItemIds\": [ string ], \"targetLineItem\": { object (/display-video/api/reference/rest/v4/advertisers.lineItems#LineItem) }, \"updateMask\": string } ``` |\n\n| Fields ||\n|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `lineItemIds[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. IDs of line items to update. |\n| `targetLineItem` | `object (`[LineItem](/display-video/api/reference/rest/v4/advertisers.lineItems#LineItem)`)` Required. A line item object containing the fields to be updated and the new values to assign to all line items specified in [lineItemIds](/display-video/api/reference/rest/v4/advertisers.lineItems/bulkUpdate#body.request_body.FIELDS.line_item_ids).\" |\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Required. A field mask identifying which fields to update. Only the following fields are currently supported: - [entityStatus](/display-video/api/reference/rest/v4/advertisers.lineItems#LineItem.FIELDS.entity_status) - [containsEuPoliticalAds](/display-video/api/reference/rest/v4/advertisers.lineItems#LineItem.FIELDS.contains_eu_political_ads) This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\n### Response body\n\nResponse message for LineItemService.BulkUpdateLineItems.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"updatedLineItemIds\": [ string ], \"failedLineItemIds\": [ string ], \"skippedLineItemIds\": [ string ], \"errors\": [ { object (/display-video/api/reference/rest/v4/sdfdownloadtasks.operations#Operation.Status) } ] } ``` |\n\n| Fields ||\n|------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `updatedLineItemIds[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The IDs of successfully updated line items. |\n| `failedLineItemIds[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The IDs of line items that failed to update. |\n| `skippedLineItemIds[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The IDs of line items that are skipped for updates. For example, unnecessary mutates that will result in effectively no changes to line items will be skipped and corresponding line item IDs can be tracked here. |\n| `errors[]` | `object (`[Status](/display-video/api/reference/rest/v4/sdfdownloadtasks.operations#Operation.Status)`)` Errors returned by line items that failed to update. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/display-video`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
