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à 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 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ã của nhà quảng cáo sở hữu mục hàng này.

Nội dung yêu cầu

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

Biểu diễn dưới dạng JSON 
{
  "insertionOrderId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "mobileApp": {
    object (MobileApp)
  }
}
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 chứa mục hàng.
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 dành cho thiết bị di động được quảng cáo bởi mục hàng.

Đ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.

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 phiên bản 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 bài viết Tổng quan về OAuth 2.0.