Method: advertisers.sdfuploadtasks.upload

สร้างงานการอัปโหลด SDF แสดงผล Operation

งานอัปโหลด SDF เป็นการดำเนินการแบบอะซิงโครนัสที่ใช้เวลานาน metadata ประเภทของการดำเนินการนี้คือ SdfUploadTaskMetadata หากคำขอสำเร็จ response ประเภทของการดำเนินการคือ SdfUploadTask การตอบกลับจะไม่รวมไฟล์ที่ได้ ซึ่งจะเรียกดูได้โดยใช้ media.download

เรียกดูสถานะการดำเนินการได้โดยใช้ sdfuploadtask.operations.get

คุณดูข้อผิดพลาดได้ใน error.message โปรดทราบว่า error.details ควรว่างเปล่า

คำขอ HTTP

  • URI การอัปโหลดสำหรับคำขออัปโหลดสื่อ:
    POST https://displayvideo.googleapis.com/upload/v4/advertisers/{advertiserId}/sdfuploadtasks
  • URI ข้อมูลเมตาสำหรับคำขอข้อมูลเมตาเท่านั้น
    POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/sdfuploadtasks

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
advertiserId

string (int64 format)

ต้องระบุ รหัสของผู้ลงโฆษณาที่จะอัปโหลด SDF

เนื้อความของคำขอ

เนื้อความของคำขอมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON 
{
  "filename": string,
  "sdfVersion": enum (SdfVersion)
}
ช่อง
filename

string

ต้องระบุ ชื่อไฟล์ของเนื้อหา รวมถึงนามสกุลไฟล์ ชื่อไฟล์ต้องเข้ารหัส UTF-8 และมีขนาดใหญ่ได้สูงสุด 240 ไบต์
sdfVersion

enum (SdfVersion)

ต้องระบุ เวอร์ชัน SDF ของไฟล์ที่อัปโหลด หากตั้งค่าเป็น SDF_VERSION_UNSPECIFIED ระบบจะใช้เวอร์ชันที่ผู้ลงโฆษณาที่ระบุไว้ระบุไว้เป็นค่าเริ่มต้น ผู้ลงโฆษณาจะได้รับเวอร์ชัน SDF มาจากพาร์ทเนอร์ เว้นแต่จะมีการกําหนดค่าไว้เป็นอย่างอื่น

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ Operation

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/display-video

ดูข้อมูลเพิ่มเติมได้ที่ OAuth 2.0 Overview