Mulai
8 September 2025, setiap item baris baru harus menyatakan apakah item baris tersebut akan menayangkan iklan politik Uni Eropa (EU) atau tidak. Upload SDF dan API Display & Video 360 yang tidak memberikan pernyataan akan gagal. Lihat
halaman penghentian penggunaan kami untuk mengetahui detail selengkapnya tentang cara memperbarui integrasi Anda untuk membuat pernyataan ini.
Method: advertisers.lineItems.bulkUpdate
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Memperbarui beberapa item baris.
Permintaan ke endpoint ini tidak dapat dilakukan secara bersamaan dengan permintaan berikut yang memperbarui item baris yang sama:
Item baris YouTube & Partner tidak dapat dibuat atau diperbarui menggunakan API.
Permintaan HTTP
POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/lineItems:bulkUpdate
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
| Parameter |
advertiserId |
string (int64 format)
Wajib. ID pengiklan yang memiliki item baris ini.
|
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
| Representasi JSON |
{
"lineItemIds": [
string
],
"targetLineItem": {
object (LineItem)
},
"updateMask": string
} |
| Kolom |
lineItemIds[] |
string (int64 format)
Wajib. ID item baris yang akan diperbarui.
|
targetLineItem |
object (LineItem)
Wajib. Objek item baris yang berisi kolom yang akan diperbarui dan nilai baru yang akan ditetapkan ke semua item baris yang ditentukan dalam lineItemIds."
|
updateMask |
string (FieldMask format)
Wajib. Mask kolom yang mengidentifikasi kolom yang akan diperbarui. Saat ini hanya kolom berikut yang didukung:
Ini adalah comma-separated list berisi nama kolom yang sepenuhnya memenuhi syarat. Contoh: "user.displayName,photo".
|
Isi respons
Pesan respons untuk LineItemService.BulkUpdateLineItems.
Jika berhasil, isi respons memuat data dengan struktur berikut:
| Representasi JSON |
{
"updatedLineItemIds": [
string
],
"failedLineItemIds": [
string
],
"skippedLineItemIds": [
string
],
"errors": [
{
object (Status)
}
]
} |
| Kolom |
updatedLineItemIds[] |
string (int64 format)
ID item baris yang berhasil diperbarui.
|
failedLineItemIds[] |
string (int64 format)
ID item baris yang gagal diperbarui.
|
skippedLineItemIds[] |
string (int64 format)
ID item baris yang dilewati untuk update. Misalnya, mutasi yang tidak perlu yang tidak akan menghasilkan perubahan pada item baris akan dilewati dan ID item baris yang sesuai dapat dilacak di sini.
|
errors[] |
object (Status)
Error yang ditampilkan oleh item baris yang gagal diperbarui.
|
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/display-video
Untuk mengetahui informasi selengkapnya, lihat OAuth 2.0 Overview.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-08-21 UTC.
[null,null,["Terakhir diperbarui pada 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)."]]
