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)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
字段
insertionOrderId

string (int64 format)

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

string

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

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

enum (LineItemType)

必需。相应订单项的类型。
mobileApp

object (MobileApp)

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

仅当 lineItemType 为 LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL 或 LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL 时适用。
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

相应订单项是否会投放欧盟政治广告。

如果父广告客户中的 containsEuPoliticalAds 已设置为 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING，则除非另行指定，否则此字段将被分配 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING。然后，您可以使用界面、API 或结构化数据文件更新此字段。

创建新订单项时，必须分配此字段。否则，advertisers.lineItems.create 请求将失败。

响应正文

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

授权范围

需要以下 OAuth 范围：

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

如需了解详情，请参阅 OAuth 2.0 Overview。