Method: advertisers.lineItems.generateDefault

使用继承自广告订单的设置(包括定位)和 ENTITY_STATUS_DRAFT entityStatus 创建一个新订单项。如果成功,则返回新创建的订单项。以下是基于这三个字段的默认值:

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

HTTP 请求

POST https://displayvideo.googleapis.com/v3/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 概览