Method: advertisers.lineItems.generateDefault

Tạo 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 sau:

YouTube và Không thể tạo hoặc cập nhật mục hàng Đối tác bằng API.

Yêu cầu HTTP

POST https://displayvideo.googleapis.com/v2/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 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)
  }
}
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 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 bài viết Tổng quan về OAuth 2.0.