Method: adPlays.createWithExternalIds

Tạo một lượt phát quảng cáo có mã nhận dạng bên ngoài.

  • Trả về lượt phát quảng cáo mới tạo nếu thành công.
  • Trả về mã lỗi INVALID_ARGUMENT nếu đã chỉ định mã nhận dạng bên ngoài của đơn vị quảng cáo, mã nhận dạng bên ngoài của đơn đặt hàng, mã nhận dạng bên ngoài của dòng hoặc mã bên ngoài của thành phần mẫu quảng cáo.
  • Trả về mã lỗi INVALID_ARGUMENT nếu quảng cáo phát cho cùng một đơn vị quảng cáo, đơn đặt hàng, dòng và mẫu quảng cáo có cùng thời gian bắt đầu đã tồn tại.
  • Trả về mã lỗi NOT_FOUND nếu không tìm thấy mã nhận dạng bên ngoài của đơn vị quảng cáo phù hợp, mã nhận dạng bên ngoài của đơn đặt hàng, mã nhận dạng bên ngoài của dòng hoặc mã nhận dạng bên ngoài của thành phần mẫu quảng cáo.

Yêu cầu HTTP

POST https://dv360outofhomeseller.googleapis.com/v1beta1/adPlays:createWithExternalIds

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

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 
{
  "lineExternalId": string,
  "orderExternalId": string,
  "adUnitExternalId": string,
  "creativeAssetExternalId": string,
  "startTime": string,
  "endTime": string,
  "recordTime": string,
  "impressions": number
}
Trường
lineExternalId

string

Bắt buộc. Mã bên ngoài của dòng chứa quảng cáo này. Định dạng: 123.
orderExternalId

string

Bắt buộc. Mã bên ngoài của thứ tự phát quảng cáo này. Định dạng: 456.
adUnitExternalId

string

Bắt buộc. Mã bên ngoài của đơn vị quảng cáo mà lần phát quảng cáo này được phân phát trên đó. Định dạng: 789.
creativeAssetExternalId

string

Bắt buộc. Mã bên ngoài của mẫu quảng cáo mà lần phát quảng cáo này phân phát. Định dạng: 3210.
startTime

string (Timestamp format)

Bắt buộc. Thời gian quảng cáo bắt đầu phát (bao gồm cả thời gian này). Phải là trong quá khứ và trong vòng 3 ngày qua.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

Bắt buộc. Thời gian kết thúc phát quảng cáo (loại trừ). Phải nằm trong quá khứ và sau thời gian bắt đầu.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
recordTime

string (Timestamp format)

Không bắt buộc. Thời gian ghi lại lượt phát quảng cáo này. Phải là trong quá khứ và sau thời gian kết thúc.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
impressions

number

Bắt buộc. Tổng số lượt hiển thị.

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

Phạm vi cấp phép

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

  • https://www.googleapis.com/auth/doubleclickbidmanager

Để biết thêm thông tin, hãy xem bài viết Tổng quan về OAuth 2.0.