Videos: update

ตอนนี้ API รองรับความสามารถในการทำเครื่องหมายช่องหรือ วิดีโอของคุณเป็น "สร้างมาเพื่อเด็ก" แล้ว นอกจากนี้ ตอนนี้ทรัพยากร channel และ video ยังมีพร็อพเพอร์ตี้ที่ระบุสถานะ "สร้างมาเพื่อเด็ก" ของช่องหรือวิดีโอนั้นๆ ด้วย นอกจากนี้ เรายังได้อัปเดตข้อกำหนดในการให้บริการของบริการ API ของ YouTube และนโยบายสำหรับนักพัฒนาแอป เมื่อวันที่ 10 มกราคม 2020 ด้วย ดูข้อมูลเพิ่มเติมได้ที่ประวัติการแก้ไขสำหรับ บริการ YouTube Data API และ ข้อกำหนดในการให้บริการของบริการ API ของ YouTube

อัปเดตข้อมูลเมตาของวิดีโอ

ผลกระทบต่อโควต้า: การเรียกใช้เมธอดนี้มีค่าใช้จ่ายโควต้า 50 หน่วย

กรณีการใช้งานทั่วไป

ส่งคำขอ

คำขอ HTTP

PUT https://www.googleapis.com/youtube/v3/videos

การให้สิทธิ์

คำขอนี้ต้องมีการให้สิทธิ์ที่มีขอบเขตอย่างน้อย 1 รายการต่อไปนี้ (ดูข้อมูลเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)

ขอบเขต
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

พารามิเตอร์

ตารางต่อไปนี้แสดงพารามิเตอร์ที่การค้นหานี้รองรับ พารามิเตอร์ทั้งหมดที่แสดงเป็นพารามิเตอร์การค้นหา

พารามิเตอร์
พารามิเตอร์ที่จำเป็น
part	string พารามิเตอร์ part มีไว้เพื่อวัตถุประสงค์ 2 อย่างในการดำเนินการนี้ โดยจะระบุพร็อพเพอร์ตี้ที่การดำเนินการเขียนจะตั้งค่า รวมถึงพร็อพเพอร์ตี้ที่การตอบกลับจาก API จะรวมไว้ โปรดทราบว่าเมธอดนี้จะลบล้างค่าที่มีอยู่สำหรับพร็อพเพอร์ตี้ที่เปลี่ยนแปลงได้ทั้งหมดซึ่งอยู่ในส่วนต่างๆ ที่ค่าพารามิเตอร์ระบุ เช่น การตั้งค่าความเป็นส่วนตัวของวิดีโอจะอยู่ในส่วน status ดังนั้น หากคำขอของคุณกำลังอัปเดตวิดีโอส่วนตัว และค่าพารามิเตอร์ part ของคำขอมีส่วน status การตั้งค่าความเป็นส่วนตัวของวิดีโอจะได้รับการอัปเดตเป็นค่าที่เนื้อหาของคำขอระบุ หากเนื้อหาของคำขอไม่ได้ระบุค่า ระบบจะนำการตั้งค่าความเป็นส่วนตัวที่มีอยู่ออกและวิดีโอจะกลับไปใช้การตั้งค่าความเป็นส่วนตัวเริ่มต้น นอกจากนี้ ไม่ใช่ทุกส่วนจะมีพร็อพเพอร์ตี้ที่ตั้งค่าได้เมื่อแทรกหรืออัปเดตวิดีโอ เช่น ออบเจ็กต์ statistics จะห่อหุ้มสถิติที่ YouTube คำนวณให้วิดีโอและไม่มีค่าที่คุณตั้งค่าหรือแก้ไขได้ หากค่าพารามิเตอร์ระบุ part ที่ไม่มีค่าที่เปลี่ยนแปลงได้ ระบบจะยังคงรวม part นั้นไว้ในการตอบกลับจาก API รายการต่อไปนี้แสดงชื่อ part ที่คุณสามารถรวมไว้ในค่าพารามิเตอร์ brandPartner contentDetails fileDetails id liveStreamingDetails localizations paidProductPlacementDetails player processingDetails recordingDetails snippet statistics status suggestions topicDetails
พารามิเตอร์ที่ไม่บังคับ
onBehalfOfContentOwner	string พารามิเตอร์นี้ใช้ได้เฉพาะในคำขอที่ได้รับอนุญาตอย่างถูกต้อง หมายเหตุ: พารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ YouTube เท่านั้น พารามิเตอร์ onBehalfOfContentOwner บ่งชี้ว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุผู้ใช้ YouTube CMS ที่ดำเนินการในนามของเจ้าของเนื้อหาที่ระบุไว้ในค่าพารามิเตอร์ พารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ YouTube ที่เป็นเจ้าของและจัดการช่อง YouTube หลายช่อง ซึ่งช่วยให้เจ้าของเนื้อหาตรวจสอบสิทธิ์ได้เพียงครั้งเดียวและเข้าถึงข้อมูลวิดีโอและช่องทั้งหมดได้โดยไม่ต้องระบุข้อมูลรับรองการตรวจสอบสิทธิ์สำหรับแต่ละช่อง บัญชี CMS จริงที่ผู้ใช้ตรวจสอบสิทธิ์ต้องลิงก์กับเจ้าของเนื้อหา YouTube ที่ระบุ

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

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

• คุณต้องระบุค่าสำหรับพร็อพเพอร์ตี้ต่อไปนี้

  • id
  • snippet.title \- พร็อพเพอร์ตี้นี้จำเป็นก็ต่อเมื่อคำขออัปเดต video ของทรัพยากร snippet
  • snippet.categoryId \- พร็อพเพอร์ตี้นี้จำเป็นก็ต่อเมื่อคำขออัปเดตทรัพยากร video ของ snippet

• คุณสามารถตั้งค่าสำหรับพร็อพเพอร์ตี้ต่อไปนี้

  • snippet.categoryId
  • snippet.defaultLanguage
  • snippet.description
  • snippet.tags[]
  • snippet.title
  • status.embeddable
  • status.license
  • status.privacyStatus
  • status.publicStatsViewable
  • status.publishAt \- หากตั้งค่าสำหรับพร็อพเพอร์ตี้นี้ คุณต้องตั้งค่าพร็อพเพอร์ตี้ status.privacyStatus เป็น private ด้วย คุณจะตั้งค่าพร็อพเพอร์ตี้นี้ได้ก็ต่อเมื่อสถานะความเป็นส่วนตัวของวิดีโอเป็น private และวิดีโอดังกล่าวไม่เคยเผยแพร่
  • status.selfDeclaredMadeForKids
  • status.containsSyntheticMedia
  • recordingDetails.recordingDate
  • localizations.(key)
  • localizations.(key).title
  • localizations.(key).description

  หากคุณส่งคำขออัปเดตและคำขอไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้ที่มีค่าอยู่แล้ว ระบบจะลบค่าที่มีอยู่ออก

คำตอบ

หากทำสำเร็จ เมธอดนี้จะแสดงผลทรัพยากรวิดีโอในเนื้อหาการตอบกลับ

ข้อผิดพลาด

ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API อาจแสดงผลเพื่อตอบสนองต่อการเรียกใช้เมธอดนี้ ดูรายละเอียดเพิ่มเติมได้ในเอกสารประกอบข้อความแสดงข้อผิดพลาด

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	defaultLanguageNotSet	คำขอ API พยายามเพิ่มรายละเอียดวิดีโอที่แปลเป็นภาษาต่างๆ โดยไม่ได้ระบุภาษาเริ่มต้นของรายละเอียดวิดีโอ
badRequest (400)	invalidCategoryId	พร็อพเพอร์ตี้ snippet.categoryId ระบุรหัสหมวดหมู่ที่ไม่ถูกต้อง ใช้เมธอด videoCategories.list เพื่อดึงข้อมูลหมวดหมู่ที่รองรับ
badRequest (400)	invalidDefaultBroadcastPrivacySetting	คำขอพยายามตั้งค่าความเป็นส่วนตัวที่ไม่ถูกต้องสำหรับการออกอากาศเริ่มต้น
badRequest (400)	invalidDescription	ข้อมูลเมตาของคำขอระบุคำอธิบายวิดีโอที่ไม่ถูกต้อง
badRequest (400)	invalidPublishAt	ข้อมูลเมตาของคำขอระบุเวลาเผยแพร่ที่กำหนดเวลาไว้ไม่ถูกต้อง
badRequest (400)	invalidRecordingDetails	ออบเจ็กต์ recordingDetails ในข้อมูลเมตาของคำขอระบุรายละเอียดการบันทึกที่ไม่ถูกต้อง
badRequest (400)	invalidTags	ข้อมูลเมตาของคำขอระบุคีย์เวิร์ดวิดีโอที่ไม่ถูกต้อง
badRequest (400)	invalidTitle	ข้อมูลเมตาของคำขอระบุชื่อวิดีโอที่ไม่ถูกต้องหรือว่างเปล่า
badRequest (400)	invalidVideoMetadata	ข้อมูลเมตาของคำขอไม่ถูกต้อง
forbidden (403)	forbidden
forbidden (403)	forbiddenEmbedSetting	คำขอพยายามตั้งค่าการฝังที่ไม่ถูกต้องสำหรับวิดีโอ โปรดทราบว่าบางช่องอาจไม่มีสิทธิ์เสนอเพลเยอร์ที่ฝังไว้สำหรับไลฟ์สด ดูข้อมูลเพิ่มเติมได้ที่ศูนย์ช่วยเหลือของ YouTube
forbidden (403)	forbiddenLicenseSetting	คำขอพยายามตั้งค่าใบอนุญาตที่ไม่ถูกต้องสำหรับวิดีโอ
forbidden (403)	forbiddenPrivacySetting	คำขอพยายามตั้งค่าความเป็นส่วนตัวที่ไม่ถูกต้องสำหรับวิดีโอ
notFound (404)	videoNotFound	ไม่พบวิดีโอที่คุณพยายามอัปเดต ตรวจสอบค่าของช่อง id ในเนื้อหาของคำขอเพื่อให้แน่ใจว่าถูกต้อง

ลองใช้งาน

ใช้ APIs Explorer เพื่อเรียกใช้ API นี้และดูคำขอและการตอบกลับของ API