Method: advertisers.lineItems.generateDefault

Tạo một mục hàng mới có chế độ cài đặt (bao gồm cả tiêu chí nhắm mục tiêu) 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:

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 chứa 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)
  }
}
Các 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 là mã 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 mục hàng quảng bá.

Điều này chỉ áp dụng khi lineItemTypeLINE_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 Tổng quan về OAuth 2.0.