- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi cấp phép
- CreateAdPlayRequest
- Ví dụ
Tạo hàng loạt lượt phát quảng cáo mới.
- Số lần phát quảng cáo tối đa trong một lô là 1.000 lần.
- Trả về các lượt phát quảng cáo mới tạo nếu thành công.
- Trả về mã lỗi
INVALID_ARGUMENTnếu đã chỉ định đơn vị quảng cáo, đơn đặt hàng, dòng hoặc mẫu quảng cáo không hợp lệ. - Trả về mã lỗi
ALREADY_EXISTSnế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_FOUNDnếu không tìm thấy đơn vị quảng cáo, đơn đặt hàng, dòng hoặc thành phần mẫu quảng cáo phù hợp. - Trả về mã lỗi
FAILED_PRECONDITIONnếu yêu cầu chứa cả tên tài nguyên và mã nhận dạng bên ngoài.
Yêu cầu HTTP
POST https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adPlays:batchCreate
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Tham số | |
|---|---|
parent |
Bắt buộc. Tên tài nguyên của người bán. Định dạng: người bán/{seller} |
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 |
|---|
{
"requests": [
{
object ( |
| Trường | |
|---|---|
requests[] |
Bắt buộc. Quảng cáo sẽ phát để tạo. Số lần phát quảng cáo tối đa trong một lô là 1.000 lần. Thời gian bắt đầu phải nằm trong quá khứ và tối đa 3 ngày trước ngày tạo. Thời gian kết thúc phải nằm trong quá khứ và sau thời gian bắt đầu. |
Nội dung phản hồi
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Phản hồi để tạo lượt phát quảng cáo hàng loạt.
| Biểu diễn dưới dạng JSON |
|---|
{
"adPlays": [
{
object ( |
| Trường | |
|---|---|
adPlays[] |
Quảng cáo phát đã được tạo. |
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.
CreateAdPlayRequest
Thông báo yêu cầu cho AdPlayService.CreateAdPlay.
| Biểu diễn dưới dạng JSON |
|---|
{
"parent": string,
"adPlay": {
object ( |
| Trường | |
|---|---|
parent |
Bắt buộc. Tên tài nguyên của người bán. Định dạng: người bán/{seller} |
adPlay |
Bắt buộc. Phát quảng cáo để tạo. Tên phát quảng cáo sẽ do hệ thống tạo và không được đặt. Thời gian bắt đầu phải nằm trong quá khứ và tối đa 3 ngày trước ngày tạo. Thời gian kết thúc phải nằm trong quá khứ và sau thời gian bắt đầu. |