Method: advertisers.lineItems.generateDefault

Tạo một mục hàng mới có các chế độ cài đặt (bao gồm cả tiêu chí nhắm mục tiêu) được kế thừa từ đơn đặt hàng quảng cáo và một ENTITY_STATUS_DRAFT entityStatus. Trả về mục hàng mới tạo nếu thành công. Có các giá trị mặc định dựa trên 3 trường sau:

Bạn không thể tạo hoặc cập nhật mục hàng của YouTube và đối tác bằng API.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
advertiserId

string (int64 format)

Bắt buộc. Mã nhận dạng của nhà quảng cáo mà mục hàng này thuộc về.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu với cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "insertionOrderId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "mobileApp": {
    object (MobileApp)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
Trường
insertionOrderId

string (int64 format)

Bắt buộc. Mã nhận dạng duy nhất của đơn đặt hàng quảng cáo mà mục hàng thuộc về.
displayName

string

Bắt buộc. Tên hiển thị của mục hàng.

Phải được mã hoá UTF-8 với kích thước tối đa là 240 byte.
lineItemType

enum (LineItemType)

Bắt buộc. Loại mục hàng.
mobileApp

object (MobileApp)

Ứng dụng di động được mục hàng quảng bá.

Điều này chỉ áp dụng khi lineItemType là LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL hoặc LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Liệu mục hàng này có phân phát quảng cáo chính trị ở Liên minh Châu Âu hay không.

Nếu containsEuPoliticalAds được đặt thành DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING trong nhà quảng cáo chính, thì trường này sẽ được chỉ định DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING nếu không được chỉ định khác. Sau đó, bạn có thể cập nhật trường này bằng giao diện người dùng, API hoặc tệp dữ liệu có cấu trúc.

Bạn phải chỉ định trường này khi tạo một mục hàng mới. Nếu không, yêu cầu advertisers.lineItems.create sẽ không thành công.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể của LineItem.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.