Method: advertisers.lineItems.bulkUpdate
更新多个订单项。
对此端点的请求不能与更新同一订单项的以下请求同时发出:
您无法使用 API 创建或更新 YouTube 及合作伙伴订单项。
HTTP 请求
POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:bulkUpdate
网址采用 gRPC 转码语法。
路径参数
参数 |
advertiserId |
string (int64 format)
必需。此订单项所属广告客户的 ID。
|
请求正文
请求正文中包含结构如下的数据:
JSON 表示法 |
{
"lineItemIds": [
string
],
"targetLineItem": {
object (LineItem )
},
"updateMask": string
} |
字段 |
lineItemIds[] |
string (int64 format)
必需。要更新的订单项的 ID。
|
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)
已成功更新的订单项的 ID。
|
failedLineItemIds[] |
string (int64 format)
未能更新的订单项的 ID。
|
skippedLineItemIds[] |
string (int64 format)
跳过更新的订单项的 ID。例如,系统会跳过会导致订单项实际上没有任何更改的多余更改,并且您可以在此处跟踪相应的订单项 ID。
|
errors[] |
object (Status )
未能更新的订单项返回的错误。
|
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/display-video
如需了解详情,请参阅 OAuth 2.0 Overview。
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-02-25。
[null,null,["最后更新时间 (UTC):2025-02-25。"],[[["Bulk updates multiple existing line items with specified values using a `POST` request."],["Requires providing a list of line item IDs, the target line item object for updates, and an update mask."],["The response indicates successfully updated, failed, and skipped line items, along with any errors encountered."],["YouTube & Partners line items cannot be updated using this endpoint."],["Concurrent requests updating the same line item as other specific operations are not allowed."]]],["This content describes how to update multiple line items via a bulk update operation. This is done through a `POST` HTTP request to a specific endpoint using a required `advertiserId`. The request body must include `lineItemIds` for the items to be updated, a `targetLineItem` object containing the new values, and an `updateMask` specifying which fields to modify. Concurrent updates with specific targeting options or patching requests are restricted. The response indicates which line items were successfully updated, failed, or skipped, and includes any encountered errors. YouTube & Partners line items can't be created or updated using this API.\n"]]