- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- เนื้อหาคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- CreateAdPlayRequest
- ตัวอย่าง
สร้างการเล่นโฆษณาใหม่เป็นกลุ่ม
- จำนวนการเล่นโฆษณาสูงสุดที่อนุญาตในกลุ่มคือ 1,000 ครั้ง
- แสดงการเล่นโฆษณาที่สร้างใหม่หากสำเร็จ
- จะแสดงรหัสข้อผิดพลาด
INVALID_ARGUMENTหากระบุหน่วยโฆษณา คำสั่งซื้อ บรรทัด หรือโฆษณาไม่ถูกต้อง - ส่งคืนรหัสข้อผิดพลาด
ALREADY_EXISTSหากมีการเล่นโฆษณาสำหรับหน่วยโฆษณา ลำดับ บรรทัด และครีเอทีฟโฆษณาเดียวกันที่มีเวลาเริ่มต้นเดียวกันอยู่แล้ว - ส่งคืนรหัสข้อผิดพลาด
NOT_FOUNDหากไม่พบหน่วยโฆษณา คำสั่งซื้อ บรรทัด หรือชิ้นงานครีเอทีฟโฆษณาที่ตรงกัน - แสดงรหัสข้อผิดพลาด
FAILED_PRECONDITIONหากคำขอมีทั้งชื่อทรัพยากรและรหัสภายนอก
คำขอ HTTP
POST https://dv360outofhomeseller.googleapis.com/v1/{parent=sellers/*}/adPlays:batchCreate
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
| พารามิเตอร์ | |
|---|---|
parent |
ต้องระบุ ชื่อทรัพยากรผู้ขาย รูปแบบ: ผู้ขาย/{seller} |
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
| การแสดง JSON |
|---|
{
"requests": [
{
object ( |
| ช่อง | |
|---|---|
requests[] |
ต้องระบุ โฆษณาจะเล่นเพื่อสร้าง จำนวนการเล่นโฆษณาสูงสุดที่อนุญาตในกลุ่มคือ 1,000 ครั้ง เวลาเริ่มต้นควรเป็นเวลาที่ผ่านมาแล้วและสูงสุด 3 วันก่อนวันที่สร้าง เวลาสิ้นสุดควรเป็นเวลาที่ผ่านมาแล้วและหลังจากเวลาเริ่มต้น |
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การตอบสนองสำหรับการสร้างการเล่นโฆษณาเป็นกลุ่ม
| การแสดง JSON |
|---|
{
"adPlays": [
{
object ( |
| ช่อง | |
|---|---|
adPlays[] |
การเล่นโฆษณาที่สร้างขึ้น |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/doubleclickbidmanager
สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0
CreateAdPlayRequest
ข้อความคำขอสำหรับ AdPlayService.CreateAdPlay
| การแสดง JSON |
|---|
{
"parent": string,
"adPlay": {
object ( |
| ช่อง | |
|---|---|
parent |
ต้องระบุ ชื่อทรัพยากรผู้ขาย รูปแบบ: ผู้ขาย/{seller} |
adPlay |
ต้องระบุ โฆษณาจะเล่นเพื่อสร้าง ระบบจะสร้างชื่อการเล่นโฆษณาขึ้นและไม่ควรตั้งค่า เวลาเริ่มต้นควรเป็นเวลาที่ผ่านมาแล้วและสูงสุด 3 วันก่อนวันที่สร้าง เวลาสิ้นสุดควรเป็นเวลาที่ผ่านมาแล้วและหลังจากเวลาเริ่มต้น |