С
8 сентября 2025 года в каждой новой позиции необходимо будет указывать, будет ли она показывать политическую рекламу Европейского союза (ЕС). Загрузки через Display & Video 360 API и SDF без таких указаний будут отклонены. Подробнее о том, как обновить интеграцию и указать это указание, см.
на странице «Устаревшие функции».
Method: advertisers.lineItems.bulkUpdate
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Обновляет несколько позиций.
Запросы к этой конечной точке не могут быть выполнены одновременно со следующими запросами, обновляющими ту же позицию:
Позиции YouTube и партнеров нельзя создавать или обновлять с помощью API.
HTTP-запрос
POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/lineItems:bulkUpdate
URL использует синтаксис перекодировки 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) Идентификаторы позиций, пропущенных при обновлении. Например, ненужные мутации, которые фактически не приведут к изменению позиций, будут пропущены, и соответствующие идентификаторы позиций можно отслеживать здесь. |
errors[] | object ( Status ) Ошибки, возвращаемые позициями, которые не удалось обновить. |
Области авторизации
Требуется следующая область OAuth:
-
https://www.googleapis.com/auth/display-video
Для получения более подробной информации см.OAuth 2.0 Overview .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. 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)."]]
