Method: advertisers.lineItems.generateDefault

创建一个新的订单项,并为其采用继承自广告订单的设置(包括定位)和 ENTITY_STATUS_DRAFT entityStatus。如果成功,则返回新创建的订单项。这三个字段具有默认值:

无法使用该 API 创建或更新 YouTube 及合作伙伴订单项。

HTTP 请求

POST https://displayvideo.googleapis.com/v2/advertisers/{advertiserId}/lineItems:generateDefault

网址采用 gRPC 转码语法。

路径参数

参数
advertiserId

string (int64 format)

必需。此订单项所属广告客户的 ID。

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "insertionOrderId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "mobileApp": {
    object (MobileApp)
  }
}
字段
insertionOrderId

string (int64 format)

必需。订单项所属广告订单的唯一 ID。

displayName

string

必需。订单项的显示名称。

必须采用 UTF-8 编码,大小上限为 240 个字节。

lineItemType

enum (LineItemType)

必需。订单项的类型。

mobileApp

object (MobileApp)

订单项所宣传的移动应用。

这仅在 lineItemTypeLINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALLLINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL 时适用。

响应正文

如果成功,则响应正文包含一个 LineItem 实例。

授权范围

需要以下 OAuth 作用域:

  • https://www.googleapis.com/auth/display-video

有关详情,请参阅 OAuth 2.0 概览