อัปโหลดสื่อ

ฟีเจอร์การอัปโหลดสื่อช่วยให้คุณจัดเก็บข้อมูลที่ใช้ใน Display & Video 360 ได้ ข้อมูลที่ผู้ใช้อาจต้องการอัปโหลด ได้แก่ รูปภาพ วิดีโอ ไฟล์ ZIP ฯลฯ

ตัวเลือกการอัปโหลด

API ของ Display & Video 360 ช่วยให้คุณอัปโหลดข้อมูลไบนารีหรือสื่อบางประเภทได้ ลักษณะของข้อมูลที่คุณอัปโหลดได้มีรายละเอียดอยู่ในคู่มือสำหรับนักพัฒนาซอฟต์แวร์ สำหรับงานที่ต้องมีการอัปโหลดสื่อ

ขนาดไฟล์สูงสุดที่อัปโหลดได้: ปริมาณข้อมูลสูงสุดที่คุณจัดเก็บได้ด้วย วิธีนี้
ประเภท MIME ของสื่อที่ยอมรับ: ประเภทของข้อมูลไบนารีที่คุณจัดเก็บได้โดยใช้วิธีนี้

คุณส่งคำขออัปโหลดได้ด้วยวิธีใดวิธีหนึ่งต่อไปนี้ ระบุวิธีการ ที่คุณใช้กับพารามิเตอร์ uploadType

อัปโหลดง่ายๆ: uploadType=media การโอนไฟล์ขนาดประมาณ 5 MB หรือน้อยกว่าได้อย่างรวดเร็ว
การอัปโหลดแบบหลายส่วน: uploadType=multipart การโอนไฟล์และข้อมูลเมตาที่เกี่ยวข้องอย่างรวดเร็ว โอนไฟล์และข้อมูลเมตาในคำขอเดียว

เมื่ออัปโหลดสื่อ คุณจะใช้ /uploadURI ใช้ URI นี้เมื่อโอน ข้อมูลสื่อเอง

ตัวอย่าง

  POST /upload/media/resource-name

อัปโหลดง่ายๆ

คำขออัปโหลดแบบง่ายเป็นวิธีที่ตรงไปตรงมาที่สุดในการอัปโหลดไฟล์ ตัวเลือกนี้เหมาะสำหรับกรณีต่อไปนี้

ไฟล์มีขนาดเล็กพอที่จะอัปโหลดอีกครั้งได้ หากจำเป็น
ไม่มีข้อมูลเมตาที่จะส่ง ซึ่งอาจเป็นจริงหากไม่จำเป็นต้องใช้ข้อมูลเมตา หรือรวมอยู่ในคำขอที่อื่น

หากต้องการใช้การอัปโหลดอย่างง่าย ให้ส่งคำขอ POST หรือ PUT ไปยัง /upload URI ของเมธอด แล้วเพิ่มพารามิเตอร์การค้นหา uploadType=media เช่น

  POST https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media

ส่วนหัว HTTP ที่จะใช้เมื่อทำการอัปโหลดอย่างง่ายมีดังนี้

Content-Type. ตั้งค่าเป็นประเภทข้อมูลสื่อที่ยอมรับของวิธีการ
Content-Length ตั้งค่าเป็นจำนวนไบต์ที่คุณอัปโหลด ไม่จำเป็น หากคุณใช้การเข้ารหัสการโอนแบบเป็นกลุ่ม

การอัปโหลดแบบหลายส่วน

หากมีข้อมูลเมตาที่จะส่งพร้อมกับข้อมูลที่จะอัปโหลด คุณสามารถส่งmultipart/relatedคำขอได้ ตัวเลือกนี้เหมาะสำหรับกรณีที่ข้อมูลที่คุณส่งมีขนาดเล็กพอที่จะอัปโหลดอีกครั้งได้หากจำเป็น

หากต้องการใช้การอัปโหลดหลายส่วน ให้ส่งคำขอ POST หรือ PUT ไปยัง URI ของเมธอด /upload แล้วเพิ่มพารามิเตอร์การค้นหา uploadType=multipart เช่น

  POST https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart

ส่วนหัว HTTP ระดับบนสุดที่จะใช้เมื่อส่งคำขออัปโหลดแบบหลายส่วน ประกอบด้วย

Content-Type ตั้งค่าเป็น multipart/related และรวมสตริงขอบเขต ที่คุณใช้เพื่อระบุส่วนต่างๆ ของคำขอ
Content-Length ตั้งค่าเป็นจำนวนไบต์ทั้งหมดในเนื้อหาคำขอ ส่วนสื่อของคำขอต้องมีขนาดเล็กกว่าขนาดไฟล์สูงสุดที่ระบุ สำหรับเมธอดนี้

เนื้อหาของคำขอจะจัดรูปแบบเป็นmultipart/relatedประเภทเนื้อหา [RFC2387] และมี 2 ส่วนที่แน่นอน โดยแต่ละส่วนจะระบุด้วยสตริงขอบเขต และสตริงขอบเขตสุดท้ายจะตามด้วย เครื่องหมายขีดกลาง 2 อัน

คำขอแบบหลายส่วนแต่ละส่วนต้องมีส่วนหัว Content-Type เพิ่มเติมดังนี้

ส่วนข้อมูลเมตา: ต้องอยู่ส่วนแรกและContent-Typeต้องตรงกับรูปแบบข้อมูลเมตาที่ยอมรับ
พาร์ทสื่อ: ต้องมาเป็นอันดับที่ 2 และ Content-Type ต้องตรงกับประเภท MIME ของสื่อที่เมธอดยอมรับ

ตัวอย่าง

คุณอัปโหลดสื่อโดยใช้ API ของ Display & Video 360 เพื่อทํางานต่างๆ ส่วนนี้จะแสดง ตัวอย่างเป็นคำขอ curl

อัปโหลดชิ้นงานครีเอทีฟโฆษณา

วิธีอัปโหลดชิ้นงานครีเอทีฟโฆษณามีดังนี้

curl --request POST \
  'https://displayvideo.googleapis.com/upload/v4/advertisers/advertiser-id/assets?uploadType=multipart' \
  --header 'Authorization: Bearer access-token' \
   -F "data={\"filename\": \"asset-filename\"};type=application/json;charset=UTF-8" \
   -F "file=@asset-path;type=asset-mime-type"

ดูรายละเอียดเพิ่มเติมและตัวอย่างโค้ดได้ในคู่มืออัปโหลดชิ้นงานครีเอทีฟโฆษณา

อัปโหลดไฟล์สคริปต์การเสนอราคาที่กำหนดเอง

วิธีอัปโหลดไฟล์สคริปต์มีดังนี้

curl --request POST \
  'https://displayvideo.googleapis.com/upload/media/resource-name?uploadType=media' \
  -H 'authorization: Bearer access-token' \
  -H 'Content-Type: text/plain' \
  --data-binary @script-path

ดูรายละเอียดเพิ่มเติมและตัวอย่างโค้ดได้ในคู่มือสคริปต์การอัปโหลด