หน้านี้จะแสดงรายการการเปลี่ยนแปลง API ข้อมูลของ YouTube (v3) และการอัปเดตเอกสาร สมัครรับบันทึกการเปลี่ยนแปลงนี้
30 เมษายน 2024
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
API จะไม่รองรับความสามารถในการแทรกหรือเรียกข้อมูลการสนทนาในช่องอีกต่อไป การเปลี่ยนแปลงนี้สอดคล้องกับฟังก์ชันที่รองรับบนเว็บไซต์ YouTube ซึ่งไม่รองรับการโพสต์ความคิดเห็นในช่อง
13 มีนาคม 2024
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
พารามิเตอร์ sync
สำหรับพารามิเตอร์
captions.insert
และ
captions.update
วิธี
เลิกใช้งานแล้ว YouTube จะหยุดสนับสนุน
ณ วันที่ 12 เมษายน 2024
การเปลี่ยนแปลงนี้ทำให้นักพัฒนาแอปต้องใส่ข้อมูลเวลาเมื่อแทรกหรือ อัปเดตแทร็กคำอธิบายภาพ มิฉะนั้นการอัปโหลดจะล้มเหลว
12 มีนาคม 2024
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
เอกสารสำหรับทรัพยากร captions
ได้รับการอัปเดตแล้วโปรดทราบว่าความยาวสูงสุดที่อนุญาตสำหรับ snippet.name
มีอักขระ 150 ตัว API แสดงผล nameTooLong
หากชื่อแทร็กยาวกว่านั้น
7 มีนาคม 2024
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
พร็อพเพอร์ตี้ทรัพยากร channel
brandingSettings.channel.moderateComments
เลิกใช้งานแล้ว YouTube จะหยุดลง
รองรับพารามิเตอร์ดังกล่าวตั้งแต่วันที่ 7 มีนาคม 2024
31 มกราคม 2024
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
forHandle
ใหม่ของเมธอด channels.list
ช่วยให้คุณสามารถดึงข้อมูลเกี่ยวกับช่องโดยการระบุแฮนเดิล YouTube ของช่องนั้น
9 พฤศจิกายน 2023
การอ้างอิงทั้งหมดไปยังทรัพยากร videoId
ภายใต้ Comments
ถูกนำออกแล้วเนื่องจากไม่มีการส่งคืนทรัพยากร videoId
โดยใช้การเรียก API
12 กันยายน 2023
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
เมธอด comments.markAsSpam
ถูกเลิกใช้งานมาหลายปีแล้ว YouTube ไม่รองรับวิธีนี้อยู่แล้วและไม่ใช่
อีกต่อไปผ่าน API
มีการเพิ่มประกาศการเลิกใช้งานในเอกสารทั้งหมดที่อ้างอิงถึง
comments.markAsSpam
วิธี
22 สิงหาคม 2023
ตอนนี้เมธอด search.list
รองรับฟังก์ชัน
วันที่ videoPaidProductPlacement
พารามิเตอร์ พารามิเตอร์นี้ทำให้คุณสามารถกรองผลการค้นหาให้รวมเฉพาะวิดีโอที่
ครีเอเตอร์ได้บ่งชี้ว่ามีการโปรโมตแบบเสียค่าใช้จ่าย
18 สิงหาคม 2023
คำจำกัดความของทรัพยากร video
วันที่ liveStreamingDetails.concurrentViewers
มีการอัปเดตเนื่องจากจำนวนผู้ดูพร้อมกันที่นับว่าการตอบกลับจาก YouTube Data API อาจ
แตกต่างจากจำนวนผู้ชมที่ดูพร้อมกันซึ่งประมวลผลแล้วและปราศจากสแปมที่มีให้บริการผ่าน YouTube
Analytics
ศูนย์ช่วยเหลือของ YouTube
ให้ข้อมูลเพิ่มเติมเกี่ยวกับเมตริกสตรีมมิงแบบสด
7 สิงหาคม 2023
ตามที่ได้ประกาศไปเมื่อวันที่ 12 มิถุนายน 2023
ของเมธอด search.list
เลิกใช้งานพารามิเตอร์ relatedToVideoId
แล้ว พารามิเตอร์ดังกล่าวไม่ได้รับการสนับสนุนอีกต่อไป
ที่สนับสนุน และการอ้างอิงถึงพารามิเตอร์นี้ถูกลบออกจากเอกสาร API แล้ว
28 มิถุนายน 2023
ตอนนี้เมธอด thumbnails.set สนับสนุนเมธอด
ข้อผิดพลาด uploadRateLimitExceeded
ซึ่งระบุว่าช่องอัปโหลดมากเกินไป
ภาพขนาดย่อในช่วง 24 ชั่วโมงที่ผ่านมาและควรลองอีกครั้งในภายหลัง
12 มิถุนายน 2023
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
เมธอด search.list
เลิกใช้งานพารามิเตอร์ relatedToVideoId
แล้ว YouTube จะหยุดสนับสนุน
ณ วันที่ 7 สิงหาคม 2023
ในตอนนี้ มีการเพิ่มการแจ้งเตือนการเลิกใช้งานลงในเมธอด search.list
เอกสารประกอบ ระบบจะนำพารามิเตอร์นี้ออกจากเอกสารประกอบเกี่ยวกับ search.list
โดยสมบูรณ์
ตั้งแต่วันที่ 7 สิงหาคม 2023 เป็นต้นไป
นอกจากนี้ ในตัวอย่างที่แสดงวิธีดึงข้อมูลวิดีโอที่เกี่ยวข้อง ที่นำออกจากคู่มือการใช้งาน API
22 สิงหาคม 2022
แก้ไขคำอธิบายประกอบประเภทสำหรับ video.statistics แล้ว เป็นสตริงจากสตริงแบบยาว
5 สิงหาคม 2022
YouTube ได้เปลี่ยนวิธีสร้างรหัสคำบรรยายแทนเสียง ซึ่งเป็นส่วนหนึ่งของการเปลี่ยนแปลงดังกล่าว
กำหนดรหัสคำบรรยายใหม่ให้กับแทร็กคำบรรยายแทนเสียงทั้งหมด การเปลี่ยนแปลงนี้อาจเข้ากันไม่ได้กับเวอร์ชันก่อน
เปลี่ยนสำหรับแอปพลิเคชันที่จัดเก็บ
caption_id
ค่า แต่จะไม่
มีผลกับแอปพลิเคชันที่ไม่ได้จัดเก็บ
caption_id
ตั้งแต่วันนี้จนถึงวันที่ 1 ธันวาคม 2022 แอตทริบิวต์
captions.list
,
captions.update
,
captions.download
และ
และ captions.delete
เมธอดจะ
รองรับรหัสแทร็กคำบรรยายทั้งเก่าและใหม่ อย่างไรก็ตาม ตั้งแต่วันที่ 1 ธันวาคม 2022 เป็นต้นไป YouTube
จะหยุดสนับสนุนรหัสแทร็กคำอธิบายวิดีโอเดิม ในเวลานั้น การเรียกใช้เมธอด API ใดๆ เหล่านั้น
ที่มีรหัสแทร็กคำอธิบายวิดีโอเก่า
จะส่งผลให้มี
ข้อผิดพลาด captionNotFound
รายการ
คุณควรวางแผนแทนที่ข้อมูลแทร็กคำบรรยายแทนเสียงที่จัดเก็บไว้ทั้งหมดเพื่อเตรียมพร้อมสำหรับการเปลี่ยนแปลงนี้
ตั้งแต่วันนี้จนถึงวันที่ 1 ธันวาคม 2022 ซึ่งหมายความว่าสำหรับวิดีโอใดก็ตามที่คุณจัดเก็บแทร็กคำอธิบายภาพไว้
คุณควรลบข้อมูลที่เก็บไว้ในปัจจุบัน จากนั้นเรียก
captions.list
เมธอดเพื่อเรียกข้อมูล
ชุดแทร็กคำบรรยายภาพในปัจจุบันสำหรับวิดีโอ และจัดเก็บข้อมูลไว้ในการตอบสนองของ API เช่นเดียวกับที่คุณทำ
ตามปกติ
12 กรกฎาคม 2022
ปรับปรุงข้อกำหนดในการให้บริการของบริการ API ของ YouTube แล้ว โปรด ดูข้อกำหนดในการให้บริการของบริการ API ของ YouTube - การแก้ไข ประวัติสำหรับข้อมูลเพิ่มเติม
27 เมษายน 2022
อัปเดตคำอธิบายเมธอด videos.insert
แล้ว โปรดทราบว่าขนาดสูงสุดของไฟล์ที่อัปโหลดจาก 128 GB เป็น 256 GB แล้ว
8 เมษายน 2022
เมธอด subscriptions.list
วันที่ myRecentSubscribers
และคำจำกัดความของพารามิเตอร์ mySubscribers
รายการ
ทั้ง 2 อย่างมีการปรับปรุงโปรดทราบว่าจำนวนสูงสุดของผู้ติดตามที่ API แสดงผลอาจถูกจำกัด
การเปลี่ยนแปลงนี้แสดงถึงการแก้ไขในเอกสาร ไม่ใช่การเปลี่ยนแปลงลักษณะการทำงานของ API
15 ธันวาคม 2021
ตามประกาศเมื่อวันที่ 18 พฤศจิกายน 2021 ซึ่งเกี่ยวกับ
การเปลี่ยนแปลงที่จะทำให้วิดีโอไม่ชอบ
นับเป็นแบบส่วนตัวทั่วทั้งแพลตฟอร์ม YouTube ซึ่งเป็นทรัพยากร video
statistics.dislikeCount
ตอนนี้ที่พักเป็นแบบส่วนตัวแล้ว
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงนี้ได้ในบล็อกอย่างเป็นทางการของ YouTube
18 พฤศจิกายน 2021
รวมทั้งการเปลี่ยนแปลงเกี่ยวกับ
ทำให้จำนวนการกดไม่ชอบวิดีโอเป็นแบบส่วนตัวทั่วทั้งแพลตฟอร์ม YouTube ซึ่งเป็นแหล่งข้อมูลใน video
statistics.dislikeCount
ที่พักจะถูกทำให้เป็นแบบส่วนตัวตั้งแต่วันที่ 13 ธันวาคม 2021 ซึ่งหมายความว่าพร็อพเพอร์ตี้จะ
รวมอยู่ในการตอบกลับของ API จากปลายทาง videos.list
หากคำขอ API คือ
ตรวจสอบสิทธิ์โดยเจ้าของวิดีโอแล้ว
ปลายทาง videos.rate
ไม่ได้รับผลกระทบ
ตามการเปลี่ยนแปลงนี้
นักพัฒนาซอฟต์แวร์ที่ไม่แสดงจำนวนการกดไม่ชอบแบบสาธารณะ แต่ยังคงต้องการจำนวนการกดไม่ชอบสำหรับ คุณสามารถสมัครไคลเอ็นต์ API เพื่ออยู่ในรายการอนุญาตสำหรับการยกเว้นได้ หากต้องการสมัครขอรับการยกเว้น คุณต้อง ต้องดำเนินการให้เสร็จสมบูรณ์ แบบฟอร์มการสมัคร
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงนี้ได้ในบล็อกอย่างเป็นทางการของ YouTube
2 กรกฎาคม 2021
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
เราเลิกใช้งานปลายทาง commentThreads.update
แล้ว และระบบไม่รองรับอีกต่อไป
ปลายทางนี้ทำซ้ำฟังก์ชันการทำงานที่พร้อมใช้งานผ่านปลายทาง API อื่นๆ อย่างไรก็ตาม คุณสามารถ
โทรหา comments.update
commentThreads
ให้ทำการเรียกสำรองไปยัง
commentThreads.list
วิธี
1 กรกฎาคม 2021
นักพัฒนาซอฟต์แวร์ทุกรายที่ใช้บริการ API ของ YouTube ต้องผ่านการตรวจสอบการปฏิบัติตามข้อกำหนดของ API เพื่อให้ได้รับการจัดสรรมากกว่าโควต้าเริ่มต้นที่ 10,000 หน่วย ที่ผ่านมา ทั้งกระบวนการตรวจสอบการปฏิบัติตามข้อกำหนดและคำขอจัดสรรหน่วยโควต้าเพิ่มเติมได้รับการดำเนินการโดยนักพัฒนาซอฟต์แวร์ได้กรอกและส่งบริการ YouTube API - แบบฟอร์มการตรวจสอบและการขยายโควต้า
เราจะเพิ่มแบบฟอร์มใหม่ 3 แบบฟอร์มและคำแนะนำในการกรอกแบบฟอร์มเหล่านั้น เพื่ออธิบายกระบวนการเหล่านี้และตอบสนองความต้องการของนักพัฒนาแอปที่ใช้บริการ API ของเราได้ดียิ่งขึ้น
- แบบฟอร์มคำขอของนักพัฒนาซอฟต์แวร์ที่ได้รับการตรวจสอบ: นักพัฒนาซอฟต์แวร์ที่ผ่านการตรวจสอบการปฏิบัติตามข้อกำหนดของ API แล้ว สามารถกรอกข้อมูลและส่งแบบฟอร์มที่สั้นกว่านี้เพื่อขอขยายโควต้าที่จัดสรร
- แบบฟอร์มคำร้อง: นักพัฒนาแอปที่เป็นเจ้าของโปรเจ็กต์ API ที่ไม่ผ่านการตรวจสอบการปฏิบัติตามข้อกำหนด (หรือถูกปฏิเสธการเพิ่มหน่วยโควต้า) สามารถกรอกข้อมูลและส่งแบบฟอร์มนี้ได้
- แบบฟอร์มการเปลี่ยนแปลงการควบคุม: นักพัฒนาซอฟต์แวร์หรือบุคคลใดก็ตามที่ดำเนินการไคลเอ็นต์ API ในนามของนักพัฒนาแอป ซึ่งมีการเปลี่ยนแปลงการควบคุม (เช่น ผ่านการซื้อหรือขายหุ้น การควบรวมกิจการ หรือธุรกรรมของบริษัทในรูปแบบอื่น) ที่เชื่อมโยงกับโปรเจ็กต์ API จะต้องกรอกข้อมูลและส่งแบบฟอร์มนี้ ซึ่งจะช่วยให้ทีม API ของ YouTube สามารถอัปเดตระเบียนของเรา ตรวจสอบการปฏิบัติตามข้อกำหนดของกรณีการใช้งานของโปรเจ็กต์ API ใหม่ และตรวจสอบการจัดสรรโควต้าปัจจุบันของนักพัฒนาซอฟต์แวร์
โดยแบบฟอร์มใหม่แต่ละรายการจะแจ้งให้เราทราบถึงวัตถุประสงค์การใช้งาน API ของ YouTube และช่วยให้เราช่วยเหลือคุณได้ดียิ่งขึ้น
โปรดดูรายละเอียดเพิ่มเติมในคู่มือการตรวจสอบการปฏิบัติตามข้อกำหนด API ใหม่
12 พฤษภาคม 2021
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
การอัปเดตนี้ครอบคลุมถึงการเปลี่ยนแปลง API ต่อไปนี้
-
ทรัพยากรของ
channel
วันที่contentDetails.relatedPlaylists.favorites
เลิกใช้งานพร็อพเพอร์ตี้แล้ว เราได้เลิกใช้งานฟังก์ชันวิดีโอโปรดสำหรับ หลายปีตามที่ระบุไว้ในวันที่ 28 เมษายน 2016 รายการบันทึกก่อนการอัปเดตนี้ API จะยังคงสร้างเพลย์ลิสต์ใหม่หากไคลเอ็นต์ API พยายามสร้าง เพิ่มวิดีโอลงในเพลย์ลิสต์รายการโปรดที่ไม่มีอยู่ แต่นับจากนี้ไป เพลย์ลิสต์จะไม่ ที่สร้างขึ้นในกรณีนี้ และ API จะแสดงข้อผิดพลาด ความพยายามที่จะแก้ไขเพลย์ลิสต์โปรด การเพิ่ม แก้ไข หรือลบรายการจะเลิกใช้งานทั้งหมดตามการประกาศก่อนหน้านี้และ อาจเริ่มแสดงผลข้อผิดพลาดเมื่อใดก็ได้
-
ทรัพยากร
channel
ต่อไปนี้ เลิกใช้งานพร็อพเพอร์ตี้แล้ว ระบบไม่รองรับพร็อพเพอร์ตี้เหล่านี้ใน UI ของ YouTube Studio อยู่แล้ว และใน YouTube ด้วยเหตุนี้ จึงไม่ได้รับการรองรับผ่าน API อีกต่อไปbrandingSettings.channel.defaultTab
brandingSettings.channel.featuredChannelsTitle
brandingSettings.channel.featuredChannelsUrls[]
brandingSettings.channel.profileColor
brandingSettings.channel.showBrowseView
brandingSettings.channel.showRelatedChannels
พร็อพเพอร์ตี้ทั้งหมดถูกนำออกจาก
channel
การแสดงทรัพยากร และคำจำกัดความของทรัพยากรได้ถูกนำออกจากทรัพยากร รายการพร็อพเพอร์ตี้ นอกจากนี้ ข้อผิดพลาด รวมถึงได้นำพร็อพเพอร์ตี้เหล่านี้ออกจากเอกสารเฉพาะของเมธอดแล้ว -
ทรัพยากร
channelSection
ต่อไปนี้ เลิกใช้งานพร็อพเพอร์ตี้แล้ว ระบบไม่รองรับพร็อพเพอร์ตี้เหล่านี้ใน UI ของ YouTube Studio อยู่แล้ว และใน YouTube ด้วยเหตุนี้ จึงไม่ได้รับการรองรับผ่าน API อีกต่อไปsnippet.style
snippet.defaultLanguage
snippet.localized.title
localizations
localizations.(key)
localizations.(key).title
targeting
targeting.languages[]
targeting.regions[]
targeting.countries[]
เมื่อใช้ร่วมกับการเปลี่ยนแปลงนี้ เมธอด
channelSection.list
พารามิเตอร์hl
ยัง ถูกเลิกใช้งานแล้วเนื่องจากระบบไม่รองรับฟีเจอร์ที่รองรับพร็อพเพอร์ตี้ทั้งหมดถูกนำออกจาก
channelSection
การแสดงทรัพยากร และคำจำกัดความของทรัพยากรได้ถูกนำออกจากทรัพยากร รายการพร็อพเพอร์ตี้ นอกจากนี้ ข้อผิดพลาด รวมถึงได้นำพร็อพเพอร์ตี้เหล่านี้ออกจากเอกสารเฉพาะของเมธอดแล้ว -
สำหรับทรัพยากร
channelSection
พร็อพเพอร์ตี้snippet.type
ค่าต่อไปนี้เลิกใช้งานแล้ว ระบบไม่รองรับค่าเหล่านี้บน YouTube อยู่แล้ว หน้าแชแนล ด้วยเหตุนี้ จึงจะไม่ได้รับการสนับสนุนผ่าน API อีกต่อไปlikedPlaylists
likes
postedPlaylists
postedVideos
recentActivity
recentPosts
-
ทรัพยากรของ
playlist
เลิกใช้งานพร็อพเพอร์ตี้snippet.tags[]
แล้ว ระบบไม่รองรับพร็อพเพอร์ตี้นี้แล้ว บน YouTube ด้วยเหตุนี้จึงไม่รองรับผ่าน API อีกต่อไป
9 กุมภาพันธ์ 2021
ทรัพยากร playlistItem
รองรับพร็อพเพอร์ตี้ใหม่ 2 รายการดังนี้
snippet.videoOwnerChannelId
จะระบุรหัสของช่องที่อัปโหลดวิดีโอของเพลย์ลิสต์snippet.videoOwnerChannelTitle
จะระบุชื่อช่องที่อัปโหลดวิดีโอของเพลย์ลิสต์
28 มกราคม 2021
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
playlistItems.delete
playlistItems.insert
,playlistItems.list
,playlistItems.update
,playlists.delete
,playlists.list
และ การสนับสนุนทั้งหมดของplaylists.update
วิธี ข้อผิดพลาดplaylistOperationUnsupported
ใหม่ ข้อผิดพลาดนี้เกิดขึ้นเมื่อคำขอพยายาม ดำเนินการที่ไม่ได้รับอนุญาตสำหรับเพลย์ลิสต์บางรายการ เช่น ผู้ใช้ไม่สามารถ ลบวิดีโอออกจากเพลย์ลิสต์วิดีโอที่อัปโหลดของผู้ใช้หรือลบเพลย์ลิสต์นั้นในทุกกรณี ข้อผิดพลาดนี้จะแสดงรหัสการตอบสนอง HTTP
400
(คำขอไม่ถูกต้อง) -
เมธอด
playlistItems.list
มีข้อผิดพลาดwatchHistoryNotAccessible
และwatchLaterNotAccessible
รายการ ออกจากเอกสารประกอบแล้ว ในขณะที่ผู้ใช้ ที่จริงแล้ว ประวัติการดูและรายการดูภายหลัง ไม่สามารถเข้าถึงได้ผ่าน API ข้อผิดพลาดเฉพาะเหล่านี้จะไม่แสดงผลโดย API
15 ตุลาคม 2020
มีการเพิ่มส่วนใหม่ 2 ส่วนในส่วน นโยบาย:
- ส่วนที่ III.E.4.i ใหม่มี ข้อมูลเพิ่มเติมเกี่ยวกับข้อมูลที่รวบรวมและส่งผ่านโปรแกรมเล่นแบบฝังของ YouTube คุณ จะรับผิดชอบต่อข้อมูลผู้ใช้ใดๆ ที่คุณส่งให้เราผ่านโปรแกรมเล่นแบบฝังของ YouTube ก่อน ผู้ใช้โต้ตอบกับโปรแกรมเล่นเพื่อระบุความตั้งใจในการเล่น คุณสามารถจำกัดข้อมูลที่แชร์ได้ กับ YouTube ก่อนที่ผู้ใช้จะโต้ตอบกับโปรแกรมเล่นด้วยการตั้งค่า "เล่นอัตโนมัติ" เป็น "เท็จ"
- ส่วนที่ III.E.4.j ใหม่เกี่ยวข้องกับ สำหรับการตรวจสอบสถานะเนื้อหาที่สร้างมาเพื่อเด็ก (MFK) ก่อนฝังเนื้อหาลงในเว็บไซต์และ แอป คุณมีหน้าที่รับผิดชอบในการตรวจสอบว่าวิดีโอที่ฝังในไคลเอ็นต์ API สร้างขึ้นเมื่อใด สำหรับเด็กและจัดการกับข้อมูลที่รวบรวมจากโปรแกรมเล่นแบบฝังตามความเหมาะสม คุณจึงต้อง ตรวจสอบสถานะของเนื้อหาโดยใช้บริการ API ข้อมูลของ YouTube ก่อนฝังลงใน API ไคลเอ็นต์ผ่านโปรแกรมเล่นแบบฝังของ YouTube
การค้นหาสถานะ MadeForKids ใหม่ของวิดีโอ คู่มือจะอธิบายวิธีค้นหาสถานะ MFK ของวิดีโอโดยใช้ บริการ API ข้อมูลของ YouTube
เราได้เพิ่มการช่วยเตือนลงใน เอกสารประกอบเกี่ยวกับพารามิเตอร์โปรแกรมเล่นแบบฝังเพื่ออธิบายว่า หากคุณเปิดการเล่นอัตโนมัติ การเล่นจะเกิดขึ้นโดยที่ผู้ใช้ไม่ได้โต้ตอบกับโปรแกรมเล่นวิดีโอ เล่น การรวบรวมและแชร์ข้อมูลจึงเกิดขึ้นเมื่อหน้าเว็บโหลดขึ้นมา
8 ตุลาคม 2020
การปรับปรุงครั้งนี้ครอบคลุมการเปลี่ยนแปลงเล็กๆ น้อยๆ 3 อย่างที่เกี่ยวข้องกับ
แหล่งข้อมูล channel
:
snippet.thumbnails
ที่ระบุภาพขนาดย่อของช่องอาจว่างเปล่าสำหรับที่เพิ่งสร้างใหม่ และอาจใช้เวลานานถึง 1 วันจึงจะสร้างได้statistics.videoCount
พร็อพเพอร์ตี้จะแสดงจำนวนวิดีโอสาธารณะของช่องเท่านั้น แม้ว่าจะแสดงต่อเจ้าของก็ตาม ลักษณะการทำงานนี้ จะสอดคล้องกับจำนวนที่แสดงบนเว็บไซต์ YouTube- คีย์เวิร์ดของช่อง ซึ่งระบุอยู่ใน
brandingSettings.channel.keywords
พร็อพเพอร์ตี้ อาจมีการตัดให้สั้นลงหากเกินความยาวสูงสุดที่อนุญาตไว้ที่ 500 ตัวอักษรหรือ หากมีเครื่องหมายคำพูดที่ไม่ได้ใช้ Escape ("
) โปรดทราบว่า 500 อักขระ ขีดจำกัดไม่ใช่ขีดจำกัดต่อคีย์เวิร์ด แต่เป็นขีดจำกัดความยาวรวมของคีย์เวิร์ดทั้งหมด ลักษณะการทำงานนี้จะสอดคล้องกับพฤติกรรมนี้บนเว็บไซต์ YouTube
9 กันยายน 2020
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
การอัปเดตนี้ครอบคลุมถึงการเปลี่ยนแปลง API ต่อไปนี้ การเปลี่ยนแปลงทั้งหมดจะมีผลในวันที่หรือหลังจาก 9 กันยายน 2020 ซึ่งเป็นวันที่ของประกาศนี้ ด้วยเหตุนี้ นักพัฒนาซอฟต์แวร์จึงไม่ควร ต้องอาศัยฟีเจอร์ใดๆ ของ API ที่ระบุไว้ด้านล่าง
-
ทรัพยากร เมธอด พารามิเตอร์ และพร็อพเพอร์ตี้ทรัพยากรของ API ต่อไปนี้เลิกใช้งานแล้ว
ในทันทีและจะหยุดทำงานในหรือหลังจากวันที่ประกาศนี้
- ทรัพยากร
channel
ต่อไปนี้ พร็อพเพอร์ตี้:- พร็อพเพอร์ตี้
statistics.commentCount
- ออบเจ็กต์
brandingSettings.image
และพร็อพเพอร์ตี้ย่อยทั้งหมด - รายการ
brandingSettings.hints
และพร็อพเพอร์ตี้ย่อยทั้งหมด
- พร็อพเพอร์ตี้
- เมธอด
channels.list
พารามิเตอร์ตัวกรองcategoryId
- ทรัพยากร
guideCategories
และguideCategories.list
วิธีการ
- ทรัพยากร
-
การตอบกลับจาก API สำหรับ
หมายเลขเมธอด
channels.list
มีแอตทริบิวต์ วันที่prevPageToken
หากคำขอ API ตั้งค่า พารามิเตอร์managedByMe
รายการ ไปยังtrue
การเปลี่ยนแปลงนี้ไม่มีผลกับพร็อพเพอร์ตี้prevPageToken
สำหรับคำขอchannels.list
อื่นๆ และจะไม่ส่งผลต่อnextPageToken
สำหรับคำขอใดก็ได้ -
contentDetails.relatedPlaylists.watchLater
ของทรัพยากรchannel
และประกาศที่พักทั้งcontentDetails.relatedPlaylists.watchHistory
แห่ง เลิกใช้งานไปแล้วเมื่อวันที่ 11 สิงหาคม 2016 การรองรับเมธอดplaylistItems.insert
และplaylistItems.delete
สำหรับเพลย์ลิสต์เหล่านี้ก็หยุดให้บริการโดยสมบูรณ์แล้ว และนำพร็อพเพอร์ตี้ทั้ง 2 รายการออก จากเอกสารประกอบ -
พารามิเตอร์
mySubscribers
ของเมธอดchannels.list
ซึ่งเดิม ได้ประกาศว่าเลิกใช้งานไปแล้วเมื่อวันที่ 30 กรกฎาคม 2013 ได้ นำออกจากเอกสารแล้ว ใช้เมนูsubscriptions.list
วิธีและ พารามิเตอร์mySubscribers
เพื่อเรียกดูรายชื่อสมาชิกของ ช่องของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์แล้ว -
ออบเจ็กต์
channel
ของทรัพยากรinvideoPromotion
และออบเจ็กต์ย่อยทั้งหมด ซึ่งมีการประกาศว่าเลิกใช้งานเมื่อวันที่ นำวันที่ 27 พฤศจิกายน 2017 ออกจากเอกสารประกอบแล้ว
29 กรกฎาคม 2020
เราได้ลดความซับซ้อนของขั้นตอนการเรียกเก็บเงินสำหรับโควต้าคำขอ API โดยการลบ
ค่าใช้จ่ายที่เชื่อมโยงกับพารามิเตอร์ part
การเรียกเก็บเงินจะมีผลทันที
ต้นทุนฐานสำหรับเมธอดที่เรียกใช้ คุณสามารถดูข้อมูลเพิ่มเติมเกี่ยวกับ
ที่นี่
ผลกระทบของการเปลี่ยนแปลงนี้คือ การเรียก API ส่วนใหญ่จะมีต้นทุนโควต้าลดลงเล็กน้อย ขณะที่ การเรียก API บางรายการจะยังคงมีค่าใช้จ่ายเท่าเดิม การเปลี่ยนแปลงนี้ไม่ได้เพิ่มค่าใช้จ่ายของ API โดยรวมแล้ว ผลกระทบที่เป็นไปได้คือโควต้าที่จัดสรรของคุณ ซึ่งสามารถดูได้ใน คอนโซล Google Cloud จะอยู่ไกลออกไปเล็กน้อย
เราขอแนะนำให้นักพัฒนาแอปทุกราย การตรวจสอบการปฏิบัติตามข้อกำหนดสำหรับ เพื่อให้เข้าถึงบริการ API ของ YouTube ได้ต่อไป
รายการประวัติการแก้ไขนี้เผยแพร่ครั้งแรกเมื่อวันที่ 20 กรกฎาคม 2020
28 กรกฎาคม 2020
วิดีโอทั้งหมดที่อัปโหลดผ่าน videos.insert
ปลายทางจากโปรเจ็กต์ API ที่ไม่ได้รับการยืนยันซึ่งสร้างขึ้นหลังจากวันที่ 28 กรกฎาคม 2020 จะถูกจำกัดไว้เฉพาะ
โหมดการดูแบบส่วนตัว หากต้องการยกเลิกข้อจำกัดนี้ แต่ละโปรเจ็กต์จะต้อง
ทำการตรวจสอบเพื่อยืนยัน
การปฏิบัติตามข้อกำหนด
ข้อกำหนดในการให้บริการ
ครีเอเตอร์ที่ใช้ไคลเอ็นต์ API ที่ไม่ได้รับการยืนยันเพื่ออัปโหลดวิดีโอจะได้รับอีเมลอธิบายว่า วิดีโอจะถูกล็อกเป็นส่วนตัว และหลีกเลี่ยงการจำกัดได้โดยใช้ หรือลูกค้าที่ได้รับการตรวจสอบแล้ว
โปรเจ็กต์ API ที่สร้างก่อนวันที่ 28 กรกฎาคม 2020 มีดังนี้ ไม่ได้รับผลกระทบจากการเปลี่ยนแปลงนี้ แต่เราขอแนะนำเป็นอย่างยิ่งให้นักพัฒนาแอปทุกราย ตรวจสอบการปฏิบัติตามข้อกำหนด สำหรับโปรเจ็กต์ต่อเพื่อให้เข้าถึงบริการ YouTube API ได้อย่างต่อเนื่อง
21 กรกฎาคม 2020
[อัปเดตเมื่อ 28 กรกฎาคม 2020] การอัปเดตเอกสารที่อ้างอิงในการแก้ไขครั้งนี้ รายการประวัติมีการเผยแพร่อีกครั้งในวันที่ 28 กรกฎาคม 2020
เมื่อวานนี้ เราได้เผยแพร่การอัปเดตเอกสารที่เกี่ยวข้องกับขั้นตอนโควต้าการเรียกเก็บเงินของเรา อย่างไรก็ตาม เนื่องจากเหตุการณ์ที่ไม่คาดคิด การเปลี่ยนแปลงโควต้าจึงยังไม่มีผลบังคับใช้ ด้วยเหตุนี้ ฟิลด์ เอกสารได้ถูกย้อนกลับเพื่อความถูกต้อง เพื่อไม่ให้เกิดความสับสน การแก้ไข ระบบได้นำรายการประวัติการเข้าชมที่อธิบายการเปลี่ยนแปลงออกแล้วและจะเผยแพร่อีกครั้งในอนาคตอันใกล้
7 กรกฎาคม 2020
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
เมธอด videos.insert
ขณะนี้มีการเลิกใช้งานพารามิเตอร์ autoLevels
และ stabilize
และทั้ง
ออกจากเอกสารประกอบแล้ว ระบบจะไม่สนใจค่าของเมตริกและจะไม่ส่งผลต่อ
วิธีประมวลผลวิดีโอที่อัปโหลดใหม่
15 มิถุนายน 2020
นโยบายใหม่การปฏิบัติตามข้อกำหนดของนักพัฒนาซอฟต์แวร์ YouTube คู่มือนโยบายจะให้คำแนะนำและตัวอย่างเพื่อช่วยให้คุณตรวจสอบว่าไคลเอ็นต์ API ของคุณปฏิบัติตามนโยบาย สำหรับบริการ API ของ YouTube บางส่วน ข้อกำหนดและ นโยบาย (ข้อกำหนดในการให้บริการของ API)
คำแนะนำนี้จะให้ข้อมูลเชิงลึกเกี่ยวกับวิธีที่ YouTube บังคับใช้ข้อกำหนดในการให้บริการในบางแง่มุมของ API ไม่แทนที่เอกสารที่มีอยู่ คู่มือนี้จะตอบคำถามที่พบบ่อยที่สุดบางส่วนที่ ระหว่างการตรวจสอบการปฏิบัติตามข้อกำหนดของ API เราหวังว่าฟีเจอร์นี้จะช่วยให้คุณพัฒนาฟีเจอร์ได้ง่ายขึ้น โดยช่วยให้คุณเข้าใจวิธีที่เราตีความและบังคับใช้นโยบาย
4 มิถุนายน 2020
หมายเหตุ: นี่เป็นข้อมูลอัปเดตเกี่ยวกับประกาศการเลิกใช้งานก่อนหน้านี้
เราเลิกใช้งานฟีเจอร์กระดานข่าวสารของช่องโดยสมบูรณ์แล้ว มีการประกาศเกี่ยวกับการเปลี่ยนแปลงนี้ในตอนแรก
เมื่อวันที่ 17 เมษายน 2020 และมีผลบังคับใช้แล้ว ด้วยเหตุนี้ ฟิลด์
เมธอด activities.insert
ไม่ใช่
ที่ใช้งานได้นานขึ้น และ
วันที่ activities.list
ไม่แสดงกระดานข่าวสารของช่องอีกต่อไป โปรดดูรายละเอียดเพิ่มเติมที่
ศูนย์ช่วยเหลือของ YouTube
17 เมษายน 2020
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
YouTube กำลังจะเลิกใช้งานฟีเจอร์กระดานข่าวสารของช่อง ด้วยเหตุนี้ ฟิลด์
เมธอด activities.insert
จะ
และ activities.list
จะหยุดแสดงผลกระดานข่าวสารของช่อง การเปลี่ยนแปลงเหล่านี้จะมีผลใน API ในวันที่ หรือ
หลังวันที่ 18 พฤษภาคม 2020 โปรดดูรายละเอียดเพิ่มเติมที่
ศูนย์ช่วยเหลือของ YouTube
31 มีนาคม 2020
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
แหล่งข้อมูลและวิธีการใหม่ๆ
-
ทรัพยากร
member
ใหม่แสดง สมาชิกของช่อง YouTube สมาชิกให้การสนับสนุนทางการเงินตามรอบแก่ และรับสิทธิประโยชน์สุดพิเศษได้ ตัวอย่างเช่น สมาชิกสามารถแชทได้ ก็เปิดโหมดเฉพาะสมาชิกสำหรับแชททรัพยากรนี้แทนที่
sponsor
ซึ่งมีเอกสารประกอบไว้เป็นส่วนหนึ่งของ API สตรีมมิงแบบสดของ YouTube เลิกใช้งานทรัพยากรsponsor
แล้ว และไคลเอ็นต์ API ควรอัปเดตการเรียกไปยัง เมธอดsponsors.list
เพื่อใช้members.list
แทน -
membershipsLevel
ใหม่ ระบุระดับราคาที่จัดการโดยผู้สร้างที่ให้สิทธิ์คำขอ APImembershipsLevels.list
จะเรียกรายการระดับการเป็นสมาชิกทั้งหมดของครีเอเตอร์
-
10 มกราคม 2020
ปัจจุบัน API รองรับความสามารถในการระบุเนื้อหาที่มุ่งเน้นเด็กเป็นหลัก ซึ่ง YouTube เรียกใช้ "สร้างมาเพื่อเด็ก" ดูข้อมูลเพิ่มเติมเกี่ยวกับ "สร้างมาเพื่อเด็ก" เนื้อหาในศูนย์ช่วยเหลือของ YouTube
channel
และ
ทรัพยากร video
รองรับพร็อพเพอร์ตี้ใหม่ 2 รายการเพื่อ
ช่วยให้ครีเอเตอร์เนื้อหาและผู้ชมระบุเนื้อหาที่สร้างมาเพื่อเด็กได้
-
พร็อพเพอร์ตี้
selfDeclaredMadeForKids
ช่วยให้ครีเอเตอร์เนื้อหาระบุได้ว่า channel หรือ วิดีโอสร้างมาเพื่อเด็ก
สำหรับช่อง คุณสามารถตั้งค่าพร็อพเพอร์ตี้นี้เมื่อเรียกฟังก์ชันchannels.update
วิธี สำหรับวิดีโอ คุณสามารถตั้งค่าพร็อพเพอร์ตี้นี้เมื่อเรียกฟังก์ชันvideos.insert
หรือvideos.update
วิธี
โปรดทราบว่าพร็อพเพอร์ตี้นี้รวมอยู่ในการตอบกลับ API ที่มีchannel
หรือ เท่านั้น แหล่งข้อมูลvideo
หากเจ้าของช่องให้สิทธิ์คำขอ API -
พร็อพเพอร์ตี้
madeForKids
ช่วยให้ผู้ใช้ทุกคนสามารถดึงข้อมูลเนื้อหาที่ "สร้างมาเพื่อเด็ก" สถานะ ของช่องหรือ วิดีโอ ตัวอย่างเช่น สถานะอาจเป็น กำหนดตามค่าของพร็อพเพอร์ตี้selfDeclaredMadeForKids
โปรดดู ศูนย์ช่วยเหลือของ YouTube เพื่อดูข้อมูลเพิ่มเติม ข้อมูลเกี่ยวกับการกำหนดผู้ชมสำหรับช่อง วิดีโอ หรือการออกอากาศของคุณ
นอกจากนี้ เรายังปรับปรุงข้อกำหนดในการให้บริการของบริการ API ของ YouTube และนโยบายสำหรับนักพัฒนาซอฟต์แวร์ด้วย โปรด ดูข้อกำหนดในการให้บริการของบริการ API ของ YouTube - การแก้ไข ประวัติสำหรับข้อมูลเพิ่มเติม การเปลี่ยนแปลงข้อกำหนดในการให้บริการของบริการ API ของ YouTube และ นโยบายสำหรับนักพัฒนาแอปจะมีผลบังคับใช้ในวันที่ 10 มกราคม 2020 ตามเวลาแปซิฟิก
10 กันยายน 2019
เอกสารอ้างอิง API ได้รับการอัปเดตเพื่อแสดงการเปลี่ยนแปลงวิธีที่สมาชิกดังกล่าว
จะมีการรายงานจำนวนบน YouTube และในการตอบสนองของ API ด้วยเช่นกัน เนื่องจากการเปลี่ยนแปลง
จำนวนผู้ติดตามที่แสดงโดยบริการ YouTube Data API จะถูกปัดเศษลงเหลือ 3 นัยสำคัญ
จำนวนผู้ติดตามที่มีผู้ติดตามมากกว่า 1,000 คน การเปลี่ยนแปลงนี้ส่งผลต่อ
ทรัพยากรของ channel
statistics.subscriberCount
หมายเหตุ: การเปลี่ยนแปลงนี้จะมีผลกับค่าพร็อพเพอร์ตี้แม้ในกรณีที่ผู้ใช้ ส่งคำขอที่ได้รับอนุญาตสำหรับข้อมูลเกี่ยวกับช่องของตนเอง เจ้าของช่องยังคงสามารถดูตำแหน่งที่แน่นอน ใน YouTube Studio
ตัวอย่างเช่น หากช่องมีผู้ติดตาม 123,456 คน ระบบจะ
พร็อพเพอร์ตี้ statistics.subscriberCount
จะมีค่า 123000
ตารางด้านล่างแสดงตัวอย่างวิธีปัดเศษจำนวนผู้ติดตามในการตอบสนองของ API และ
เป็นตัวย่อในอินเทอร์เฟซผู้ใช้อื่นๆ ของ YouTube ที่เปิดเผยต่อสาธารณะ:
ตัวอย่างจำนวนผู้ติดตาม | YouTube Data API | UI ของ YouTube ที่เปิดเผยต่อสาธารณะ |
---|---|---|
1,234 รายการ | 1230 | 1.23 พัน |
12,345 คน | 12300 | 1.23 หมื่น |
123,456 รายการ | 123000 | 1.23 แสน |
1,234,567 | 1230000 | 1.23 ล้าน |
12,345,678 ครั้ง | 12300000 | 12.3 ล้าน |
123,456,789 | 123000000 | 123 ล้าน |
4 เมษายน 2019
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เอกสารอ้างอิง API ได้รับการอัปเดตเพื่ออธิบายกรณีการใช้งานทั่วไปสำหรับแต่ละเมธอดให้ดียิ่งขึ้น และเพื่อแสดงตัวอย่างโค้ดแบบไดนามิกที่มีคุณภาพสูงผ่านวิดเจ็ต API Explorer ดูตัวอย่างในเอกสารของเมธอด
channels.list
ตอนนี้มีองค์ประกอบใหม่ 2 รายการในหน้าเว็บที่อธิบายเมธอด API ดังนี้-
วิดเจ็ต API Explorer ให้คุณเลือกขอบเขตการให้สิทธิ์ ป้อนพารามิเตอร์ตัวอย่างและค่าพร็อพเพอร์ตี้ แล้วส่งคำขอ API จริงและดูการตอบกลับจาก API จริงได้ วิดเจ็ตยังมีมุมมองแบบเต็มหน้าจอที่แสดงตัวอย่างโค้ดที่สมบูรณ์ ซึ่งจะอัปเดตแบบไดนามิกเพื่อใช้ขอบเขตและค่าที่คุณป้อน
-
ส่วน Use Case ที่พบบ่อย จะอธิบาย Use Case ที่พบบ่อยอย่างน้อย 1 กรณีสำหรับวิธีการที่อธิบายไว้ในหน้า ตัวอย่างเช่น คุณสามารถเรียกใช้เมธอด
channels.list
เพื่อดึงข้อมูลเกี่ยวกับแชแนลที่ระบุ หรือเพื่อดึงข้อมูลเกี่ยวกับแชแนลของผู้ใช้ปัจจุบันคุณสามารถใช้ลิงก์ในส่วนดังกล่าวเพื่อเติมข้อมูลให้กับ API Explorer ด้วยค่าตัวอย่างสำหรับกรณีการใช้งานของคุณ หรือเพื่อเปิด API Explorer แบบเต็มหน้าจอที่ป้อนข้อมูลค่าเหล่านั้นไว้แล้ว การเปลี่ยนแปลงเหล่านี้มีจุดมุ่งหมายเพื่อให้คุณดูตัวอย่างโค้ดที่นำไปใช้โดยตรงกับกรณีการใช้งานที่คุณพยายามติดตั้งใช้งานในแอปพลิเคชันของคุณเองได้ง่ายขึ้น
ปัจจุบันตัวอย่างโค้ดรองรับ Java, JavaScript, PHP, Python และ curl
-
-
นอกจากนี้ เครื่องมือตัวอย่างโค้ดยังได้รับการอัปเดตด้วย UI ใหม่ที่มีฟีเจอร์เดียวกันทั้งหมดดังที่อธิบายไว้ข้างต้น เมื่อใช้เครื่องมือดังกล่าว คุณจะสามารถสำรวจกรณีการใช้งานสำหรับวิธีการต่างๆ, โหลดค่าลงใน API Explorer และเปิด API Explorer แบบเต็มหน้าจอเพื่อรับตัวอย่างโค้ดใน Java, JavaScript, PHP และ Python
การเปลี่ยนแปลงนี้ทำให้หน้าเว็บที่ก่อนหน้านี้แสดงรายการตัวอย่างโค้ดสำหรับ Java, JavaScript, PHP และ Python ถูกนำออกแล้ว
-
คู่มือเริ่มใช้งานฉบับย่อสำหรับ Java, JavaScript, PHP และ Python ได้รับการอัปเดตแล้ว คำแนะนำที่แก้ไขแล้วจะอธิบายวิธีเรียกใช้ตัวอย่าง 1 รายการกับคีย์ API และอีกตัวอย่างหนึ่งที่มีรหัสไคลเอ็นต์ OAuth 2.0 โดยใช้ตัวอย่างโค้ดจาก API Explorer
โปรดทราบว่าการเปลี่ยนแปลงที่อธิบายไว้ข้างต้นจะแทนที่เครื่องมือแบบอินเทอร์แอกทีฟที่มีการเพิ่มลงในเอกสารประกอบของ API ในปี 2017
9 กรกฎาคม 2018
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
อัปเดตคําจํากัดความของพร็อพเพอร์ตี้
snippet.thumbnails
ของทรัพยากรchannel
แล้ว โปรดทราบว่าเมื่อแสดงภาพขนาดย่อในแอปพลิเคชัน โค้ดของคุณควรใช้ URL รูปภาพเหมือนกับที่แสดงในการตอบกลับ API ทุกประการ ตัวอย่างเช่น แอปพลิเคชันของคุณไม่ควรใช้โดเมนhttp
แทนโดเมนhttps
ใน URL ที่ส่งคืนมาในการตอบสนองของ APIตั้งแต่เดือนกรกฎาคม 2018 เป็นต้นไป URL ภาพขนาดย่อของช่องจะใช้งานได้ในโดเมน
https
เท่านั้น ซึ่งเป็นลักษณะที่ URL จะปรากฏในการตอบกลับของ API หลังจากช่วงเวลาดังกล่าว คุณอาจเห็นรูปภาพที่ไม่สมบูรณ์ในแอปพลิเคชันหากระบบพยายามโหลดรูปภาพ YouTube จากโดเมนhttp
-
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
พร็อพเพอร์ตี้
recordingDetails.location.altitude
ของทรัพยากรvideo
เลิกใช้งานแล้ว ไม่มีการรับประกันว่าวิดีโอจะแสดงค่าของพร็อพเพอร์ตี้นี้ ในทํานองเดียวกัน แม้ว่าคําขอ API จะพยายามกําหนดค่าสําหรับพร็อพเพอร์ตี้นั้น แต่อาจไม่มีการจัดเก็บข้อมูลที่เข้ามา
22 มิถุนายน 2018
คู่มือการติดตั้งใช้งาน ซึ่งก่อนหน้านี้เรียกว่า คำแนะนำการติดตั้งใช้งานและการย้ายข้อมูลได้รับการอัปเดตเพื่อนำวิธีการย้ายข้อมูลจาก v2 API ไปยัง API v3 นอกจากนี้ยังได้นำคำแนะนำสำหรับฟีเจอร์ที่มีสิ่งต่อไปนี้ออกด้วย ตั้งแต่เลิกใช้งานแล้วใน API v3 เช่น วิดีโอโปรด
27 พฤศจิกายน 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
YouTube จะเลิกรองรับฟีเจอร์วิดีโอเด่นและเว็บไซต์เด่น ซึ่ง API รองรับผ่านออบเจ็กต์
invideoPromotion
ของแหล่งข้อมูลchannel
ด้วยเหตุนี้ ระบบจึงจะเลิกใช้งานออบเจ็กต์ดังกล่าว รวมถึงพร็อพเพอร์ตี้ย่อยทั้งหมดคุณยังเรียกและตั้งค่าข้อมูล
invideoPromotion
ได้จนถึงวันที่ 14 ธันวาคม 2017 สิ่งที่จะเกิดขึ้นหลังจากวันที่ดังกล่าว- การพยายามเรียกข้อมูลส่วน
invideoPromotion
เมื่อเรียกใช้channels.list
จะทำให้ระบบแสดงinvideoPromotion
ที่ว่างเปล่าหรือไม่แสดงผลข้อมูลinvideoPromotion
เลย - การพยายามอัปเดตข้อมูล
invideoPromotion
เมื่อโทรหาchannels.update
จะแสดงการตอบกลับที่สำเร็จจนถึงวันที่ 27 พฤษภาคม 2018 เป็นอย่างน้อย แต่จะถือว่าไม่มีการดำเนินการ ซึ่งหมายความว่าจะไม่มีการอัปเดตจริงๆ
หลังจากวันที่ 27 พฤษภาคม 2018 คำขอเหล่านี้อาจแสดงข้อความแสดงข้อผิดพลาดเพื่อระบุว่า
invalidPromotion
เป็นส่วนที่ไม่ถูกต้อง เป็นต้น - การพยายามเรียกข้อมูลส่วน
16 พฤศจิกายน 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ขณะนี้เครื่องมือข้อมูลโค้ดแบบโต้ตอบรองรับตัวอย่างโค้ด Node.js แล้ว ตัวอย่างยังปรากฏในเอกสารสำหรับเมธอด API เกือบทั้งหมด เช่น เมธอด
channels.list
ตัวอย่างที่ปรับแต่งได้ได้รับการออกแบบมาเพื่อให้จุดเริ่มต้นตามกรณีการใช้งานสำหรับแอปพลิเคชัน Node.js โดยเฉพาะ ฟังก์ชันการทำงานนี้จะคล้ายกับโค้ดในคู่มือเริ่มใช้งานฉบับย่อของ Node.js อย่างไรก็ตาม ตัวอย่างมีฟังก์ชันยูทิลิตีบางอย่างที่ไม่ปรากฏในการเริ่มต้นใช้งานอย่างรวดเร็ว:
- ฟังก์ชัน
removeEmptyParameters
จะใช้รายการคู่คีย์-ค่าที่สอดคล้องกับพารามิเตอร์คำขอ API และนำพารามิเตอร์ที่ไม่มีค่าออก - ฟังก์ชัน
createResource
จะใช้รายการคู่คีย์-ค่าที่เกี่ยวข้องกับพร็อพเพอร์ตี้ในทรัพยากร API จากนั้นจะแปลงพร็อพเพอร์ตี้เป็นออบเจ็กต์ JSON ที่ใช้ในการดำเนินการinsert
และupdate
ได้ ตัวอย่างด้านล่างแสดงชุดของชื่อพร็อพเพอร์ตี้และค่าต่างๆ และออบเจ็กต์ JSON ที่โค้ดจะสร้างให้# Key-value pairs: {'id': 'ABC123', 'snippet.title': 'Resource title', 'snippet.description': 'Resource description', 'status.privacyStatus': 'private'} # JSON object: { 'id': 'ABC123', 'snippet': { 'title': 'Resource title', 'description': 'Resource description', }, 'status': { 'privacyStatus': 'private' } }
ตัวอย่างทั้งหมดนี้ออกแบบมาเพื่อดาวน์โหลดและเรียกใช้ในเครื่อง สำหรับข้อมูลเพิ่มเติม โปรดดูข้อกำหนดเบื้องต้นสำหรับการเรียกใช้ตัวอย่างโค้ดแบบเต็มในเครื่องในวิธีการใช้เครื่องมือข้อมูลโค้ด
- ฟังก์ชัน
25 ตุลาคม 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตัวอย่างโค้ด Python ในเครื่องมือข้อมูลโค้ดแบบอินเทอร์แอกทีฟได้รับการอัปเดตให้ใช้ไลบรารี
google-auth
และgoogle-auth-oauthlib
แทนไลบรารีoauth2client
ซึ่งตอนนี้เลิกใช้งานแล้วนอกเหนือจากการเปลี่ยนแปลงดังกล่าว ตอนนี้เครื่องมือยังมอบตัวอย่างโค้ดที่สมบูรณ์สำหรับแอปพลิเคชัน Python ที่ติดตั้งและแอปพลิเคชันเว็บเซิร์ฟเวอร์ Python ซึ่งใช้ขั้นตอนการให้สิทธิ์ที่แตกต่างกันเล็กน้อย หากต้องการดูตัวอย่างทั้งหมด (และการเปลี่ยนแปลงนี้) ให้ทำดังนี้
- ไปที่เครื่องมือข้อมูลโค้ดแบบอินเทอร์แอกทีฟหรือเอกสารสำหรับเมธอด API เช่น เมธอด
channels.list
- คลิกแท็บ
Python
เหนือตัวอย่างโค้ด - คลิกปุ่มเปิด/ปิดเหนือแท็บเพื่อเปลี่ยนจากการแสดงตัวอย่างเป็นตัวอย่างแบบเต็ม
- ตอนนี้แท็บควรแสดงตัวอย่างโค้ดที่สมบูรณ์ที่ใช้ขั้นตอนการให้สิทธิ์
InstalledAppFlow
คำอธิบายเหนือตัวอย่างจะอธิบายเรื่องนี้ และยังลิงก์ไปยังตัวอย่างสำหรับแอปพลิเคชันเว็บเซิร์ฟเวอร์ - คลิกลิงก์เพื่อเปลี่ยนเป็นตัวอย่างเว็บเซิร์ฟเวอร์ ตัวอย่างดังกล่าวใช้เฟรมเวิร์กเว็บแอปพลิเคชัน Flask และขั้นตอนการให้สิทธิ์ที่แตกต่างกัน
ตัวอย่างทั้งหมดนี้ออกแบบมาเพื่อดาวน์โหลดและเรียกใช้ในเครื่อง หากต้องการเรียกใช้ตัวอย่าง โปรดดูวิธีการเรียกใช้ตัวอย่างโค้ดแบบเต็มในเครื่องในวิธีการใช้เครื่องมือข้อมูลโค้ด
- ไปที่เครื่องมือข้อมูลโค้ดแบบอินเทอร์แอกทีฟหรือเอกสารสำหรับเมธอด API เช่น เมธอด
29 สิงหาคม 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
- อัปเดตคําจํากัดความของพารามิเตอร์
forContentOwner
ของเมธอดsearch.list
แล้วโปรดทราบว่าหากตั้งค่าพารามิเตอร์เป็นtrue
พารามิเตอร์type
จะต้องตั้งค่าเป็นvideo
- อัปเดตคําจํากัดความของพารามิเตอร์
regionCode
ของเมธอดsearch.list
เพื่อชี้แจงว่าพารามิเตอร์จํากัดผลการค้นหาให้แสดงเฉพาะวิดีโอที่ดูได้ในภูมิภาคที่ระบุ - YouTube ได้อัปเดตโลโก้และไอคอนการสร้างแบรนด์ "พัฒนาด้วย YouTube" ใหม่ ดาวน์โหลดโลโก้ได้จากหน้าหลักเกณฑ์การสร้างแบรนด์ โลโก้และไอคอน YouTube ใหม่อื่นๆ จะแสดงอยู่ในหน้านั้นเช่นกัน และสามารถดาวน์โหลดได้จากเว็บไซต์แบรนด์ YouTube
24 กรกฎาคม 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
- คู่มือเริ่มใช้งานฉบับย่อสำหรับ Data API ของ YouTube ใหม่พร้อมใช้งานแล้วสำหรับ iOS คำแนะนำนี้จะอธิบายวิธีใช้ API ข้อมูลของ YouTube ในแอปพลิเคชัน iOS แบบง่ายที่เขียนด้วย Objective-C หรือ Swift
- ตอนนี้เครื่องมือข้อมูลโค้ดแบบอินเทอร์แอกทีฟสำหรับ YouTube Data API มีเอกสารที่อธิบายฟีเจอร์บางอย่างของเครื่องมือ ดังนี้
- การดำเนินการคำขอ API
- การสลับระหว่างข้อมูลโค้ดและตัวอย่างโค้ดแบบเต็ม
- การใช้ฟังก์ชันสำเร็จรูป
- กำลังโหลดทรัพยากรที่มีอยู่ (สำหรับวิธีการอัปเดต)
หมายเหตุ: เครื่องมือนี้ยังฝังอยู่ในเอกสารอ้างอิง API สำหรับเมธอด API ด้วย (ตัวอย่าง)
1 มิถุนายน 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
พร็อพเพอร์ตี้ทรัพยากร
video
รายการต่อไปนี้อยู่ระหว่างการเลิกใช้งาน แม้ว่าระบบจะรองรับพร็อพเพอร์ตี้จนถึงวันที่ 1 ธันวาคม 2017 แต่ก็ไม่มีการรับประกันว่าวิดีโอจะแสดงค่าของพร็อพเพอร์ตี้เหล่านั้นต่อไปจนกว่าจะถึงวันดังกล่าว ในทํานองเดียวกัน คําขอvideos.insert
และvideos.update
ที่กําหนดค่าพร็อพเพอร์ตี้เหล่านั้นจะไม่สร้างข้อผิดพลาดก่อนวันที่ดังกล่าว แต่ก็เป็นไปได้ว่าระบบจะไม่จัดเก็บข้อมูลที่เข้ามาใหม่
17 พฤษภาคม 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เอกสารอ้างอิง API ได้รับการอัปเดตเพื่อทำให้ข้อมูลโค้ดสามารถใช้งานได้อย่างแพร่หลายและโต้ตอบได้มากขึ้น ตอนนี้หน้าเว็บที่อธิบายวิธี API เช่น
channels.list
หรือvideos.rate
มีเครื่องมือแบบอินเทอร์แอกทีฟที่ให้คุณดูและปรับแต่งข้อมูลโค้ดใน Java, JavaScript, PHP, Python, Ruby, Apps Script และ Goสำหรับวิธีการหนึ่งๆ เครื่องมือจะแสดงข้อมูลโค้ดสำหรับ Use Case อย่างน้อย 1 กรณี และแต่ละ Use Case จะอธิบายถึงวิธีการทั่วไปในการเรียกใช้เมธอดนั้น เช่น คุณสามารถเรียกใช้เมธอด
channels.list
เพื่อดึงข้อมูลเกี่ยวกับแชแนลที่เจาะจงหรือเกี่ยวกับแชแนลของผู้ใช้ปัจจุบันนอกจากนี้ คุณยังโต้ตอบกับตัวอย่างโค้ดได้ด้วย โดยทำดังนี้
-
แก้ไขค่าพารามิเตอร์และพร็อพเพอร์ตี้ จากนั้นข้อมูลโค้ดจะอัปเดตแบบไดนามิกเพื่อแสดงค่าที่คุณระบุ
-
สลับระหว่างข้อมูลโค้ดและตัวอย่างแบบเต็ม ข้อมูลโค้ดแสดงส่วนของโค้ดที่เรียกใช้เมธอด API ตัวอย่างแบบเต็มมีข้อมูลโค้ดดังกล่าวและโค้ดสำเร็จรูปสำหรับการให้สิทธิ์และส่งคำขอ คุณจะคัดลอกตัวอย่างและเรียกใช้จากบรรทัดคำสั่งหรือเว็บเซิร์ฟเวอร์ภายในเครื่องได้
-
ดำเนินการกับคำขอโดยคลิกปุ่ม (หากต้องการดำเนินการตามคำขอ คุณต้องให้สิทธิ์เครื่องมือในการเรียก API ในนามของคุณ)
โปรดทราบว่าเครื่องมือนี้ได้แทนที่ API Explorer บนหน้าเว็บที่มีให้บริการ (แต่ละหน้าจะแสดงลิงก์เพื่อให้คุณมีทางเลือกในการโหลดคำขอที่คุณกำลังทำใน API Explorer)
-
-
นอกจากนี้ เครื่องมือข้อมูลโค้ด API ข้อมูลยังได้รับการอัปเดตด้วย UI ใหม่ที่มีฟีเจอร์เดียวกันทั้งหมดดังที่อธิบายไว้ข้างต้น ฟีเจอร์ใหม่หลักๆ ที่มีอยู่ในหน้านี้มีดังนี้
- การรองรับคำขอ API ที่เขียนข้อมูล
- สนับสนุนตัวอย่าง Java
- โค้ดต้นแบบที่ยืดหยุ่นและครอบคลุมมากกว่าสำหรับการให้สิทธิ์ผู้ใช้และการสร้างคำขอ API
27 เมษายน 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
- คู่มือเริ่มใช้งานฉบับย่อใหม่อธิบายวิธีตั้งค่าแอปพลิเคชันง่ายๆ ที่สร้างคำขอ API ข้อมูลของ YouTube ปัจจุบันมีคำแนะนำที่พร้อมใช้งานสำหรับ Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python และ Ruby
30 มีนาคม 2017
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
- พร็อพเพอร์ตี้
topicDetails.topicCategories[]
ใหม่ของทรัพยากรchannel
มีรายการ URL ของ Wikipedia ที่อธิบายเนื้อหาของช่อง URL ที่สอดคล้องกับรหัสหัวข้อที่แสดงในพร็อพเพอร์ตี้topicDetails.topicIds[]
ของทรัพยากร - พร็อพเพอร์ตี้
contentDetails.videoPublishedAt
ใหม่ของทรัพยากรplaylistItem
จะระบุเวลาที่มีการเผยแพร่วิดีโอไปยัง YouTube ทรัพยากรมีพร็อพเพอร์ตี้snippet.publishedAt
อยู่แล้ว ซึ่งระบุเวลาที่เพิ่มรายการลงในเพลย์ลิสต์ - เช่นเดียวกับแหล่งข้อมูล
channel
ตอนนี้ทรัพยากรvideo
จะแสดงพร็อพเพอร์ตี้topicDetails.topicCategories[]
ซึ่งมีรายการ URL ของ Wikipedia ที่อธิบายเนื้อหาของวิดีโอ สำหรับทรัพยากรvideo
นั้น URL จะตรงกับรหัสหัวข้อที่แสดงในพร็อพเพอร์ตี้topicDetails.relevantTopicIds[]
ของทรัพยากร - พร็อพเพอร์ตี้
contentDetails.contentRating.mpaatRating
ใหม่ของทรัพยากรvideo
ระบุการจัดประเภทที่สมาคมภาพยนตร์แห่งสหรัฐอเมริกาให้กับตัวอย่างหรือตัวอย่างภาพยนตร์
27 กุมภาพันธ์ 2017
ตามที่ได้ประกาศไปเมื่อวันที่ 11 สิงหาคม 2016 YouTube ได้เปลี่ยนรายการรหัสหัวข้อที่รองรับไปยังรายการที่มีการดูแลจัดการ รายการรหัสหัวข้อที่รองรับทั้งหมดรวมอยู่ในพร็อพเพอร์ตี้ topicDetails
สำหรับทรัพยากร channel
และ video
รวมถึงในพารามิเตอร์ topicId
ของเมธอด search.list
โปรดทราบว่ามีการเปลี่ยนแปลงหลายรายการในรายการที่มีการดูแลจัดการ
- เพิ่มหัวข้อต่อไปนี้เป็นหัวข้อย่อยของ
Society
แล้ว:ชื่อ รหัสหัวข้อ ธุรกิจ /m/09s1f
สุขภาพ /m/0kt51
การทหาร /m/01h6rj
การเมือง /m/05qt0
ศาสนา /m/06bvp
- หัวข้อ
Animated cartoon
ซึ่งก่อนหน้านี้เป็นส่วนย่อยของEntertainment
ถูกนำออกแล้ว - หัวข้อ
Children's music
ซึ่งก่อนหน้านี้เป็นส่วนย่อยของMusic
ถูกนำออกแล้ว
การเปลี่ยนแปลงนี้ทำให้หัวข้อที่เกี่ยวข้องกับวิดีโอแสดงผลในค่าพร็อพเพอร์ตี้ topicDetails.relevantTopicIds[]
ของทรัพยากร video
เสมอ
29 พฤศจิกายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
มีการเปลี่ยนแปลงเล็กน้อย 3 อย่างในรายการรหัสหัวข้อที่จะรองรับในวันที่ 10 กุมภาพันธ์ 2017 ดังนี้
- หมวดหมู่
Professional wrestling
ซึ่งก่อนหน้านี้เคยเป็นหมวดหมู่ย่อยของหมวดหมู่Sports
ได้เปลี่ยนเป็นย่อยของEntertainment
แล้ว - หมวดหมู่
TV shows
ซึ่งเป็นรายการย่อยของEntertainment
เป็นหมวดหมู่ใหม่ - หมวดหมู่
Health
ซึ่งก่อนหน้านี้เป็นส่วนย่อยของLifestyle
ถูกนำออกแล้ว
โปรดทราบว่ายังมีหมวดหมู่หลักอยู่ 2-3 หมวดหมู่ (
Entertainment
,Gaming
,Lifestyle
,Music
และSports
) วิดีโอใดๆ ที่เชื่อมโยงกับหมวดหมู่ย่อย เช่นTennis
จะเชื่อมโยงกับหมวดหมู่หลัก (Sports
) ด้วย - หมวดหมู่
10 พฤศจิกายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตามที่ประกาศครั้งแรกในวันที่ 11 สิงหาคม 2016 การเลิกใช้งาน Freebase และ Freebase API จำเป็นต้องมีการเปลี่ยนแปลงหลายอย่างที่เกี่ยวข้องกับรหัสหัวข้อ รหัสหัวข้อจะระบุหัวข้อที่เชื่อมโยงกับแหล่งข้อมูล
channel
และvideo
นอกจากนี้ คุณยังใช้พารามิเตอร์การค้นหาtopicId
เพื่อค้นหาช่องหรือวิดีโอที่เกี่ยวข้องกับหัวข้อที่เจาะจงได้ด้วยในวันที่ 10 กุมภาพันธ์ 2017 YouTube จะเริ่มส่งคืนรหัสหัวข้อชุดเล็กๆ แทนชุดรหัสที่ละเอียดยิ่งขึ้นที่แสดงผลจนถึงปัจจุบัน นอกจากนี้ โปรดทราบว่าเราไม่รับประกันว่าช่องและวิดีโอจะเชื่อมโยงกับหัวข้อใดๆ ซึ่งสอดคล้องกับลักษณะการทำงานของ API ในปัจจุบัน
เราได้อัปเดตคำจำกัดความของพารามิเตอร์และพร็อพเพอร์ตี้ของ API ต่อไปนี้เพื่อแสดงรหัสหัวข้อที่จะรองรับหลังจากนั้น เพื่อให้เตรียมไคลเอ็นต์ API ให้พร้อมสำหรับการเปลี่ยนแปลงเหล่านั้น โปรดทราบว่ารายการหมวดหมู่จะเหมือนกันสำหรับพร็อพเพอร์ตี้ทั้งหมด
- พร็อพเพอร์ตี้
topicDetails.topicIds[]
ของทรัพยากรchannel
- พร็อพเพอร์ตี้
topicDetails.relevantTopicIds[]
ของทรัพยากรvideo
- พารามิเตอร์
topicId
ของเมธอดsearch.list
- พร็อพเพอร์ตี้
-
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
โดยเราจะเลิกใช้งานพร็อพเพอร์ตี้ต่อไปนี้
- พร็อพเพอร์ตี้
topicDetails.topicIds[]
ของทรัพยากรchannel
โดยจะรองรับพร็อพเพอร์ตี้นี้จนถึงวันที่ 10 พฤศจิกายน 2017 - พร็อพเพอร์ตี้
topicDetails.relevantTopicIds[]
ของทรัพยากรvideo
โดยจะรองรับพร็อพเพอร์ตี้นี้จนถึงวันที่ 10 พฤศจิกายน 2017 - พร็อพเพอร์ตี้
topicDetails.topicIds[]
ของทรัพยากรvideo
พร็อพเพอร์ตี้นี้จะไม่มีค่าหลังจากวันที่ 10 กุมภาพันธ์ 2017 (หลังจากวันที่ดังกล่าว ค่าพร็อพเพอร์ตี้topicDetails.relevantTopicIds[]
จะระบุหัวข้อทั้งหมดที่เชื่อมโยงกับวิดีโอ)
- พร็อพเพอร์ตี้
-
เนื่องจาก Freebase เลิกใช้งานแล้ว เราจึงนำคำแนะนำการค้นหาด้วยหัวข้อ Freebase ออกจากเอกสารประกอบ คู่มือดังกล่าวให้ตัวอย่างโค้ดเพื่อแสดงให้เห็นว่าแอปพลิเคชันจะทำงานร่วมกับ Freebase API อย่างไร
นอกจากนี้ยังได้นำตัวอย่างโค้ดหลายรายการที่เกี่ยวข้องกับรหัสหัวข้อออกจากเอกสารประกอบของเมธอด
search.list
ด้วย
2 พฤศจิกายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
พร็อพเพอร์ตี้และพารามิเตอร์ใหม่
-
แหล่งข้อมูล
video
มีพร็อพเพอร์ตี้ใหม่หลายรายการ ดังนี้-
พร็อพเพอร์ตี้
player.embedHtml
มีแท็ก<iframe>
ที่ใช้ฝังโปรแกรมเล่นที่เล่นวิดีโอได้ พร็อพเพอร์ตี้player.embedHeight
และplayer.embedWidth
ใหม่จะระบุขนาดของโปรแกรมเล่นแบบฝัง ระบบจะแสดงพร็อพเพอร์ตี้เหล่านี้หากคำขอ API ระบุค่าของพารามิเตอร์maxHeight
หรือmaxWidth
อย่างน้อย 1 รายการ พารามิเตอร์ใหม่ทั้ง 2 รายการดังกล่าวจะอธิบายภายหลังในรายการประวัติการแก้ไขนี้ -
พร็อพเพอร์ตี้
hasCustomThumbnail
ใหม่ระบุว่าผู้อัปโหลดวิดีโอได้ให้ภาพขนาดย่อที่กำหนดเองสำหรับวิดีโอหรือไม่ โปรดทราบว่าพร็อพเพอร์ตี้นี้แสดงต่อผู้อัปโหลดวิดีโอเท่านั้น -
fpbRatingReasons[]
ใหม่ระบุเหตุผลที่วิดีโอได้รับคะแนน FPB (แอฟริกาใต้) -
mcstRating
ใหม่ระบุการจัดประเภทที่วิดีโอได้รับในเวียดนาม
-
-
เมธอด
videos.list
รองรับพารามิเตอร์ใหม่ 2 รายการ คือmaxHeight
และmaxWidth
คุณจะใช้พารามิเตอร์ตัวใดตัวหนึ่งหรือทั้ง 2 พารามิเตอร์ก็ได้เมื่อดึงข้อมูลส่วนplayer
ในทรัพยากรvideo
โดยค่าเริ่มต้น ความสูงของ
<iframe>
ที่แสดงผลในพร็อพเพอร์ตี้player.embedHtml
คือ 360 พิกเซล ความกว้างจะปรับให้ตรงกับอัตราส่วนของวิดีโอ ช่วยให้มั่นใจได้ว่าโปรแกรมเล่นแบบฝังไม่มีแถบสีดำล้อมรอบวิดีโอ ตัวอย่างเช่น หากสัดส่วนภาพของวิดีโอคือ 16:9 ความกว้างของโปรแกรมเล่นจะเท่ากับ 640 พิกเซลพารามิเตอร์ใหม่นี้จะช่วยให้คุณสามารถระบุขนาดที่แทนค่าเริ่มต้น โค้ดสำหรับฝังควรใช้ความสูงและ/หรือความกว้างที่เหมาะสมสำหรับการจัดวางของแอปพลิเคชัน เซิร์ฟเวอร์ API จะปรับขนาดของโปรแกรมเล่นตามความเหมาะสมเพื่อให้มั่นใจว่าโปรแกรมเล่นที่ฝังไว้ไม่มีแถบสีดำล้อมรอบวิดีโอ โปรดทราบว่าพารามิเตอร์ทั้งสองจะระบุขนาดสูงสุดของโปรแกรมเล่นแบบฝัง ดังนั้น หากระบุพารามิเตอร์ทั้งคู่ มิติข้อมูลหนึ่งอาจยังคงน้อยกว่าจำนวนสูงสุดที่อนุญาตสำหรับมิติข้อมูลนั้น
ตัวอย่างเช่น สมมติว่าวิดีโอมีอัตราส่วน 16:9 ดังนั้น แท็ก
player.embedHtml
จะมีโปรแกรมเล่นขนาด 640x360 หากไม่มีการตั้งค่าพารามิเตอร์maxHeight
หรือmaxWidth
- หากตั้งค่าพารามิเตอร์
maxHeight
เป็น720
และไม่ได้ตั้งค่าพารามิเตอร์maxWidth
ไว้ API จะแสดงผลโปรแกรมเล่นขนาด 1280x720 - หากตั้งค่าพารามิเตอร์
maxWidth
เป็น960
และไม่ได้ตั้งค่าพารามิเตอร์maxHeight
ไว้ API จะแสดงผลโปรแกรมเล่น 960x540 - หากตั้งค่าพารามิเตอร์
maxWidth
เป็น960
และตั้งพารามิเตอร์maxHeight
เป็น450
API จะแสดงผลเป็นโปรแกรมเล่น 800x450
พร็อพเพอร์ตี้
player.embedHeight
และplayer.embedWidth
ใหม่ซึ่งอธิบายไว้ข้างต้นจะระบุมิติข้อมูลของโปรแกรมเล่น - หากตั้งค่าพารามิเตอร์
-
-
การอัปเดตเมธอด พร็อพเพอร์ตี้ และพารามิเตอร์ที่มีอยู่
-
ระบบได้อัปเดตคำอธิบายแหล่งข้อมูล
channelSection
แล้ว โปรดทราบว่าช่องทางสามารถสร้างชั้นวางได้สูงสุด 10 ชั้นโดยไม่ต้องตั้งค่าข้อมูลการกำหนดเป้าหมาย และสร้างชั้นวางได้สูงสุด 100 ชั้นที่มีข้อมูลการกำหนดเป้าหมายนอกจากนี้ พร็อพเพอร์ตี้
targeting
ของทรัพยากรchannelSection
ได้รับการอัปเดตเพื่อแสดงข้อเท็จจริงที่ว่าตัวเลือกการกำหนดเป้าหมายจะตั้งค่าได้โดยใช้ API เท่านั้น ตัวเลือกการกำหนดเป้าหมายจะถูกลบหากมีการแก้ไขส่วนช่องโดยใช้อินเทอร์เฟซผู้ใช้บนเว็บไซต์ YouTube -
แก้ไขคำจำกัดความของพร็อพเพอร์ตี้
snippet.name
ของทรัพยากรi18nLanguage
แล้ว เพื่อแสดงให้เห็นว่าค่านั้นแทนชื่อภาษาตามที่เขียนในภาษาที่ระบุโดยพารามิเตอร์hl
ของเมธอดi18nLanguage.list
-
อัปเดตพร็อพเพอร์ตี้
contentDetails.note
ของทรัพยากรplaylistItem
แล้วโปรดทราบว่าความยาวสูงสุดของค่าพร็อพเพอร์ตี้คือ 280 อักขระ -
พร็อพเพอร์ตี้
contentDetails.startAt
และcontentDetails.endAt
ของทรัพยากรplaylistItem
เลิกใช้งานแล้ว ระบบจะไม่สนใจช่องเหล่านี้หากมีการตั้งค่าไว้ในคำขอplaylistItems.insert
หรือplaylistItems.update
-
ขณะนี้เมธอด
playlistItems.delete
และplaylistItems.update
รองรับพารามิเตอร์onBehalfOfContentOwner
แล้ว ซึ่งวิธีอื่นๆ นั้นรองรับอยู่แล้ว คำขอที่ใช้วิธีการดังกล่าวต้องได้รับอนุญาตด้วยโทเค็นที่ให้สิทธิ์เข้าถึงขอบเขตhttps://www.googleapis.com/auth/youtubepartner
ด้วย -
อัปเดตทั้งพารามิเตอร์
publishedBefore
และpublishedAfter
ของเมธอดsearch.list
เพื่อระบุว่ารวมค่าพารามิเตอร์แล้ว เช่น หากตั้งค่าพารามิเตอร์publishedBefore
ไว้ API จะแสดงผลทรัพยากรที่สร้างก่อนหรือเวลาที่ระบุ -
พร็อพเพอร์ตี้
contentDetails.contentRating.grfilmRating
ของทรัพยากรvideo
รองรับค่าเพิ่มเติม 3 ค่า ได้แก่grfilmK12
,grfilmK15
และgrfilmK18
-
อัปเดตคำอธิบายเมธอด
videos.insert
แล้ว โปรดทราบว่าขนาดไฟล์สูงสุดของวิดีโอที่อัปโหลดเพิ่มขึ้นจาก 64GB เป็น 128GB
-
-
ข้อผิดพลาดใหม่และอัปเดต
-
API รองรับข้อผิดพลาดใหม่ต่อไปนี้
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย forbidden (403)
homeParameterDeprecated
เมธอด activities.list
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าข้อมูลกิจกรรมในหน้าแรกของผู้ใช้ไม่พร้อมใช้งานผ่าน API นี้ ข้อผิดพลาดนี้อาจเกิดขึ้นหากคุณตั้งค่าพารามิเตอร์home
เป็นtrue
ในคำขอที่ไม่ได้รับอนุญาตinvalidValue (400)
invalidContentDetails
เมธอด playlistItems.insert
จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าออบเจ็กต์contentDetails
ในคำขอไม่ถูกต้อง สาเหตุหนึ่งที่ทำให้เกิดข้อผิดพลาดนี้คือช่องcontentDetails.note
ยาวเกิน 280 อักขระforbidden (403)
watchHistoryNotAccessible
เมธอด playlistItems.list
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าคำขอพยายามเรียกข้อมูล "ประวัติการดู" รายการเพลย์ลิสต์ แต่ไม่สามารถดึงข้อมูลโดยใช้ APIforbidden (403)
watchLaterNotAccessible
เมธอด playlistItems.list
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าคำขอพยายามเรียกข้อมูล "ดูภายหลัง" รายการเพลย์ลิสต์ แต่ไม่สามารถดึงข้อมูลโดยใช้ APIbadRequest (400)
uploadLimitExceeded
เมธอด videos.insert
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าช่องมีวิดีโอเกินจำนวนที่สามารถอัปโหลดได้forbidden (403)
forbiddenEmbedSetting
เมธอด videos.update
จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าคำขอ API พยายามตั้งค่าการฝังที่ไม่ถูกต้องสำหรับวิดีโอ โปรดทราบว่าบางช่องอาจไม่มีสิทธิ์เสนอโปรแกรมเล่นแบบฝังสำหรับสตรีมแบบสด ดูข้อมูลเพิ่มเติมได้ที่ศูนย์ช่วยเหลือของ YouTube -
เมธอด
playlistItems.insert
จะไม่แสดงผลข้อผิดพลาดอีกต่อไปหากคุณแทรกวิดีโอที่ซ้ำกันลงในเพลย์ลิสต์ ข้อผิดพลาดดังกล่าวเกิดขึ้นก่อนหน้านี้ในเพลย์ลิสต์บางรายการ เช่น วิดีโอรายการโปรด ซึ่งไม่อนุญาตให้มีรายการซ้ำ แต่ระบบไม่สนับสนุนอีกต่อไป โดยทั่วไปแล้ว เพลย์ลิสต์อนุญาตให้มีวิดีโอที่ซ้ำกันได้
-
-
ข้อมูลอัปเดตอื่นๆ
-
รายการประวัติการแก้ไขสำหรับวันที่ 15 กันยายน 2016 ได้รับการอัปเดตเพื่อชี้แจงว่าเมื่อใดก็ตามที่มีพร็อพเพอร์ตี้
contentDetails.relatedPlaylists.watchHistory
และcontentDetails.relatedPlaylists.watchLater
ของทรัพยากรchannel
รวมอยู่ในคำตอบ ทรัพยากรเหล่านี้จะมีค่าHL
และWL
ตามลำดับเสมอ นอกจากนี้ พร็อพเพอร์ตี้ดังกล่าวจะรวมเฉพาะในกรณีที่ผู้ใช้ที่ได้รับอนุญาตกำลังดึงข้อมูลเกี่ยวกับช่องของผู้ใช้เอง
-
15 กันยายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เมื่อวันที่ 11 สิงหาคม 2016 การอัปเดตประวัติการแก้ไขกล่าวถึงการเปลี่ยนแปลงหลายอย่างที่เกี่ยวข้องกับรหัสหัวข้อ รวมถึงข้อเท็จจริงที่ว่าชุดรหัสหัวข้อที่รองรับจะมีการเปลี่ยนแปลงตั้งแต่วันที่ 10 กุมภาพันธ์ 2017 รายการหัวข้อที่จะได้รับการสนับสนุนจะเผยแพร่ภายในวันที่ 10 พฤศจิกายน 2016
-
การเปลี่ยนแปลงต่อไปนี้มีผลแล้ว เราได้ส่งประกาศไว้ในการอัปเดตประวัติการแก้ไขเมื่อวันที่ 11 สิงหาคม 2016 ดังนี้
-
หากมีการเรียกเมธอด
activities.list
โดยตั้งค่าพารามิเตอร์home
เป็นtrue
ตอนนี้การตอบกลับจาก API จะมีรายการที่คล้ายกับที่ผู้ใช้ YouTube ที่ออกจากระบบแล้วจะเห็นในหน้าแรกนี่เป็นการเปลี่ยนแปลงเล็กน้อยที่มีจุดประสงค์เพื่อมอบประสบการณ์ของผู้ใช้ที่ดีกว่าลักษณะการทำงานที่อธิบายไว้ในการอัปเดตประวัติการแก้ไขเมื่อวันที่ 11 สิงหาคม 2016 การอัปเดตดังกล่าวระบุว่าคำขอที่ใช้พารามิเตอร์
home
จะส่งกลับรายการที่ว่างเปล่า -
ตอนนี้พร็อพเพอร์ตี้
contentDetails.relatedPlaylists.watchHistory
และcontentDetails.relatedPlaylists.watchLater
ของทรัพยากรchannel
มีค่าHL
และWL
สำหรับแชแนลทั้งหมดตามลำดับเราขอกล่าวย้ำเพื่อความชัดเจนว่าพร็อพเพอร์ตี้เหล่านี้จะแสดงต่อผู้ใช้ที่ได้รับอนุญาตซึ่งดึงข้อมูลเกี่ยวกับช่องของผู้ใช้เองเท่านั้น พร็อพเพอร์ตี้จะมีค่า
HL
และWL
เสมอ แม้แต่สำหรับผู้ใช้ที่ได้รับอนุญาตซึ่งดึงข้อมูลเกี่ยวกับช่องของผู้ใช้เองก็ตาม ดังนั้น รหัสเพลย์ลิสต์สำหรับประวัติการดูและดูภายหลังจะใช้ผ่าน API ไม่ได้นอกจากนี้ ตอนนี้คำขอเรียกดูรายละเอียดของเพลย์ลิสต์ (
playlists.list
) หรือรายการเพลย์ลิสต์ (playlistItems.list
) สำหรับประวัติการดูหรือเพลย์ลิสต์ดูภายหลังของช่องจะแสดงรายการที่ว่างเปล่า ลักษณะการทำงานนี้เป็นจริงสำหรับค่าใหม่HL
และWL
ตลอดจนรหัสเพลย์ลิสต์สำหรับประวัติการดูหรือดูภายหลังซึ่งไคลเอ็นต์ API ของคุณอาจจัดเก็บไว้แล้ว
-
-
ระบบจะไม่แสดงผลออบเจ็กต์
fileDetails.recordingLocation
ของทรัพยากรvideo
และพร็อพเพอร์ตี้ย่อยอีกต่อไป ก่อนหน้านี้มีเพียงเจ้าของวิดีโอเท่านั้นที่ดึงข้อมูลนี้ได้ (เช่น ออบเจ็กต์fileDetails
ระดับบนสุด)
11 สิงหาคม 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ข้อกำหนดในการให้บริการของบริการ API ของ YouTube ที่เผยแพร่ใหม่ ("ข้อกำหนดฉบับปรับปรุง") ซึ่งได้อธิบายไว้อย่างละเอียดในบล็อกวิศวกรรมและนักพัฒนาซอฟต์แวร์ YouTube จะให้ข้อมูลอัปเดตมากมายสำหรับข้อกำหนดในการให้บริการปัจจุบัน นอกเหนือจากข้อกำหนดฉบับปรับปรุงซึ่งจะมีผลบังคับใช้ตั้งแต่วันที่ 10 กุมภาพันธ์ 2017 แล้ว การปรับปรุงครั้งนี้ยังมีเอกสารสนับสนุนอื่นๆ ที่จะช่วยอธิบายนโยบายที่นักพัฒนาซอฟต์แวร์ต้องปฏิบัติตามด้วย
เอกสารใหม่ทั้งชุดจะอธิบายไว้ในประวัติการแก้ไขสำหรับข้อกำหนดที่ปรับปรุง นอกจากนี้ การเปลี่ยนแปลงข้อกำหนดที่อัปเดตในอนาคตหรือเอกสารสนับสนุนเหล่านั้นจะมีการอธิบายไว้ในประวัติการแก้ไขดังกล่าวด้วย คุณสามารถสมัครรับข้อมูลการเปลี่ยนแปลงรายการฟีด RSS ในประวัติการแก้ไขดังกล่าวจากลิงก์ในเอกสารนั้น
-
การเลิกใช้งาน Freebase และ Freebase API ทําให้เกิดการเปลี่ยนแปลงหลายรายการที่เกี่ยวข้องกับรหัสหัวข้อ รหัสหัวข้อจะใช้ในเมธอดและทรัพยากรของ API ต่อไปนี้
- ส่วน
topicDetails
ของแหล่งข้อมูลchannel
ระบุหัวข้อที่เกี่ยวข้องกับช่อง - ส่วน
topicDetails
ของแหล่งข้อมูลvideo
ระบุหัวข้อที่เกี่ยวข้องกับวิดีโอดังกล่าว - พารามิเตอร์
topicId
ของเมธอดsearch.list
ช่วยให้คุณค้นหาวิดีโอหรือช่องที่เกี่ยวข้องกับหัวข้อที่เฉพาะเจาะจงได้
การเปลี่ยนแปลงในฟีเจอร์เหล่านี้ ได้แก่
-
ตั้งแต่วันที่ 10 กุมภาพันธ์ 2017 เป็นต้นไป YouTube จะเริ่มส่งคืนรหัสหัวข้อชุดเล็กๆ แทนชุดรหัสที่ละเอียดยิ่งขึ้นที่แสดงผลจนถึงปัจจุบัน ชุดหัวข้อที่รองรับดังกล่าวจะระบุการจัดหมวดหมู่ระดับสูง เช่น กีฬาหรือบาสเกตบอล แต่จะไม่มีการระบุทีมหรือผู้เล่นที่เฉพาะเจาะจง เป็นต้น เราจะประกาศชุดหัวข้อที่รองรับเพื่อให้คุณมีเวลาเตรียมการสมัครสำหรับการเปลี่ยนแปลงนี้
-
รหัสหัวข้อ Freebase ที่คุณดึงข้อมูลแล้วสามารถใช้เพื่อค้นหาเนื้อหาได้จนถึงวันที่ 10 กุมภาพันธ์ 2017 แต่หลังจากนั้น คุณจะสามารถใช้ได้เฉพาะหัวข้อขนาดเล็กที่ระบุไว้ในรายการก่อนหน้าเพื่อเรียกดูผลการค้นหาตามหัวข้อ
-
หลังจากวันที่ 10 กุมภาพันธ์ 2017 หากคุณพยายามค้นหาผลลัพธ์โดยใช้รหัสหัวข้อที่ไม่ได้อยู่ในชุดรหัสหัวข้อที่รองรับที่เล็กกว่านี้ API จะแสดงผลชุดผลลัพธ์ที่ว่างเปล่า
- ส่วน
-
เราจะเลิกใช้งานช่องและพารามิเตอร์ API หลายรายการในวันที่ 12 กันยายน 2016 ดังนี้
-
พารามิเตอร์
home
ของเมธอดactivities.list
ทำให้ผู้ใช้ที่ได้รับอนุญาตสามารถเรียกฟีดกิจกรรมที่จะแสดงบนหน้าแรกของ YouTube สำหรับผู้ใช้รายนั้น คำขอที่ใช้พารามิเตอร์นี้หลังจากวันที่ 12 กันยายน 2016 จะแสดงรายการที่ว่างเปล่า -
พร็อพเพอร์ตี้
contentDetails.relatedPlaylists.watchHistory
และcontentDetails.relatedPlaylists.watchLater
ของทรัพยากรchannel
จะปรากฏแก่ผู้ใช้ที่ได้รับอนุญาตซึ่งดึงข้อมูลเกี่ยวกับช่องของผู้ใช้เองเท่านั้น หลังจากวันที่ 12 กันยายน 2016 ค่าcontentDetails.relatedPlaylists.watchHistory
จะแสดงผลค่าHL
และพร็อพเพอร์ตี้contentDetails.relatedPlaylists.watchLater
จะแสดงผลค่าWL
สำหรับทุกแชแนลคำขอเรียกดูรายละเอียดของเพลย์ลิสต์ (
playlists.list
) สำหรับประวัติการดูหรือเพลย์ลิสต์ดูภายหลังของช่องจะแสดงรายการที่ว่างเปล่าหลังจากวันที่ 12 กันยายน 2016 คำขอเรียกรายการเพลย์ลิสต์ (playlistItems.list
) ในเพลย์ลิสต์ใดเพลย์ลิสต์หนึ่งเหล่านี้จะแสดงรายการที่ว่างเปล่าหลังจากวันดังกล่าว ค่านี้เป็นจริงสำหรับค่าใหม่HL
และWL
ตลอดจนรหัสเพลย์ลิสต์สำหรับประวัติการดูหรือดูภายหลังทั้งหมดซึ่งไคลเอ็นต์ API ของคุณอาจจัดเก็บไว้แล้ว -
ออบเจ็กต์
fileDetails.recordingLocation
ของทรัพยากรvideo
หรือพร็อพเพอร์ตี้ย่อยของทรัพยากรดังกล่าวจะไม่แสดงอีกต่อไปหลังจากวันที่ 12 กันยายน 2016 เฉพาะเจ้าของวิดีโอเท่านั้นที่สามารถดึงข้อมูลนี้ได้ เนื่องจากมีเพียงเจ้าของวิดีโอเท่านั้นที่จะเรียกดูออบเจ็กต์fileDetails
หลักได้
-
13 มิถุนายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
พร็อพเพอร์ตี้
contentDetails.googlePlusUserId
ของทรัพยากรchannel
เลิกใช้งานแล้ว ก่อนหน้านี้พร็อพเพอร์ตี้จะปรากฏต่อเมื่อช่องเชื่อมโยงกับโปรไฟล์ Google+ เท่านั้น หลังจากการเลิกใช้งาน พร็อพเพอร์ตี้จะไม่รวมอยู่ในทรัพยากรchannel
อีกต่อไป -
พร็อพเพอร์ตี้
snippet.authorGoogleplusProfileUrl
ของทรัพยากรcomment
เลิกใช้งานแล้ว ก่อนหน้านี้พร็อพเพอร์ตี้จะปรากฏต่อเมื่อช่องเชื่อมโยงกับโปรไฟล์ Google+ เท่านั้น หลังจากการเลิกใช้งาน พร็อพเพอร์ตี้จะไม่รวมอยู่ในทรัพยากรcomment
อีกต่อไป
เนื่องจากจะไม่มีการส่งกลับพร็อพเพอร์ตี้เหล่านี้หลังจากการเลิกใช้งาน เราจึงนำพร็อพเพอร์ตี้ทั้ง 2 รายการออกจากเอกสารประกอบของทรัพยากรที่เกี่ยวข้อง
31 พฤษภาคม 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
พารามิเตอร์
myRecentSubscribers
ใหม่ของเมธอดsubscriptions.list
จะเรียกรายชื่อผู้ติดตามช่องของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์โดยจะเรียงตามลำดับเวลาจากใหม่ไปหาเก่าโปรดทราบว่าพารามิเตอร์ใหม่รองรับเฉพาะการดึงข้อมูลผู้ติดตาม 1,000 คนล่าสุดมายังช่องของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์เท่านั้น หากต้องการดึงข้อมูลรายการผู้ติดตามทั้งหมด ให้ใช้พารามิเตอร์
mySubscribers
พารามิเตอร์ดังกล่าวซึ่งไม่ได้แสดงผลสมาชิกตามลำดับที่กำหนดนั้น จะไม่จำกัดจำนวนผู้ติดตามที่เรียกดูได้ -
อัปเดตคำจำกัดความของพร็อพเพอร์ตี้
snippet.thumbnails.(key)
สำหรับแหล่งข้อมูลกิจกรรม, playlistItem, เพลย์ลิสต์, ผลการค้นหา, ภาพขนาดย่อ และ วิดีโอ แล้ว เพื่อให้ทราบว่าวิดีโอบางรายการมีขนาดภาพขนาดย่อเพิ่มเติม- รูปภาพ
standard
กว้าง 640 พิกเซลและสูง 480 พิกเซล - รูปภาพ
maxres
กว้าง 1280 พิกเซล และสูง 720 พิกเซล
- รูปภาพ
-
อัปเดตคําจํากัดความของพารามิเตอร์
part
ของเมธอดchannelSection.list
แล้ว โปรดทราบว่าส่วนtargeting
นั้นสามารถดึงข้อมูลได้โดยมีค่าใช้จ่ายเท่ากับ2
หน่วยโควต้า -
ตอนนี้เมธอด
videos.list
แสดงผลข้อผิดพลาด forbidden (403
) เมื่อคำขอที่ได้รับอนุญาตอย่างไม่ถูกต้องพยายามเรียกข้อมูลfileDetails
,processingDetails
หรือsuggestions
ส่วนของทรัพยากรvideo
มีเพียงเจ้าของวิดีโอเท่านั้นที่เห็นส่วนดังกล่าว
17 พฤษภาคม 2016
เครื่องมือข้อมูลโค้ด Data API ใหม่มีข้อมูลโค้ดสั้นๆ สำหรับกรณีการใช้งานทั่วไปของ YouTube Data API ขณะนี้ข้อมูลโค้ดพร้อมใช้งานสำหรับเมธอด API แบบอ่านอย่างเดียวทั้งหมดใน Apps Script, Go, JavaScript, PHP, Python และ Ruby
สำหรับแต่ละวิธี เครื่องมือจะแสดงตัวอย่างโค้ดสำหรับ Use Case อย่างน้อย 1 กรณี ตัวอย่างเช่น จะมีการแสดงตัวอย่างข้อมูลโค้ด 5 รายการสำหรับเมธอด search.list
ดังนี้
- แสดงรายการวิดีโอตามคีย์เวิร์ด
- แสดงรายการวิดีโอตามสถานที่
- แสดงรายการการถ่ายทอดสด
- ค้นหาวิดีโอของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์
- แสดงรายการวิดีโอที่เกี่ยวข้อง
สำหรับแต่ละกรณีการใช้งาน เครื่องมือจะแสดงพารามิเตอร์ที่ใช้ในคำขอ API คุณสามารถแก้ไขค่าพารามิเตอร์ได้ ซึ่งในกรณีนี้เครื่องมือจะอัปเดตข้อมูลโค้ดเพื่อแสดงค่าพารามิเตอร์ที่คุณระบุ
สุดท้าย เครื่องมือจะแสดงการตอบกลับจาก API ต่อคำขอแต่ละรายการ หากคุณแก้ไขพารามิเตอร์คำขอ การตอบกลับของ API จะอิงตามค่าพารามิเตอร์ที่คุณระบุ โปรดทราบว่าคุณต้องให้สิทธิ์เครื่องมือในการส่งคำขอในนามของคุณเพื่อแสดงการตอบกลับจาก API
28 เมษายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
พร็อพเพอร์ตี้
contentDetails.projection
ใหม่ของทรัพยากรvideo
จะระบุรูปแบบการฉายภาพของวิดีโอ ค่าพร็อพเพอร์ตี้ที่ถูกต้องคือ360
และrectangular
-
อัปเดตทั้งพร็อพเพอร์ตี้
recordingDetails.location
และfileDetails.recordingLocation
ของทรัพยากรvideo
เพื่ออธิบายความแตกต่างระหว่างพร็อพเพอร์ตี้ทั้ง 2 รายการแล้ว- พร็อพเพอร์ตี้
recordingDetails.location
ระบุตำแหน่งที่เจ้าของวิดีโอต้องการเชื่อมโยงกับวิดีโอ ตำแหน่งนี้สามารถแก้ไขได้ ค้นหาได้ในวิดีโอสาธารณะ และอาจแสดงให้ผู้ใช้เห็นในวิดีโอสาธารณะ - ค่าพร็อพเพอร์ตี้
fileDetails.recordingLocation
จะเปลี่ยนแปลงไม่ได้และแสดงถึงสถานที่ตั้งที่เชื่อมโยงกับไฟล์วิดีโอต้นฉบับที่อัปโหลด มีเพียงเจ้าของวิดีโอเท่านั้นที่จะเห็นค่านี้
- พร็อพเพอร์ตี้
-
อัปเดตคําจํากัดความของพร็อพเพอร์ตี้
contentDetails.relatedPlaylists.favorites
ของทรัพยากรchannel
แล้วเนื่องจากค่าพร็อพเพอร์ตี้อาจมีรหัสเพลย์ลิสต์ที่อ้างถึงเพลย์ลิสต์ที่ว่างเปล่าและดึงข้อมูลไม่ได้ กรณีนี้เกิดจากการเลิกใช้งานฟังก์ชันการทำงานของวิดีโอโปรดไปแล้ว โปรดทราบว่าพร็อพเพอร์ตี้นี้ไม่ขึ้นอยู่กับนโยบายการเลิกใช้งาน API -
ระบบได้อัปเดตคำจำกัดความของข้อผิดพลาด
ineligibleAccount
ซึ่งแสดงผลโดยเมธอดcomments.insert
,comments.update
,commentThreads.insert
หรือcommentThreads.update
เพื่อแสดงให้เห็นว่าข้อผิดพลาดเกิดขึ้นเมื่อบัญชี YouTube ที่ใช้ให้สิทธิ์คำขอ API ไม่ได้ผสานรวมกับบัญชี Google ของผู้ใช้
20 เมษายน 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
อัปเดตคําจํากัดความของพารามิเตอร์
part
ของเมธอดchannels.update
แล้ว โปรดทราบว่าlocalizations
เป็นค่าที่ถูกต้องสำหรับพารามิเตอร์ดังกล่าว -
ส่วนการใช้โควต้าของคู่มือเริ่มต้นใช้งานได้รับการอัปเดตให้เชื่อมโยงไปยังคอนโซลของ Google Developer ซึ่งคุณจะเห็นโควต้าการใช้งานจริงและโควต้าการใช้งาน
16 มีนาคม 2016
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
การอัปเดตทรัพยากรและวิธีการที่มีอยู่
-
เอกสารแหล่งข้อมูล
channelBanner
ได้รับการอัปเดตแล้ว โดยพบว่าขนาดที่แนะนำสำหรับรูปภาพแบนเนอร์ของช่องที่อัปโหลดคือ 2560 x 1440 พิกเซล ขนาดต่ำสุด (2048 x 1152 พิกเซล) ไม่ได้เปลี่ยนแปลง -
พร็อพเพอร์ตี้
snippet.customUrl
ใหม่ของทรัพยากรchannel
ระบุ URL ที่กำหนดเองซึ่งเชื่อมโยงกับแชแนล (บางช่องเท่านั้นที่มี URL ที่กำหนดเอง) ศูนย์ช่วยเหลือของ YouTube อธิบายข้อกำหนดของการได้รับสิทธิ์ในการรับ URL ที่กำหนดเองและวิธีการตั้งค่า URL -
ออบเจ็กต์
brandingSettings.watch
ของทรัพยากรchannel
และพร็อพเพอร์ตี้ย่อยทั้งหมดเลิกใช้งานแล้ว -
ตอนนี้การตอบกลับของ API ต่อคำขอ
search.list
มีพร็อพเพอร์ตี้regionCode
แล้ว พร็อพเพอร์ตี้จะระบุรหัสภูมิภาคที่ใช้สำหรับคำค้นหา รหัสภูมิภาคจะสั่งให้ API แสดงผลการค้นหาสำหรับประเทศที่ระบุค่าพร็อพเพอร์ตี้คือรหัสประเทศ ISO 2 ตัวอักษรที่ระบุภูมิภาค เมธอด
i18nRegions.list
จะแสดงรายการภูมิภาคที่รองรับ ค่าเริ่มต้นคือUS
หากระบุภูมิภาคที่ไม่รองรับ YouTube อาจยังเลือกภูมิภาคอื่นเพื่อจัดการการค้นหาแทนค่าเริ่มต้น -
ระบบได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้
snippet.label
และsnippet.secondaryReasons[].label
ของทรัพยากรvideoAbuseReportReason
แล้ว โดยระบุว่าพร็อพเพอร์ตี้มีข้อความป้ายกำกับที่แปลแล้วเนื่องด้วยเหตุผลของการรายงานการละเมิดนอกจากนี้ ตอนนี้เมธอด
videoAbuseReportReasons.list
ยังรองรับพารามิเตอร์hl
ซึ่งระบุภาษาที่จะใช้กับข้อความป้ายกำกับในการตอบกลับของ API ค่าพารามิเตอร์เริ่มต้นคือen_US
-
พร็อพเพอร์ตี้
contentDetails.contentRating.ecbmctRating
ใหม่ของทรัพยากรvideo
ระบุการจัดประเภทวิดีโอจากคณะกรรมการประเมินและการจัดประเภทของตุรกีของกระทรวงวัฒนธรรมและการท่องเที่ยวนอกจากนี้ พร็อพเพอร์ตี้ API สำหรับระบบการจัดประเภทอื่นๆ ยังรองรับค่าใหม่ต่อไปนี้ของพร็อพเพอร์ตี้
contentDetails.contentRating.fpbRating
(แอฟริกาใต้)
การให้คะแนน: 10; ค่าพร็อพเพอร์ตี้:fpb10
contentDetails.contentRating.moctwRating
(ไต้หวัน)
การจัดประเภท: R-12; ค่าพร็อพเพอร์ตี้:moctwR12
contentDetails.contentRating.moctwRating
(ไต้หวัน)
การจัดประเภท: R-15; ค่าพร็อพเพอร์ตี้:moctwR15
-
พร็อพเพอร์ตี้
liveStreamingDetails.activeLiveChatId
ของทรัพยากรvideo
มีรหัสแชทสดที่ใช้งานอยู่ซึ่งเชื่อมโยงกับวิดีโอ ค่าพร็อพเพอร์ตี้จะปรากฏก็ต่อเมื่อวิดีโอเป็นการถ่ายทอดสดปัจจุบันที่เปิดใช้แชทสดเท่านั้น หลังสิ้นสุดการออกอากาศและจบแชทสด คุณจะไม่ได้รับพร็อพเพอร์ตี้สำหรับวิดีโออีกต่อไป -
พร็อพเพอร์ตี้
status.rejectionReason
ของทรัพยากรvideo
รองรับค่าพร็อพเพอร์ตี้ใหม่legal
-
-
API รองรับข้อผิดพลาดใหม่ต่อไปนี้
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest (400)
notEditable
เมธอด channelSections.insert
,channelSections.update
และchannelSections.delete
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าไม่สามารถสร้าง อัปเดต หรือลบส่วนช่องที่ระบุได้badRequest (400)
styleRequired
เมธอด channelSections.insert
และchannelSections.update
แสดงข้อผิดพลาดนี้เพื่อระบุว่าทรัพยากรchannelSection
ที่ส่งในคำขอ API ต้องระบุค่าสำหรับพร็อพเพอร์ตี้snippet.style
badRequest (400)
typeRequired
เมธอด channelSections.insert
และchannelSections.update
แสดงข้อผิดพลาดนี้เพื่อระบุว่าทรัพยากรchannelSection
ที่ส่งในคำขอ API ต้องระบุค่าสำหรับพร็อพเพอร์ตี้snippet.type
badRequest (400)
processingFailure
เมธอด commentThreads.list
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าเซิร์ฟเวอร์ API ดำเนินการตามคำขอไม่สำเร็จ แม้ว่านี่อาจเป็นข้อผิดพลาดที่เกิดขึ้นชั่วคราว แต่โดยปกติแล้วจะบ่งบอกว่าการป้อนข้อมูลของคำขอไม่ถูกต้อง ตรวจสอบโครงสร้างของทรัพยากรcommentThread
ในเนื้อหาคำขอเพื่อให้แน่ใจว่าถูกต้องforbidden (403)
commentsDisabled
เมธอด commentThreads.list
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าวิดีโอที่ระบุโดยพารามิเตอร์videoId
ได้ปิดใช้ความคิดเห็นbadRequest (400)
commentTextTooLong
เมธอด commentThreads.insert
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าทรัพยากรcomment
ที่กำลังแทรกมีอักขระมากเกินไปในพร็อพเพอร์ตี้snippet.topLevelComment.snippet.textOriginal
invalidValue (400)
videoAlreadyInAnotherSeriesPlaylist
เมธอด playlistItems.insert
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าวิดีโอที่คุณพยายามเพิ่มไปยังเพลย์ลิสต์อยู่ในเพลย์ลิสต์ของซีรีส์อื่นอยู่แล้ว ไปที่ศูนย์ช่วยเหลือของ YouTube เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับรายการซีรีส์badRequest (400)
subscriptionForbidden
เมธอด subscriptions.insert
แสดงผลข้อผิดพลาดนี้ เพื่อบ่งบอกว่าคุณสมัครใช้บริการถึงจำนวนสูงสุดแล้ว หรือคุณสร้างการสมัครใช้บริการล่าสุดมากเกินไป ในกรณีหลัง คุณสามารถลองส่งคำขออีกครั้งได้หลังจากผ่านไป 2-3 ชั่วโมงbadRequest (400)
invalidCategoryId
เมธอด videos.update
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้snippet.categoryId
ในทรัพยากรvideo
ที่อัปโหลดมีการระบุรหัสหมวดหมู่ที่ไม่ถูกต้อง ใช้เมธอดvideoCategories.list
เพื่อเรียกข้อมูลหมวดหมู่ที่รองรับbadRequest (400)
invalidDescription
เมธอด videos.update
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้snippet.description
ในทรัพยากรvideo
ที่อัปโหลดระบุค่าไม่ถูกต้องbadRequest (400)
invalidPublishAt
เมธอด videos.update
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้status.publishAt
ในทรัพยากรvideo
ที่อัปโหลดนั้นระบุเวลาในการเผยแพร่ที่กำหนดไว้ไม่ถูกต้องbadRequest (400)
invalidRecordingDetails
เมธอด videos.update
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าออบเจ็กต์recordingDetails
ในทรัพยากรvideo
ที่อัปโหลดระบุรายละเอียดการบันทึกที่ไม่ถูกต้องbadRequest (400)
invalidTags
เมธอด videos.update
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้snippet.tags
ในทรัพยากรvideo
ที่อัปโหลดระบุค่าไม่ถูกต้องbadRequest (400)
invalidTitle
เมธอด videos.update
จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้snippet.title
ในทรัพยากรvideo
ที่อัปโหลดระบุชื่อวิดีโอที่ไม่ถูกต้องหรือว่างเปล่าbadRequest (400)
invalidVideoMetadata
เมธอด videos.update
จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าข้อมูลเมตาของคําขอไม่ถูกต้อง ข้อผิดพลาดนี้เกิดขึ้นหากคำขออัปเดตส่วนsnippet
ของทรัพยากรvideo
แต่ไม่ได้กำหนดค่าสำหรับทั้งพร็อพเพอร์ตี้snippet.title
และsnippet.categoryId
18 ธันวาคม 2015
กฎหมายของสหภาพยุโรป (EU) กำหนดให้มีการเปิดเผยข้อมูลบางอย่างต่อผู้ใช้ปลายทางในสหภาพยุโรปและได้รับความยินยอมจากผู้ใช้ปลายทาง ดังนั้นสำหรับผู้ใช้ปลายทางในสหภาพยุโรป คุณจะต้องปฏิบัติตามนโยบายความยินยอมของผู้ใช้ EU เราได้เพิ่มประกาศข้อกำหนดนี้ไว้ในข้อกำหนดในการให้บริการ API ของ YouTube แล้ว
19 พฤศจิกายน 2015
ตอนนี้ API รองรับความสามารถในการตั้งค่าและเรียกข้อมูลข้อความที่แปลเป็นภาษาท้องถิ่นสำหรับพร็อพเพอร์ตี้ snippet.title
และ snippet.description
ของทรัพยากร playlist
และ video
พร็อพเพอร์ตี้ snippet.title
ของทรัพยากร channelSection
และพร็อพเพอร์ตี้ snippet.description
ของทรัพยากร channel
แล้ว
-
การตั้งค่าชื่อและคำอธิบายที่แปลแล้ว
คุณสามารถตั้งค่าที่แปลแล้วสำหรับทรัพยากรเมื่อเรียกใช้เมธอด
insert
หรือupdate
สำหรับทรัพยากรนั้นๆ หากต้องการกำหนดค่าที่แปลแล้วสำหรับทรัพยากร ให้ทำทั้ง 2 อย่างต่อไปนี้-
ตรวจสอบว่าได้ตั้งค่าสำหรับพร็อพเพอร์ตี้
snippet.defaultLanguage
ของทรัพยากรแล้ว พร็อพเพอร์ตี้ดังกล่าวระบุภาษาของพร็อพเพอร์ตี้snippet.title
และsnippet.description
ของทรัพยากร ค่าของรายการอาจเป็นภาษาของแอปพลิเคชันที่รองรับ หรือรหัสภาษา ISO 639-1:2002 อื่นๆ ส่วนใหญ่ เช่น หากคุณอัปโหลดวิดีโอที่มีชื่อและคำอธิบายภาษาอังกฤษ คุณต้องตั้งค่าพร็อพเพอร์ตี้snippet.defaultLanguage
เป็นen
หมายเหตุสำหรับการอัปเดตทรัพยากร
channel
: หากต้องการตั้งค่าพร็อพเพอร์ตี้snippet.defaultLanguage
สำหรับทรัพยากรchannel
คุณต้องอัปเดตพร็อพเพอร์ตี้brandingSettings.channel.defaultLanguage
-
เพิ่มออบเจ็กต์
localizations
ลงในทรัพยากรที่กำลังอัปเดต คีย์ออบเจ็กต์แต่ละรายการเป็นสตริงที่ระบุภาษาของแอปพลิเคชันหรือรหัสภาษา ISO 639-1:2002 และแต่ละคีย์จะแมปกับออบเจ็กต์ที่มีชื่อที่แปลแล้ว (และคำอธิบาย) สำหรับทรัพยากรตัวอย่างข้อมูลโค้ดด้านล่างตั้งค่าภาษาเริ่มต้นของทรัพยากรเป็นภาษาอังกฤษ รวมถึงเพิ่มชื่อและคำอธิบายภาษาเยอรมันและสเปนลงในวิดีโอด้วย ดังนี้
{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", ... }, "localizations": "de": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" }, "es": { "title": "Jugar al fútbol", "description": "Nosotros jugamos fútbol en el parque los domingos", } } }
สำคัญ: โปรดทราบว่าเมื่อคุณอัปเดตข้อมูลที่แปลแล้วสำหรับทรัพยากร คำขอ API จะต้องมีข้อมูลเวอร์ชันแปลที่มีอยู่ทั้งหมด เช่น หากส่งคำขอเพิ่มข้อมูลภาษาโปรตุเกสลงในวิดีโอในตัวอย่างข้างต้นในภายหลัง คำขอจะต้องรวมข้อมูลที่แปลแล้วสำหรับภาษาเยอรมัน สเปน และโปรตุเกส
-
-
การดึงข้อมูลค่าที่แปลแล้ว
API รองรับ 2 วิธีในการเรียกข้อมูลค่าที่แปลแล้วสำหรับทรัพยากร
-
เพิ่มพารามิเตอร์
hl
ลงในคำขอchannels.list
,channelSections.list
,playlists.list
หรือvideos.list
เพื่อเรียกข้อมูลที่แปลแล้วสำหรับภาษาแอปพลิเคชันที่เว็บไซต์ YouTube รองรับ หากรายละเอียดทรัพยากรที่แปลแล้วมีให้บริการในภาษานั้น ออบเจ็กต์snippet.localized
ของทรัพยากรจะมีค่าที่แปลเป็นภาษานั้น อย่างไรก็ตาม หากไม่มีรายละเอียดในภาษาท้องถิ่น ออบเจ็กต์snippet.localized
จะมีรายละเอียดทรัพยากรเป็นภาษาเริ่มต้นของทรัพยากรตัวอย่างเช่น สมมติว่าคำขอ
videos.list
เรียกข้อมูลวิดีโอที่อธิบายข้างต้นด้วยข้อมูลภาษาเยอรมันและสเปนที่แปลแล้ว หากตั้งค่าพารามิเตอร์hl
เป็นde
ทรัพยากรจะมีข้อมูลต่อไปนี้{ "kind": "youtube#video", ... "snippet": { "title": "Playing soccer", "description": "We play soccer in the park on Sundays.", "defaultLanguage": "en", "localized": { "title": "Fußball spielen", "description": "Wir spielen Fußball im Park am Sonntag" } ... } }
อย่างไรก็ตาม หากตั้งค่าพารามิเตอร์
hl
เป็นfr
ออบเจ็กต์snippet.localized
จะมีชื่อและคำอธิบายภาษาอังกฤษเนื่องจากภาษาอังกฤษเป็นภาษาเริ่มต้นสำหรับแหล่งข้อมูล และรายละเอียดภาษาฝรั่งเศสที่แปลแล้วไม่พร้อมใช้งานสำคัญ: พารามิเตอร์hl
รองรับเฉพาะค่าที่ระบุภาษาของแอปพลิเคชันที่เว็บไซต์ YouTube รองรับเท่านั้น ในการระบุว่าข้อความที่แปลแล้วพร้อมใช้งานสำหรับภาษาอื่นๆ หรือไม่ คุณต้องเรียกข้อมูลส่วนlocalizations
สำหรับแหล่งข้อมูลและตัวกรองเพื่อดูว่าข้อความแปลนั้นมีอยู่ไหม
ตัวอย่างเช่น คุณจะต้องเรียกข้อมูลรายการการแปลเป็นภาษาท้องถิ่นทั้งหมดเพื่อดูว่าข้อความที่แปลแล้วเป็นภาษาอังกฤษแบบ Appalachian หรือไม่
-
เมื่อเรียกข้อมูลทรัพยากร ให้ใส่
localizations
ในค่าพารามิเตอร์part
เพื่อดึงรายละเอียดทั้งหมดที่แปลแล้วสำหรับทรัพยากรนั้น หากคุณกำลังดึงข้อมูลที่แปลแล้วสำหรับภาษาที่ไม่ใช่ภาษาของแอปพลิเคชัน YouTube ในปัจจุบัน คุณจำเป็นต้องใช้วิธีนี้เพื่อเรียกข้อมูลการแปลทั้งหมด จากนั้นกรองเพื่อดูว่ามีข้อมูลที่แปลแล้วที่ต้องการหรือไม่
-
-
ข้อผิดพลาดเกี่ยวกับค่าข้อความที่แปลแล้ว
นอกจากนี้ API ยังรองรับข้อผิดพลาดใหม่ต่อไปนี้สำหรับค่าข้อความที่แปลแล้ว
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest (400)
defaultLanguageNotSetError
ข้อผิดพลาดนี้บ่งบอกว่าคำขอที่พยายามแทรกหรืออัปเดตออบเจ็กต์ localizations
สำหรับทรัพยากรล้มเหลวเนื่องจากไม่ได้ตั้งค่าพร็อพเพอร์ตี้snippet.defaultLanguage
สำหรับทรัพยากรดังกล่าว เมธอดchannels.update
,channelSections.insert
,channelSections.update
,playlists.insert
,playlists.update
,videos.insert
และvideos.update
รองรับข้อผิดพลาดนี้badRequest (400)
localizationValidationError
ข้อผิดพลาดนี้บ่งบอกว่าค่าใดค่าหนึ่งในออบเจ็กต์ localizations
ของทรัพยากรไม่สามารถตรวจสอบได้ ตัวอย่างเช่น ข้อผิดพลาดนี้อาจเกิดขึ้นหากออบเจ็กต์มีรหัสภาษาที่ไม่ถูกต้อง เมธอดchannels.update
,channelSections.insert
,channelSections.update
,playlists.insert
และplaylists.update
รองรับข้อผิดพลาดนี้
4 พฤศจิกายน 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
การอัปเดตทรัพยากรและวิธีการที่มีอยู่
-
อัปเดตพารามิเตอร์
order
ของเมธอดsearch.list
แล้ว โปรดทราบว่าหากคุณจัดเรียงการถ่ายทอดสดตามviewCount
ระบบจะจัดเรียงผลลัพธ์ API ตามการออกอากาศดังกล่าว จำนวนผู้ชมที่ดูพร้อมกันในขณะที่การออกอากาศยังคงดำเนินอยู่ -
พารามิเตอร์
relatedToVideoId
ของเมธอดsearch.list
ได้รับการอัปเดตแล้วโปรดทราบว่าหากมีการตั้งค่าพารามิเตอร์ไว้ พารามิเตอร์ที่สนับสนุนอื่นๆ จะมีเพียงpart
,maxResults
,pageToken
,regionCode
,relevanceLanguage
,safeSearch
,type
(ซึ่งต้องตั้งค่าเป็นvideo
) และfields
การอัปเดตนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานของ API -
อัปเดตคําจํากัดความของพร็อพเพอร์ตี้
snippet.publishedAt
ของทรัพยากรvideo
แล้วเนื่องจากค่าพร็อพเพอร์ตี้ที่ระบุวันที่และเวลาที่เผยแพร่วิดีโออาจแตกต่างจากเวลาที่อัปโหลดวิดีโอ เช่น หากอัปโหลดวิดีโอเป็นวิดีโอส่วนตัว แล้วเปลี่ยนเป็นแบบสาธารณะในภายหลัง ค่าพร็อพเพอร์ตี้จะระบุเวลาที่จะเปลี่ยนวิดีโอเป็นแบบสาธารณะ คำจำกัดความที่อัปเดตนี้ยังอธิบายวิธีที่ระบบเติมค่าสำหรับวิดีโอส่วนตัวและวิดีโอที่ไม่เป็นสาธารณะด้วยการเปลี่ยนแปลงนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานของ API
-
อัปเดตคําจํากัดความของพร็อพเพอร์ตี้
status.publishAt
ของทรัพยากรvideo
ให้มีหมายเหตุต่อไปนี้แล้ว- หากตั้งค่าของพร็อพเพอร์ตี้นี้เมื่อเรียกใช้เมธอด
videos.update
คุณต้องกำหนดค่าพร็อพเพอร์ตี้status.privacyStatus
เป็นprivate
ด้วย แม้ว่าวิดีโอจะเป็นแบบส่วนตัวอยู่แล้ว - หากคำขอกำหนดให้เผยแพร่วิดีโอในช่วงเวลาหนึ่งในอดีต ระบบจะเผยแพร่วิดีโอทันที ดังนั้น ผลของการตั้งค่าพร็อพเพอร์ตี้
status.publishAt
เป็นวันที่และเวลาที่ผ่านมาจะเหมือนกับการเปลี่ยนprivacyStatus
ของวิดีโอจากprivate
เป็นpublic
- หากตั้งค่าของพร็อพเพอร์ตี้นี้เมื่อเรียกใช้เมธอด
-
พร็อพเพอร์ตี้
contentDetails.contentRating.cncRating
ของทรัพยากรvideo
ระบุการจัดประเภทของวิดีโอจาก Commission de Ratings ของฝรั่งเศส พร็อพเพอร์ตี้นี้มาแทนที่พร็อพเพอร์ตี้contentDetails.contentRating.fmocRating
ซึ่งตอนนี้เลิกใช้งานแล้ว -
ระบบได้อัปเดตคําจํากัดความ brandingSettings.channel.keywords ของทรัพยากร
channel
ให้แสดงอย่างถูกต้องว่าค่าพร็อพเพอร์ตี้มีรายการสตริงที่คั่นด้วยการเว้นวรรค และไม่ใช่รายการที่คั่นด้วยคอมมาอย่างที่ระบุก่อนหน้านี้ การอัปเดตนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานของ API -
เอกสารสำหรับเมธอด
thumbnails.set
ได้รับการอัปเดตเพื่อแสดงอย่างถูกต้องว่าเนื้อหาของคำขอมีภาพขนาดย่อที่คุณอัปโหลดและเชื่อมโยงกับวิดีโอ เนื้อหาของคำขอไม่มีทรัพยากรthumbnail
ก่อนหน้านี้เอกสารประกอบระบุว่าคุณไม่ควรระบุเนื้อหาของคำขอเมื่อเรียกใช้วิธีการนี้ การอัปเดตนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานของ API -
คำอธิบายของแหล่งข้อมูล
activity
ได้รับการอัปเดตเพื่อแสดงถึงข้อเท็จจริงที่ว่าปัจจุบันเมธอดactivities.list
ไม่ได้รวมแหล่งข้อมูลที่เกี่ยวข้องกับความคิดเห็นใหม่ของวิดีโอsnippet.type
และcontentDetails.comment
ของทรัพยากรได้รับการอัปเดตแล้วเช่นกัน
-
-
ข้อผิดพลาดใหม่และอัปเดต
-
ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว
รายละเอียดข้อผิดพลาด activities.insert
รหัสตอบกลับ HTTP badRequest (400)
เหตุผล invalidMetadata
คำอธิบาย พร็อพเพอร์ตี้ kind
ไม่ตรงกับประเภทของรหัสที่ระบุcommentThreads.update
comments.insert
comments.update
รหัสตอบกลับ HTTP badRequest (400)
เหตุผล commentTextTooLong
คำอธิบาย ทรัพยากร comment
ที่จะแทรกหรืออัปเดตมีอักขระมากเกินไปในพร็อพเพอร์ตี้snippet.topLevelComment.snippet.textOriginal
playlistItems.insert
playlistItems.update
รหัสตอบกลับ HTTP forbidden (403)
เหตุผล playlistItemsNotAccessible
คำอธิบาย คำขอไม่ได้รับอนุญาตอย่างถูกต้องในการแทรก อัปเดต หรือลบรายการเพลย์ลิสต์ที่ระบุ playlists.delete
playlists.insert
playlists.update
รหัสตอบกลับ HTTP badRequest (400)
เหตุผล playlistForbidden
คำอธิบาย การดำเนินการนี้ไม่ได้รับอนุญาตหรือคำขอไม่ได้รับอนุญาตอย่างถูกต้อง search.list
รหัสตอบกลับ HTTP badRequest (400)
เหตุผล invalidLocation
คำอธิบาย ค่าพารามิเตอร์ location
และ/หรือlocationRadius
มีรูปแบบไม่ถูกต้องsearch.list
รหัสตอบกลับ HTTP badRequest (400)
เหตุผล invalidRelevanceLanguage
คำอธิบาย ค่าพารามิเตอร์ relevanceLanguage
มีรูปแบบไม่ถูกต้องsubscriptions.insert
รหัสตอบกลับ HTTP badRequest (400)
เหตุผล subscriptionForbidden
คำอธิบาย ข้อผิดพลาดนี้เกิดขึ้นเมื่อสิ่งต่อไปนี้เป็นจริง: - มีการสมัครใช้บริการที่คุณพยายามสร้างอยู่แล้ว
- คุณสมัครใช้บริการครบจำนวนสูงสุดแล้ว
- คุณกำลังพยายามติดตามช่องของคุณเอง ซึ่งระบบไม่สนับสนุน
- คุณสร้างการสมัครใช้บริการมากเกินไปเมื่อเร็วๆ นี้ และต้องรอ 2-3 ชั่วโมงก่อนที่จะลองส่งคำขออีกครั้ง
videos.update
รหัสตอบกลับ HTTP badRequest (400)
เหตุผล invalidDefaultBroadcastPrivacySetting
คำอธิบาย คำขอพยายามตั้งค่าความเป็นส่วนตัวที่ไม่ถูกต้องสำหรับการออกอากาศเริ่มต้น
-
28 สิงหาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
การอัปเดตทรัพยากรและวิธีการที่มีอยู่
-
พร็อพเพอร์ตี้
statistics.favoriteCount
ของทรัพยากรvideo
เลิกใช้งานแล้วเพื่อให้สอดคล้องกับนโยบายการเลิกใช้งาน พร็อพเพอร์ตี้นี้จะรวมอยู่ในแหล่งข้อมูลของ
video
ต่อไปเป็นเวลาอย่างน้อย 1 ปีหลังจากการประกาศนี้ แต่ในตอนนี้ค่าพร็อพเพอร์ตี้จะตั้งเป็น0
เสมอ
-
7 สิงหาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
การอัปเดตทรัพยากรและวิธีการที่มีอยู่
-
อัปเดตคำจำกัดความของพร็อพเพอร์ตี้
snippet.tags[]
ของทรัพยากรvideo
เพื่อให้ข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่เซิร์ฟเวอร์ API คำนวณความยาวของค่าของพร็อพเพอร์ตี้ โปรดทราบว่าการอัปเดตนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานของ APIกล่าวอย่างเจาะจงคือ ในตอนนี้คำจำกัดความได้อธิบายว่าหากแท็กมีการเว้นวรรค เซิร์ฟเวอร์ API จะจัดการค่าแท็กเสมือนว่าอยู่ในเครื่องหมายคำพูด และเครื่องหมายคำพูดจะนับรวมอยู่ในจำนวนอักขระสูงสุด ดังนั้น ตามวัตถุประสงค์ของจำนวนอักขระสูงสุด แท็ก Foo-Baz จะมีอักขระ 7 ตัว แต่แท็ก Foo Baz มีอักขระ 9 ตัว
-
เมธอด
commentThreads.insert
ไม่รองรับพารามิเตอร์shareOnGooglePlus
อีกต่อไป ซึ่งก่อนหน้านี้ได้ระบุว่าความคิดเห็นและการตอบกลับความคิดเห็นนั้นควรโพสต์ไปยังโปรไฟล์ Google+ ของผู้เขียนด้วย หากคำขอส่งพารามิเตอร์ เซิร์ฟเวอร์ API จะไม่สนใจพารามิเตอร์ แต่จะจัดการคำขอนั้น
-
18 มิถุนายน 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
การอัปเดตทรัพยากรและวิธีการที่มีอยู่
-
พารามิเตอร์
order
ใหม่ของเมธอดcommentThreads.list
ระบุลำดับที่การตอบกลับของ API ควรแสดงชุดข้อความความคิดเห็น ชุดข้อความอาจเรียงลำดับตามเวลาหรือความเกี่ยวข้อง ลักษณะการทำงานเริ่มต้นคือเรียงลำดับตามเวลา -
พร็อพเพอร์ตี้
snippet.defaultAudioLanguage
ใหม่ของทรัพยากรvideo
ระบุภาษาที่พูดในแทร็กเสียงเริ่มต้นของวิดีโอ -
เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้
contentDetails.licensedContent
ของทรัพยากรvideo
เพื่อชี้แจงว่าเนื้อหาต้องอัปโหลดลงในช่องที่ลิงก์กับพาร์ทเนอร์เนื้อหาของ YouTube ก่อน แล้วจึงอ้างสิทธิ์โดยพาร์ทเนอร์ ตัวเลขนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานจริงของ API -
ขณะนี้เมธอด
captions.delete
,captions.download
,captions.insert
,captions.list
และcaptions.update
รองรับพารามิเตอร์onBehalfOfContentOwner
แล้ว ซึ่งวิธีอื่นๆ นั้นรองรับอยู่แล้ว คำขอที่ใช้วิธีการดังกล่าวต้องได้รับอนุญาตด้วยโทเค็นที่ให้สิทธิ์เข้าถึงขอบเขตhttps://www.googleapis.com/auth/youtubepartner
ด้วย
-
-
ข้อผิดพลาดใหม่และอัปเดต
-
ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว
รายละเอียดข้อผิดพลาด videos.rate
รหัสตอบกลับ HTTP badRequest (400)
เหตุผล emailNotVerified
คำอธิบาย ผู้ใช้ต้องยืนยันอีเมลของตนเองก่อนที่จะให้คะแนนวิดีโอ videos.rate
รหัสตอบกลับ HTTP badRequest (400)
เหตุผล videoPurchaseRequired
คำอธิบาย เฉพาะผู้ใช้ที่เช่าวิดีโอเท่านั้นที่จะให้คะแนนวิดีโอสำหรับเช่าได้ -
เมธอด
subscriptions.delete
และsubscriptions.insert
ไม่รองรับข้อผิดพลาดaccountClosed
และaccountSuspended
อีกต่อไป
-
27 เมษายน 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
แหล่งข้อมูลและวิธีการใหม่ๆ
-
แหล่งข้อมูล
videoAbuseReportReason
ใหม่มีข้อมูลเกี่ยวกับเหตุผลที่วิดีโอจะถูกแจ้งว่ามีเนื้อหาที่ไม่เหมาะสม เมธอดvideoAbuseReportReasons.list
ช่วยให้คุณเรียกดูรายการสาเหตุทั้งหมดที่อาจมีการแจ้งว่าวิดีโอไม่เหมาะสม -
เมธอด
videos.reportAbuse
ใหม่ให้คุณแจ้งวิดีโอที่มีเนื้อหาที่เป็นการละเมิดได้จริงๆ ส่วนเนื้อหาของคำขอประกอบด้วยออบเจ็กต์ JSON ที่ระบุว่าวิดีโอถูกแจ้งว่าไม่เหมาะสม รวมถึงเหตุผลที่วิดีโอมีเนื้อหาที่เป็นการละเมิด ดูเหตุผลที่ถูกต้องได้จากเมธอดvideoAbuseReportReason.list
ที่อธิบายไว้ข้างต้นนอกจากนี้ เรายังปรับปรุงคำแนะนำในการย้ายข้อมูลโดยแสดงตัวอย่างการรายงานวิดีโอที่ละเมิดด้วย การเปลี่ยนแปลงนี้ทำให้ API v3 รองรับฟีเจอร์ทั้งหมดของ API v2 ที่กำหนดเวลาไว้ให้รองรับแล้ว ฟีเจอร์เหล่านี้จะอธิบายทั้งหมดไว้ในคำแนะนำในการย้ายข้อมูลด้วย
-
-
การอัปเดตทรัพยากรและวิธีการที่มีอยู่
-
พารามิเตอร์ตัวกรอง
forDeveloper
ใหม่ของเมธอดsearch.list
จะจำกัดการค้นหาให้ดึงเฉพาะวิดีโอที่อัปโหลดผ่านแอปพลิเคชันหรือเว็บไซต์ของนักพัฒนาซอฟต์แวร์เท่านั้น พารามิเตอร์forDeveloper
สามารถใช้ร่วมกับพารามิเตอร์การค้นหาที่ไม่บังคับ เช่น พารามิเตอร์q
สำหรับฟีเจอร์นี้ วิดีโอที่อัปโหลดแต่ละรายการจะได้รับการติดแท็กด้วยหมายเลขโปรเจ็กต์ที่เชื่อมโยงกับแอปพลิเคชันของนักพัฒนาซอฟต์แวร์ใน Google Developers Console โดยอัตโนมัติ
เมื่อคำขอค้นหาตั้งค่าพารามิเตอร์
forDeveloper
เป็นtrue
ในภายหลัง เซิร์ฟเวอร์ API จะใช้ข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอเพื่อระบุนักพัฒนาซอฟต์แวร์ ดังนั้น นักพัฒนาแอปจึงจำกัดผลการค้นหาไว้เฉพาะวิดีโอที่อัปโหลดผ่านแอปหรือเว็บไซต์ของนักพัฒนาแอปเอง แต่จะจำกัดผลการค้นหาผ่านแอปหรือเว็บไซต์อื่นๆ ไม่ได้ฟีเจอร์ใหม่มีฟังก์ชันการทำงานที่คล้ายกัน (แม้จะไม่เหมือนกัน) กับฟังก์ชันของแท็กนักพัฒนาซอฟต์แวร์ที่ API เวอร์ชัน 2 รองรับ
-
พร็อพเพอร์ตี้
snippet.country
ใหม่ของทรัพยากรchannel
ช่วยให้เจ้าของช่องเชื่อมโยงช่องกับประเทศที่ต้องการได้หมายเหตุ: หากต้องการตั้งค่าพร็อพเพอร์ตี้
snippet.country
สำหรับทรัพยากรchannel
คุณต้องอัปเดตพร็อพเพอร์ตี้brandingSettings.channel.country
-
ขณะนี้ API รองรับการกำหนดเป้าหมายสำหรับทรัพยากร
channelSection
แล้ว การกำหนดเป้าหมายส่วนแชแนลจะให้วิธีจำกัดการเปิดเผยส่วนเนื้อหาแก่ผู้ใช้ที่ตรงกับเกณฑ์เฉพาะAPI จะแสดงตัวเลือกการกำหนดเป้าหมาย 3 แบบ ผู้ใช้ต้องมีคุณสมบัติตรงตามการตั้งค่าการกำหนดเป้าหมายทั้งหมดเพื่อให้ส่วนช่องมองเห็นได้
-
targeting.languages[]
: รายการภาษาที่ใช้งานของ YouTube ผู้ใช้ที่เลือกภาษาใดภาษาหนึ่งจะเห็นส่วนช่องที่เกี่ยวข้อง -
targeting.regions[]
: รายการภูมิภาคเนื้อหาที่ YouTube แนะนำ ส่วนช่องจะแสดงต่อผู้ใช้ที่เลือกหนึ่งในภูมิภาคเหล่านั้น รวมทั้งผู้ใช้ที่ได้รับการเลือกหนึ่งในภูมิภาคเหล่านั้นโดยอัตโนมัติด้วย -
targeting.countries[]
: รายชื่อประเทศที่แสดงส่วนช่องได้ แต่ละค่าในรายการจะเป็นรหัสประเทศ ISO 3166-1 alpha-2
-
-
คําจํากัดความของพร็อพเพอร์ตี้
contentDetails.duration
ของทรัพยากรvideo
ได้รับการแก้ไขแล้วเพื่อให้ค่าตรงกับชั่วโมง วัน และอื่นๆ -
เอกสารสำหรับเมธอด
channelSections.delete
,playlistItems.delete
,playlists.delete
,subscriptions.delete
และvideos.delete
ได้รับการแก้ไขแล้วเพื่อแสดงให้เห็นว่าเมธอดเหล่านั้นทั้งหมดจะแสดงโค้ดตอบกลับ HTTP204
(No Content
) เมื่อทำสำเร็จ
-
-
ข้อผิดพลาดใหม่และอัปเดต
-
ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest (400)
targetInvalidCountry
เมธอด channelSections.insert
และchannelSections.update
จะแสดงผลข้อผิดพลาดนี้หากทรัพยากรchannelSection
ที่แทรกมีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้targeting.countries[]
badRequest (400)
targetInvalidLanguage
เมธอด channelSections.insert
และchannelSections.update
จะแสดงผลข้อผิดพลาดนี้หากทรัพยากรchannelSection
ที่แทรกมีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้targeting.languages[]
badRequest (400)
targetInvalidRegion
เมธอด channelSections.insert
และchannelSections.update
จะแสดงผลข้อผิดพลาดนี้หากทรัพยากรchannelSection
ที่แทรกมีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้targeting.regions[]
badRequest (400)
operationNotSupported
เมธอด comments.insert
จะแสดงข้อผิดพลาดนี้หากผู้ใช้ API แทรกความคิดเห็นตอบกลับความคิดเห็นระดับบนสุดที่ระบุโดยพร็อพเพอร์ตี้snippet.parentId
ไม่ได้ ในทรัพยากรcommentThread
พร็อพเพอร์ตี้snippet.canReply
จะระบุว่าผู้มีสิทธิ์อ่านคนปัจจุบันตอบกลับชุดข้อความได้หรือไม่badRequest (400)
invalidChannelId
เมธอด search.list
จะแสดงข้อผิดพลาดนี้หากพารามิเตอร์channelId
ในคำขอระบุรหัสแชแนลที่ไม่ถูกต้องbadRequest (400)
subscriptionForbidden
เมธอด subscriptions.insert
จะแสดงข้อผิดพลาดนี้หากผู้ใช้ API พยายามติดตามช่องของผู้ใช้เอง -
เมธอด
captions.update
ไม่รองรับข้อผิดพลาดinvalidMetadata
และvideoNotFound
อีกต่อไป
-
16 เมษายน 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เราได้อัปเดตคำแนะนำในการย้ายข้อมูลเพื่ออธิบายวิธีย้ายข้อมูลแอปพลิเคชันที่ยังคงใช้ฟังก์ชันการแสดงความคิดเห็นจาก API เวอร์ชัน 2
คำแนะนำยังกล่าวถึงฟีเจอร์การแสดงความคิดเห็นหลายรายการที่ API v2 ไม่รองรับ แต่รองรับใน v3 API ซึ่งได้แก่
- เรียกดูความคิดเห็นเกี่ยวกับช่อง
- เรียกดูชุดข้อความความคิดเห็นทั้งหมดที่เกี่ยวข้องกับช่อง ซึ่งหมายความว่าการตอบกลับจาก API อาจมีความคิดเห็นเกี่ยวกับช่องหรือวิดีโอในช่องได้
- การอัปเดตข้อความของความคิดเห็น
- การทำเครื่องหมายความคิดเห็นว่าเป็นสแปม
- ตั้งค่าสถานะการดูแลความคิดเห็น
-
คำแนะนำการสมัครรับข้อความ Push ได้รับการอัปเดตเพื่อแสดงข้อเท็จจริงที่ว่าการแจ้งเตือนจะพุชไปที่ฮับ Google PubSubHubBub เท่านั้น และไม่ส่งไปยัง Superfeedr Hub ตามที่ระบุไว้ก่อนหน้านี้
9 เมษายน 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ทรัพยากร
commentThread
และcomment
ใหม่ของ API ช่วยให้คุณเรียก แทรก อัปเดต ลบ และดูแลความคิดเห็นได้-
ทรัพยากร
commentThread
มีข้อมูลเกี่ยวกับชุดความคิดเห็นใน YouTube ซึ่งประกอบด้วยความคิดเห็นและการตอบกลับระดับบนสุดของความคิดเห็นนั้น (หากมี) ทรัพยากรcommentThread
สามารถแสดงความคิดเห็นเกี่ยวกับวิดีโอหรือช่องที่จริงแล้วความคิดเห็นระดับบนสุดและการตอบกลับเป็นทรัพยากร
comment
รายการที่ฝังอยู่ในทรัพยากรcommentThread
โปรดทราบว่าแหล่งข้อมูลcommentThread
ไม่จำเป็นต้องมีการตอบกลับความคิดเห็นทั้งหมด และคุณต้องใช้เมธอดcomments.list
หากต้องการเรียกการตอบกลับทั้งหมดสำหรับความคิดเห็นหนึ่งๆ นอกจากนี้ ความคิดเห็นบางรายการจะไม่มีการตอบกลับAPI รองรับเมธอดต่อไปนี้สำหรับทรัพยากร
commentThread
commentThreads.list
– เรียกดูรายการชุดข้อความความคิดเห็น ใช้วิธีนี้เพื่อเรียกดูความคิดเห็นที่เชื่อมโยงกับวิดีโอหรือช่องที่เฉพาะเจาะจงcommentThreads.insert
– สร้างความคิดเห็นระดับบนสุดรายการใหม่ (ใช้เมธอดcomments.insert
เพื่อตอบกลับความคิดเห็นที่มีอยู่)commentThreads.update
– แก้ไขความคิดเห็นระดับบนสุด
-
แหล่งข้อมูล
comment
มีข้อมูลเกี่ยวกับความคิดเห็นรายการเดียวใน YouTube ทรัพยากรcomment
สามารถแสดงความคิดเห็นเกี่ยวกับวิดีโอหรือช่อง นอกจากนี้ ความคิดเห็นอาจเป็นความคิดเห็นระดับบนสุดหรือการตอบกลับความคิดเห็นระดับบนสุดAPI รองรับเมธอดต่อไปนี้สำหรับทรัพยากร
comment
comments.list
– เรียกดูรายการความคิดเห็น ใช้วิธีนี้เพื่อเรียกการตอบกลับทั้งหมดของความคิดเห็นรายการใดรายการหนึ่งcomments.insert
– สร้างการตอบกลับความคิดเห็นที่มีอยู่comments.update
– แก้ไขความคิดเห็นcomments.markAsSpam
– แจ้งว่าความคิดเห็นอย่างน้อย 1 รายการเป็นสแปมcomments.setModerationStatus
– ตั้งค่าสถานะการดูแลความคิดเห็นอย่างน้อย 1 รายการ เช่น ล้างความคิดเห็นสำหรับการแสดงต่อสาธารณะ หรือปฏิเสธความคิดเห็นที่ไม่เหมาะที่จะแสดง คำขอ API จะต้องได้รับอนุญาตจากเจ้าของช่องหรือวิดีโอที่เชื่อมโยงกับความคิดเห็นcomments.delete
– ลบความคิดเห็น
โปรดทราบว่าจำเป็นต้องมีขอบเขต
https://www.googleapis.com/auth/youtube.force-ssl
ใหม่ของ API ที่อธิบายไว้ในประวัติการแก้ไขสำหรับวันที่ 2 เมษายน 2015 สำหรับการเรียกไปยังเมธอดcomments.insert
,comments.update
,comments.markAsSpam
,comments.setModerationStatus
,comments.delete
,commentThreads.insert
และcommentThreads.update
-
-
คู่มือการสมัครรับข้อความ Push ใหม่จะอธิบายการสนับสนุนใหม่ๆ ของ API สำหรับข้อความ Push ผ่าน PubSubHubBub ซึ่งเป็นโปรโตคอลการเผยแพร่/สมัครรับข้อมูลแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์สำหรับแหล่งข้อมูลที่สามารถเข้าถึงเว็บได้ เซิร์ฟเวอร์ Callback PubSubHubBub จะได้รับการแจ้งเตือนฟีด Atom เมื่อช่องทำกิจกรรมต่อไปนี้
- อัปโหลดวิดีโอ
- อัปเดตชื่อของวิดีโอ
- อัปเดตคำอธิบายของวิดีโอ
-
เราได้ปรับปรุงคู่มือการย้ายข้อมูลเพื่อให้ทราบถึงการรองรับข้อความ Push ใหม่ อย่างไรก็ตาม เนื่องจาก API เวอร์ชัน 2 รองรับข้อความ Push ประเภทอื่นๆ จำนวนมากที่ไม่รองรับใน API เวอร์ชัน 3 การพูดถึงการสนับสนุน PubSubHubBub จึงยังคงปรากฏในส่วนเลิกใช้งานของคู่มือดังกล่าว
-
ตอนนี้ขอบเขต
https://www.googleapis.com/auth/youtube.force-ssl
ใหม่ของ API เป็นขอบเขตที่ถูกต้องสำหรับเมธอด API ซึ่งก่อนหน้านี้รองรับขอบเขตhttps://www.googleapis.com/auth/youtube
-
ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest (400)
invalidRating
เมธอด videos.rate
จะแสดงผลข้อผิดพลาดนี้หากคำขอมีค่าที่ไม่คาดคิดสำหรับพารามิเตอร์rating
-
เมธอด
subscriptions.insert
ไม่รองรับข้อผิดพลาดsubscriptionLimitExceeded
อีกต่อไป ซึ่งก่อนหน้านี้ได้ระบุว่าสมาชิกที่ระบุพร้อมคำขอนั้นเกินขีดจำกัดอัตราการสมัครใช้บริการแล้ว
2 เมษายน 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ทรัพยากร
captions
ใหม่แสดงแทร็กคำบรรยายแทนเสียงของ YouTube แทร็กคำบรรยายแทนเสียงจะเชื่อมโยงกับวิดีโอ YouTube เพียง 1 รายการเท่านั้นAPI รองรับเมธอดในการแสดงรายการ แทรก อัปเดต ดาวน์โหลด และลบแทร็กคำบรรยาย
-
เรายังได้อัปเดตคำแนะนำในการย้ายข้อมูลเพื่ออธิบายวิธีย้ายข้อมูลแอปพลิเคชันที่ยังใช้ฟังก์ชันคำบรรยายแทนเสียงใน API เวอร์ชัน 2 อีกด้วย
-
ขอบเขต
https://www.googleapis.com/auth/youtube.force-ssl
ใหม่ของ API กำหนดให้สื่อสารกับเซิร์ฟเวอร์ API ผ่านการเชื่อมต่อ SSLขอบเขตใหม่นี้จะให้สิทธิ์เข้าถึงเหมือนกับขอบเขต
https://www.googleapis.com/auth/youtube
และในความเป็นจริง ขอบเขตทั้ง 2 อย่างนี้มีฟังก์ชันการทำงานเหมือนกันเนื่องจากเซิร์ฟเวอร์ API ของ YouTube จะใช้งานได้ผ่านปลายทาง HTTPS เท่านั้น ด้วยเหตุนี้ แม้ว่าขอบเขตhttps://www.googleapis.com/auth/youtube
จะไม่จำเป็นต้องใช้การเชื่อมต่อ SSL แต่จริงๆ แล้ว จึงไม่มีวิธีอื่นๆ ในการส่งคำขอ APIต้องมีขอบเขตใหม่สำหรับการเรียกเมธอดของทรัพยากร
caption
ทั้งหมด
11 มีนาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
คำแนะนำในการย้ายข้อมูล YouTube Data API (v3) มีแท็บใหม่ชื่อใหม่ใน v3 API ซึ่งแสดงฟีเจอร์ที่ API v3 รองรับและ v2 API ไม่รองรับ คุณลักษณะเดิมมีอยู่ก่อนหน้านี้และยังคงปรากฏในแท็บอื่นๆ ในคำแนะนำ ตัวอย่างเช่น ฟีเจอร์ใหม่ที่อธิบายวิธีอัปเดตข้อมูลแคมเปญโปรโมตในวิดีโอของช่องจะปรากฏในแท็บช่อง (โปรไฟล์) ด้วย
-
เราได้ปรับปรุงคำแนะนำในการย้ายข้อมูล YouTube Data API (v3) เพื่อสังเกตว่า v3 API จะรองรับฟีเจอร์ v2 API ต่อไปนี้
-
เราได้ปรับปรุงคำแนะนำในการย้ายข้อมูล API ข้อมูลของ YouTube (v3) เพื่อสังเกตว่า API เวอร์ชัน 2 จะไม่รองรับฟีเจอร์ API เวอร์ชัน 2 ต่อไปนี้
-
ดึงข้อมูลวิดีโอแนะนำ – API v3 จะไม่เรียกข้อมูลรายการที่มีเฉพาะวิดีโอที่แนะนำสำหรับผู้ใช้ API ปัจจุบัน อย่างไรก็ตาม คุณใช้ v3 API เพื่อค้นหาวิดีโอแนะนำได้โดยเรียกใช้เมธอด
activities.list
และตั้งค่าพารามิเตอร์home
เป็นtrue
ในการตอบกลับ API ทรัพยากรสอดคล้องกับวิดีโอแนะนำหากค่าของพร็อพเพอร์ตี้
snippet.type
เป็นrecommendation
ในกรณีนี้ พร็อพเพอร์ตี้contentDetails.recommendation.reason
และcontentDetails.recommendation.seedResourceId
จะมีข้อมูลเกี่ยวกับเหตุผลที่แนะนำวิดีโอ ทั้งนี้ เราไม่รับประกันว่าการตอบกลับจะมีวิดีโอแนะนำตามจำนวนที่เฉพาะเจาะจงใดๆ -
เรียกดูวิดีโอที่ต้องสมัครรับข้อมูลใหม่ – API v3 จะไม่เรียกรายการที่มีเฉพาะวิดีโอซึ่งเพิ่งอัปโหลดไปยังช่องที่ผู้ใช้ API สมัครรับข้อมูล อย่างไรก็ตาม คุณสามารถใช้ v3 API เพื่อค้นหาวิดีโอที่ต้องสมัครใช้บริการใหม่ได้โดยเรียกใช้เมธอด
activities.list
และตั้งค่าพารามิเตอร์home
เป็นtrue
ในการตอบกลับของ API ทรัพยากรจะสอดคล้องกับวิดีโอการสมัครใช้บริการใหม่หากค่าของพร็อพเพอร์ตี้
snippet.type
คือupload
ทั้งนี้ เราไม่รับประกันว่าการตอบกลับจะมีจำนวนวิดีโอที่มีการสมัครรับข้อมูลใหม่ -
ข้อความ Push สำหรับการอัปเดตฟีด – ข้อความ Push ที่รองรับ v2 API โดยใช้ Simple Update Protocol (SUP) หรือ PubSubHubbub เพื่อตรวจสอบฟีดกิจกรรมของผู้ใช้สำหรับผู้ใช้ YouTube การแจ้งเตือนมีให้สำหรับการติดตามช่องใหม่ และเมื่อมีการให้คะแนน แบ่งปัน ทำเครื่องหมายเป็นรายการโปรด แสดงความคิดเห็น หรืออัปโหลด
v3 API จะรองรับข้อความ Push โดยใช้โปรโตคอล PubSubHubbub แต่การแจ้งเตือนจะครอบคลุมเฉพาะการอัปโหลดวิดีโอและการอัปเดตชื่อวิดีโอหรือคำอธิบายวิดีโอ
-
ตำแหน่งของช่อง – API เวอร์ชัน 2 ใช้แท็ก
<yt:location>
เพื่อระบุตำแหน่งของผู้ใช้ตามที่ป้อนในโปรไฟล์สาธารณะของ YouTube ของช่อง แม้ว่านักพัฒนาซอฟต์แวร์บางรายใช้ฟิลด์นี้เพื่อเชื่อมโยงช่องกับประเทศหนึ่งๆ แต่ข้อมูลของช่องนั้นไม่สามารถใช้เพื่อวัตถุประสงค์ดังกล่าวอย่างสม่ำเสมอได้ -
ตั้งค่าหรือเรียกแท็กนักพัฒนาซอฟต์แวร์ – API เวอร์ชัน 2 รองรับความสามารถในการเชื่อมโยงคีย์เวิร์ดหรือแท็กนักพัฒนาซอฟต์แวร์กับวิดีโอในขณะที่อัปโหลดวิดีโอ แท็กนักพัฒนาซอฟต์แวร์จะไม่แสดงต่อผู้ใช้ YouTube แต่เจ้าของวิดีโอสามารถดึงข้อมูลวิดีโอที่ตรงกับแท็กนักพัฒนาซอฟต์แวร์หนึ่งๆ ได้
API v3 จะมีฟีเจอร์ที่คล้ายกันแต่ไม่เหมือนกัน กล่าวอย่างเจาะจงคือ นักพัฒนาซอฟต์แวร์จะค้นหาวิดีโอที่อัปโหลดโดยแอปพลิเคชันของนักพัฒนาซอฟต์แวร์เองได้ สำหรับฟีเจอร์นี้ วิดีโอที่อัปโหลดแต่ละรายการจะได้รับการติดแท็กด้วยหมายเลขโปรเจ็กต์ที่เชื่อมโยงกับแอปพลิเคชันของนักพัฒนาซอฟต์แวร์ใน Google Developers Console โดยอัตโนมัติ จากนั้นนักพัฒนาซอฟต์แวร์จะใช้หมายเลขโปรเจ็กต์เดียวกันเพื่อค้นหาวิดีโอ
-
แสดงรายการวิดีโอตามวันที่เผยแพร่ ยอดดู หรือการจัดประเภท – ใน API เวอร์ชัน 2 พารามิเตอร์
orderby
จะช่วยให้คุณจัดเรียงวิดีโอในเพลย์ลิสต์ตามตำแหน่ง ระยะเวลา วันที่เผยแพร่ ชื่อ และค่าอื่นๆ ได้อีกมากมาย ใน API เวอร์ชัน 3 โดยทั่วไปแล้วรายการเพลย์ลิสต์จะจัดเรียงตามลำดับจากน้อยไปมาก และตัวเลือกการจัดเรียงอื่นๆ จะใช้งานไม่ได้โดยมีข้อยกเว้นบางประการ ระบบจะเพิ่มวิดีโอที่อัปโหลด วิดีโอโปรด วิดีโอที่ชอบ หรือวิดีโอที่ดูล่าสุดโดยอัตโนมัติเป็นรายการแรก (
snippet.position
=0
) สำหรับเพลย์ลิสต์ประเภทต่อไปนี้ ดังนั้น รายการเหล่านี้จึงจัดเรียงอย่างมีประสิทธิภาพตามลำดับจากใหม่สุดไปเก่าสุด ตามเวลาที่มีการเพิ่มสินค้าลงในรายการ- การอัปโหลดของผู้ใช้
- วิดีโอโปรด
- วิดีโอที่ชอบ
- ประวัติการดู
อย่างไรก็ตาม โปรดทราบว่ารายการใหม่ที่เพิ่มไปยังส่วน "ดูภายหลัง" เพลย์ลิสต์จะเพิ่มเป็นรายการสุดท้ายในรายการนั้น เพื่อให้จัดเรียงรายการอย่างมีประสิทธิภาพจากเก่าสุดไปใหม่สุด
-
การประมวลผลแบบกลุ่ม – API v3 รองรับกรณีการใช้งานการประมวลผลเป็นกลุ่มรายการใดรายการหนึ่งที่ API v2 เคยรองรับ เมธอด
channels.list
,channelSections.list
,guideCategories.list
,playlistItems.list
,playlists.list
,subscriptions.list
,videoCategories.list
และvideos.list
ของ v3 API ทั้งหมดรองรับพารามิเตอร์id
ซึ่งสามารถใช้เพื่อระบุรายการรหัสที่คั่นด้วยคอมมา (รหัสวิดีโอ รหัสช่อง ฯลฯ) เมื่อใช้วิธีการเหล่านี้ คุณจะเรียกข้อมูลรายการทรัพยากรหลายรายการได้ด้วยคำขอเดียว
เมื่อมีการเปลี่ยนแปลงเหล่านี้ คำแนะนำจะระบุฟังก์ชันการทำงานทั้งหมดที่รองรับใน API เก่า (v2) ที่จะเลิกใช้งานใน API ปัจจุบัน (v3)
-
4 มีนาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ขณะนี้เมธอด
channelSections.delete
และchannelSections.update
รองรับพารามิเตอร์onBehalfOfContentOwner
แล้ว ซึ่งวิธีอื่นๆ นั้นรองรับอยู่แล้ว -
พร็อพเพอร์ตี้ต่อไปนี้และพร็อพเพอร์ตี้ย่อยเลิกใช้งานแล้ว
brandingSettings.image.backgroundImageUrl
brandingSettings.image.largeBrandedBannerImageImapScript
brandingSettings.image.largeBrandedBannerImageUrl
brandingSettings.image.smallBrandedBannerImageImapScript
brandingSettings.image.smallBrandedBannerImageUrl
หมายเหตุ: พร็อพเพอร์ตี้เหล่านี้ไม่ได้อยู่ภายใต้นโยบายการเลิกใช้งาน API
-
พร็อพเพอร์ตี้
contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons
ใหม่ของทรัพยากรvideo
ระบุเหตุผลที่อธิบายว่าเหตุใดวิดีโอจึงได้รับคะแนน DJCQT (บราซิล) -
ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย notFound (404)
channelNotFound
เมธอด channels.update
จะแสดงผลข้อผิดพลาดนี้หากพารามิเตอร์id
ของคำขอระบุแชแนลที่ไม่พบbadRequest (400)
manualSortRequiredinvalidValue
เมธอด playlistItems.insert
และplaylistItems.update
จะแสดงข้อผิดพลาดนี้หากคำขอพยายามกำหนดตำแหน่งรายการในเพลย์ลิสต์ แต่เพลย์ลิสต์ไม่ได้ใช้การจัดเรียงด้วยตนเอง เช่น รายการในเพลย์ลิสต์อาจจัดเรียงตามวันที่หรือความนิยม คุณแก้ไขข้อผิดพลาดนี้ได้โดยการนำองค์ประกอบsnippet.position
ออกจากทรัพยากรที่ส่งในเนื้อหาคำขอ หากต้องการให้รายการในเพลย์ลิสต์มีตำแหน่งที่เฉพาะเจาะจงในรายการ คุณต้องอัปเดตการตั้งค่าการจัดลำดับของเพลย์ลิสต์เป็นกำหนดเองก่อน คุณปรับการตั้งค่านี้ได้ในเครื่องมือจัดการวิดีโอของ YouTubeforbidden (403)
channelClosed
เมธอด playlists.list
จะแสดงข้อผิดพลาดนี้หากพารามิเตอร์channelId
ของคำขอระบุแชแนลที่ถูกปิดไปแล้วforbidden (403)
channelSuspended
เมธอด playlists.list
จะแสดงข้อผิดพลาดนี้หากพารามิเตอร์channelId
ของคำขอระบุแชแนลที่ถูกระงับforbidden (403)
playlistForbidden
เมธอด playlists.list
จะแสดงข้อผิดพลาดนี้หากพารามิเตอร์id
ของคำขอไม่รองรับคำขอ หรือคำขอไม่ได้รับอนุญาตอย่างถูกต้องnotFound (404)
channelNotFound
เมธอด playlists.list
จะแสดงผลข้อผิดพลาดนี้หากพารามิเตอร์channelId
ของคำขอระบุแชแนลที่ไม่พบnotFound (404)
playlistNotFound
เมธอด playlists.list
จะแสดงข้อผิดพลาดนี้หากพารามิเตอร์id
ของคำขอระบุเพลย์ลิสต์ที่ไม่พบnotFound (404)
videoNotFound
เมธอด videos.list
จะแสดงผลข้อผิดพลาดนี้หากพารามิเตอร์id
ของคำขอระบุวิดีโอที่ไม่พบbadRequest (400)
invalidRating
เมธอด videos.rate
จะแสดงผลข้อผิดพลาดนี้หากคำขอมีค่าที่ไม่คาดคิดสำหรับพารามิเตอร์rating
2 มีนาคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตอนนี้เมธอด
search.list
รองรับพารามิเตอร์relevanceLanguage
แล้ว ซึ่งจะช่วยให้คุณขอผลการค้นหาที่เกี่ยวข้องกับภาษาใดภาษาหนึ่งมากที่สุดได้เรายังได้อัปเดตคำแนะนำในการย้ายข้อมูล YouTube Data API (v3) เพื่ออธิบายวิธีใช้พารามิเตอร์ใหม่นี้ด้วย พารามิเตอร์จะระบุช่องว่างของฟีเจอร์ที่มีอยู่ก่อนหน้านี้ระหว่าง API เวอร์ชันปัจจุบัน (v3) และเวอร์ชันก่อนหน้า (v2) ซึ่งเลิกใช้งานแล้ว
-
เราได้ปรับปรุงคำแนะนำในการย้ายข้อมูล YouTube Data API (v3) เพื่อระบุการเลิกใช้งานฟีดพิเศษและฟิลด์ข้อมูลเมตาที่ v2 มีให้ในการอธิบายภาพยนตร์ ตัวอย่าง รายการทีวี ซีซันรายการทีวี และตอนต่างๆ ของรายการโทรทัศน์
14 มกราคม 2015
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เราได้ปรับปรุงคำแนะนำในการย้ายข้อมูล API ข้อมูลของ YouTube (v3) เพื่ออธิบายวิธีใช้ API เวอร์ชัน 3 ในการอัปโหลดวิดีโอโดยใช้ JavaScript (ดูรายละเอียดในส่วนอัปโหลดวิดีโอ) ฟังก์ชันนี้เทียบได้กับฟังก์ชันการอัปโหลดบนเบราว์เซอร์ที่ v2 API รองรับ โปรดทราบว่าการเปลี่ยนแปลงคำแนะนำในการย้ายข้อมูลนี้ไม่ได้แสดงถึงการเปลี่ยนแปลง API จริง แต่เป็นความพร้อมใช้งานของโค้ดตัวอย่างใหม่สำหรับการอัปโหลดวิดีโอด้วย JavaScript ฝั่งไคลเอ็นต์
เนื่องจากการรองรับการอัปโหลดวิดีโอด้วยไลบรารีของไคลเอ็นต์ JavaScript และ CORS คำแนะนำในการย้ายข้อมูลจะไม่แสดงการอัปโหลดผ่านเบราว์เซอร์ว่าเป็นฟีเจอร์ที่อาจเลิกใช้งานใน API เวอร์ชัน 3 อีกต่อไป
-
เอกสารสำหรับเมธอด
videos.insert
ได้รับการอัปเดตให้รวมตัวอย่างโค้ด JavaScript ใหม่ตามที่อธิบายไว้ข้างต้น มีการอัปเดตรายการตัวอย่างโค้ด JavaScript สำหรับ YouTube Data API (v3) ด้วย
11 พฤศจิกายน 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ต้นทุนโควต้าสำหรับการเรียกเมธอด
search.list
เปลี่ยนเป็น 100 หน่วยแล้วสำคัญ: ในหลายกรณี คุณสามารถใช้เมธอด API อื่นๆ เพื่อเรียกข้อมูลด้วยค่าใช้จ่ายในโควต้าที่ต่ำกว่าได้ ตัวอย่างเช่น ลองพิจารณา 2 วิธีนี้ในการค้นหาวิดีโอที่อัปโหลดลงในช่อง GoogleDevelopers
-
ต้นทุนโควต้า: 100 หน่วย
เรียกใช้เมธอด
search.list
และค้นหาGoogleDevelopers
-
ต้นทุนโควต้า: 6 หน่วย
เรียกใช้เมธอด
channels.list
เพื่อค้นหารหัสช่องที่ถูกต้อง ตั้งค่าพารามิเตอร์forUsername
เป็นGoogleDevelopers
และพารามิเตอร์part
เป็นcontentDetails
ในการตอบกลับของ API พร็อพเพอร์ตี้contentDetails.relatedPlaylists.uploads
จะระบุรหัสเพลย์ลิสต์สำหรับวิดีโอที่อัปโหลดของช่องจากนั้นเรียกเมธอด
playlistItems.list
และตั้งค่าพารามิเตอร์playlistId
เป็นรหัสที่บันทึกไว้และพารามิเตอร์part
เป็นsnippet
-
8 ตุลาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ทรัพยากร
channel
มีพร็อพเพอร์ตี้ใหม่ 2 รายการ ได้แก่-
พร็อพเพอร์ตี้
status.longUploadsStatus
จะระบุว่าช่องมีสิทธิ์อัปโหลดวิดีโอที่มีความยาวมากกว่า 15 นาทีหรือไม่ ระบบจะแสดงพร็อพเพอร์ตี้นี้เมื่อเจ้าของช่องให้สิทธิ์คำขอ API เท่านั้น ค่าพร็อพเพอร์ตี้ที่ถูกต้องมีดังนี้allowed
– ช่องสามารถอัปโหลดวิดีโอที่มีความยาวมากกว่า 15 นาทีeligible
– ช่องมีสิทธิ์อัปโหลดวิดีโอที่มีความยาวเกิน 15 นาที แต่ต้องเปิดใช้ฟีเจอร์นี้ก่อนdisallowed
– ช่องไม่มีสิทธิ์หรือไม่มีสิทธิ์อัปโหลดวิดีโอที่มีความยาวเกิน 15 นาที
ดูคำจำกัดความของพร็อพเพอร์ตี้เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับค่าเหล่านี้ นอกจากนี้ ศูนย์ช่วยเหลือของ YouTube ยังมีข้อมูลโดยละเอียดเพิ่มเติมเกี่ยวกับฟีเจอร์นี้
-
พร็อพเพอร์ตี้
invideoPromotion.useSmartTiming
จะระบุว่าแคมเปญโปรโมชันของช่องใช้ "ช่วงเวลาอัจฉริยะ" หรือไม่ ฟีเจอร์นี้จะพยายามแสดงการโปรโมตที่จุดใดจุดหนึ่งในวิดีโอ ซึ่งมีแนวโน้มที่จะถูกคลิกมากขึ้นและมีแนวโน้มที่จะรบกวนประสบการณ์การรับชมน้อยลง ฟีเจอร์นี้ยังเลือกใช้การโปรโมตรายการเดียวเพื่อแสดงในวิดีโอแต่ละรายการด้วย
-
-
ทั้งคำจำกัดความของพร็อพเพอร์ตี้
snippet.title
และsnippet.categoryId
ของทรัพยากรvideo
ได้รับการอัปเดตเพื่ออธิบายวิธีที่ API จัดการการเรียกเมธอดvideos.update
หากเรียกใช้เมธอดนั้นเพื่ออัปเดตส่วนsnippet
ของทรัพยากรvideo
คุณจะต้องตั้งค่าให้กับพร็อพเพอร์ตี้ทั้ง 2 รายการหากคุณพยายามอัปเดตส่วน
snippet
ของทรัพยากรvideo
แต่ไม่ได้กำหนดค่าให้กับพร็อพเพอร์ตี้ทั้ง 2 รายการ API จะแสดงข้อผิดพลาดinvalidRequest
รายละเอียดของข้อผิดพลาดดังกล่าวได้รับการอัปเดตด้วย -
พร็อพเพอร์ตี้
contentDetails.contentRating.oflcRating
ของแหล่งข้อมูลvideo
ซึ่งระบุการจัดประเภทวิดีโอจากสำนักงานการจัดประเภทภาพยนตร์และวรรณกรรมของนิวซีแลนด์รองรับการจัดประเภทใหม่ 2 รายการแล้ว ได้แก่oflcRp13
และoflcRp16
ซึ่งสอดคล้องกับการให้คะแนนRP13
และRP16
ตามลำดับ -
เมธอด
channelBanners.insert
รองรับข้อผิดพลาดต่อไปนี้แล้วประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest
bannerAlbumFull
อัลบั้มหน้าปกช่อง YouTube ของเจ้าของช่องมีรูปภาพมากเกินไป เจ้าของช่องควรไปที่ http://photos.google.com, ไปที่หน้าอัลบั้ม และนำรูปภาพบางส่วนออกจากอัลบั้มนั้น
12 กันยายน 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ต้นทุนโควต้าสำหรับการเรียกเมธอด
search.list
เปลี่ยนจาก 1 หน่วยเป็น 2 หน่วย นอกเหนือจากต้นทุนของส่วนทรัพยากรที่ระบุ
13 สิงหาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เมธอด
subscriptions.insert
รองรับข้อผิดพลาดต่อไปนี้แล้วประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest
subscriptionLimitExceeded
สมาชิกที่ระบุพร้อมคำขอเกินขีดจำกัดอัตราการสมัครใช้บริการแล้ว ส่วนคุณจะลองสมัครใช้บริการเพิ่มเติมได้ในอีก 2-3 ชั่วโมง
12 สิงหาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
คำแนะนำใหม่ที่ชื่อการย้ายข้อมูลแอปพลิเคชันของคุณไปยัง YouTube Data API (v3) จะอธิบายวิธีใช้ YouTube Data API (v3) เพื่อใช้งานฟังก์ชันการใช้งานที่มีใน YouTube Data API (v2) API เดิมได้เลิกใช้งานอย่างเป็นทางการตั้งแต่วันที่ 4 มีนาคม 2014 คู่มือนี้มีวัตถุประสงค์เพื่อช่วยคุณย้ายแอปพลิเคชันที่ยังใช้ API v2 อยู่ไปยัง API เวอร์ชันล่าสุด
8 กรกฎาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เมธอด
playlists.insert
รองรับข้อผิดพลาดต่อไปนี้แล้วประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest
maxPlaylistExceeded
ข้อผิดพลาดนี้เกิดขึ้นหากไม่สามารถสร้างเพลย์ลิสต์ได้เนื่องจากช่องมีเพลย์ลิสต์ถึงจำนวนสูงสุดที่อนุญาตแล้ว
18 มิถุนายน 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
คำอธิบายเมธอด API แต่ละเมธอดได้รับการอัปเดตให้รวมต้นทุนโควต้าที่เกิดจากการเรียกใช้เมธอดนั้น ในทํานองเดียวกัน มีการอัปเดตคําจํากัดความของพารามิเตอร์
part
เพื่อระบุต้นทุนโควต้าของแต่ละส่วนที่ดึงได้ในการเรียก API เช่น การเรียกใช้เมธอดsubscriptions.insert
จะมีต้นทุนโควต้าประมาณ 50 หน่วย ทรัพยากรsubscription
ยังมี 3 ส่วน (snippet
,contentDetails
และsubscriberSnippet
) และแต่ละส่วนจะมีค่าใช้จ่าย 2 หน่วยโปรดทราบว่าค่าใช้จ่ายสำหรับโควต้าอาจเปลี่ยนแปลงได้โดยไม่ต้องแจ้งให้ทราบ
-
ปัจจุบัน แหล่งข้อมูล
video
รองรับระบบการจัดประเภทเนื้อหาใหม่ 43 ระบบซึ่งระบุการจัดประเภทที่วิดีโอได้รับจากหน่วยงานการจัดประเภทระดับประเทศต่างๆ ระบบการจัดประเภทที่ได้รับการสนับสนุนใหม่นี้มาจากอาร์เจนตินา ออสเตรียเบลเยียม และบัลแกเรีย ชิลี (ชิลี (1, ชิลี (1 และทั้งหมดนี้) มีตั้งแต่อาร์เจนตินา ออสเตรีย เบลเยียม และบัลแกเรีย ชิลี (ชิลีและชิลี (1, ชิลี (111118ต่อตั้งแต่คุณของประเทศและของประเทศอาร์เจนตินา ออสเตรียเบลเยียม และบัลแกเรีย ชิลี (ชิลี) ชิลีและชิลี (1, ชิลี (1, 28. อย่าให้ประเทศและกระบวนการที่เราสนับสนุน{12
28 พฤษภาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตอนนี้เมธอด
search.list
รองรับพารามิเตอร์location
และlocationRadius
แล้ว ซึ่งจะช่วยให้คุณค้นหาวิดีโอที่เชื่อมโยงกับสถานที่ตั้งทางภูมิศาสตร์ได้ คำขอต้องระบุค่าของพารามิเตอร์ทั้ง 2 ตัวเพื่อดึงผลลัพธ์ตามตำแหน่ง และ API จะแสดงข้อผิดพลาดหากคำขอมีเพียงพารามิเตอร์เดียวจาก 2 พารามิเตอร์-
พารามิเตอร์
location
ระบุพิกัดละติจูด/ลองจิจูดที่ศูนย์กลางของพื้นที่ทางภูมิศาสตร์ที่เป็นวงกลม -
พารามิเตอร์
locationRadius
จะระบุระยะทางสูงสุดที่ตำแหน่งที่เชื่อมโยงกับวิดีโอจะต้องอยู่ตรงกึ่งกลางของพื้นที่เพื่อให้วิดีโอยังคงรวมอยู่ในผลการค้นหา
-
13 พฤษภาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
พร็อพเพอร์ตี้
invideoPromotion.items[]
ของทรัพยากรchannel
ได้รับการอัปเดตแล้วโปรดทราบว่าโดยปกติแล้วคุณจะตั้งค่ารายการที่โปรโมตสำหรับช่องของคุณได้ 1 รายการเท่านั้น หากคุณพยายามแทรกรายการที่โปรโมตจำนวนมากเกินไป API จะแสดงผลข้อผิดพลาดtooManyPromotedItems
ซึ่งมีรหัสสถานะ HTTP400
-
ตอนนี้แหล่งข้อมูล
channelSection
จะมีข้อมูลเกี่ยวกับเนื้อหาเด่นประเภทใหม่ 2-3 ประเภท พร็อพเพอร์ตี้snippet.type
ของทรัพยากรchannelSection
รองรับค่าต่อไปนี้แล้วpostedPlaylists
- เพลย์ลิสต์ที่เจ้าของช่องโพสต์ลงในฟีดกิจกรรมของช่องpostedVideos
- วิดีโอที่เจ้าของช่องโพสต์ลงในฟีดกิจกรรมของช่องsubscriptions
- ช่องที่เจ้าของช่องติดตาม
-
พร็อพเพอร์ตี้
contentDetails.contentRating.ifcoRating
ใหม่ของทรัพยากรvideo
ระบุการจัดประเภทที่วิดีโอได้รับจากสำนักงานการจัดประเภทภาพยนตร์ของไอร์แลนด์ (Irish Film Classification Office) -
อัปเดตคำจำกัดความของพร็อพเพอร์ตี้
position.cornerPosition
ของทรัพยากรwatermark
แล้ว โปรดทราบว่าลายน้ำจะปรากฏที่มุมขวาบนของโปรแกรมเล่นเสมอ -
อัปเดตคําจํากัดความของพารามิเตอร์
q
สําหรับเมธอดsearch.list
แล้ว โปรดทราบว่าคําค้นหาสามารถใช้โอเปอเรเตอร์บูลีน NOT (-
) เพื่อยกเว้นวิดีโอที่เชื่อมโยงกับข้อความค้นหาหนึ่งๆ ได้ ค่ายังสามารถใช้โอเปอเรเตอร์บูลีน OR (|
) เพื่อค้นหาวิดีโอที่เชื่อมโยงกับหนึ่งในข้อความค้นหาต่างๆ ได้อีกด้วย -
คําจํากัดความของพร็อพเพอร์ตี้
pageInfo.totalResults
ที่แสดงผลในการตอบกลับของ API ต่อการเรียกsearch.list
ได้รับการอัปเดตแล้วเนื่องจากค่าดังกล่าวเป็นค่าประมาณและอาจไม่ได้แสดงค่าที่แน่นอน นอกจากนี้ ค่าสูงสุดคือ 1,000,000 คุณไม่ควรใช้ค่านี้เพื่อสร้างลิงก์การใส่เลขหน้า ให้ใช้ค่าพร็อพเพอร์ตี้nextPageToken
และprevPageToken
แทนเพื่อกำหนดว่าจะแสดงลิงก์การใส่เลขหน้าหรือไม่ -
ระบบได้อัปเดตเมธอด
watermarks.set
และwatermarks.unset
เพื่อแสดงให้เห็นว่า API ส่งโค้ดตอบกลับ HTTP204
สำหรับคำขอที่ส่งไปยังเมธอดเหล่านั้นได้สำเร็จ
2 พฤษภาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
แหล่งข้อมูลใหม่
i18nLanguage
ระบุภาษาของแอปพลิเคชันที่เว็บไซต์ YouTube รองรับ ภาษาของแอปพลิเคชันอาจหมายถึงภาษา UI ได้เช่นกัน สำหรับเว็บไซต์ YouTube ระบบจะเลือกภาษาของแอปพลิเคชันให้โดยอัตโนมัติตามการตั้งค่าบัญชี Google, ภาษาของเบราว์เซอร์ หรือตำแหน่ง IP นอกจากนี้ผู้ใช้ยังเลือกภาษา UI ที่ต้องการด้วยตนเองจากส่วนท้ายของเว็บไซต์ YouTube ได้อีกด้วยAPI รองรับเมธอดในการแสดงภาษาของแอปพลิเคชันที่รองรับ ภาษาที่รองรับสามารถใช้เป็นค่าของพารามิเตอร์
hl
เมื่อเรียกใช้เมธอด API เช่นvideoCategories.list
และguideCategories.list
-
ทรัพยากร
i18nRegion
ใหม่จะระบุพื้นที่ทางภูมิศาสตร์ที่ผู้ใช้ YouTube สามารถเลือกเป็นภูมิภาคของเนื้อหาที่ต้องการได้ ภูมิภาคของเนื้อหาอาจหมายถึงภาษาของเนื้อหาได้เช่นกัน สำหรับเว็บไซต์ YouTube อาจมีการเลือกภูมิภาคของเนื้อหาโดยอัตโนมัติตามการเรียนรู้ เช่น โดเมน YouTube หรือตำแหน่ง IP ของผู้ใช้ และผู้ใช้สามารถเลือกภูมิภาคเนื้อหาที่ต้องการด้วยตนเองได้จากส่วนท้ายของเว็บไซต์ YouTubeAPI รองรับเมธอดในการแสดงรายการภูมิภาคเนื้อหาที่รองรับ รหัสภูมิภาคที่รองรับสามารถใช้เป็นค่าของพารามิเตอร์
regionCode
เมื่อเรียกใช้เมธอด API เช่นsearch.list
,videos.list
,activities.list
และvideoCategories.list
7 เมษายน 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
แหล่งข้อมูล
channelSection
ใหม่มีข้อมูลเกี่ยวกับชุดวิดีโอที่ช่องเลือกแสดง ตัวอย่างเช่น ส่วนหนึ่งอาจมีการอัปโหลดล่าสุดของช่อง การอัปโหลดยอดนิยม หรือวิดีโอจากเพลย์ลิสต์อย่างน้อย 1 รายการAPI รองรับเมธอดในการแสดงรายการ แทรก อัปเดต หรือลบส่วนช่อง คุณสามารถเรียกดูรายการของส่วนช่องสำหรับช่องของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์แล้ว โดยระบุรหัสช่องที่เฉพาะเจาะจง หรือระบุรายการรหัสส่วนช่องที่ไม่ซ้ำกัน
และได้อัปเดตเอกสารข้อผิดพลาดเพื่ออธิบายข้อความแสดงข้อผิดพลาดที่ API รองรับสำหรับเมธอดใหม่เหล่านี้โดยเฉพาะ
-
อัปเดตคำจำกัดความของออบเจ็กต์
fileDetails
ของทรัพยากรvideo
เพื่ออธิบายว่าระบบจะแสดงผลออบเจ็กต์ดังกล่าวต่อเมื่อพร็อพเพอร์ตี้processingDetails.fileDetailsAvailability
ของวิดีโอมีค่าเป็นavailable
เท่านั้นในทํานองเดียวกัน ระบบได้อัปเดตคําจํากัดความของออบเจ็กต์
suggestions
ของทรัพยากรvideo
เพื่ออธิบายว่าออบเจ็กต์ดังกล่าวจะแสดงผลก็ต่อเมื่อพร็อพเพอร์ตี้processingDetails.tagSuggestionsAvailability
ของวิดีโอหรือพร็อพเพอร์ตี้processingDetails.editorSuggestionsAvailability
มีค่าเป็นavailable
-
ระบบได้อัปเดตเอกสารสําหรับเมธอด
videos.insert
และvideos.update
แล้ว เพื่อแสดงให้เห็นว่าจะตั้งค่าพร็อพเพอร์ตี้status.publishAt
ได้เมื่อเรียกใช้เมธอดเหล่านั้น -
อัปเดตคำจำกัดความของออบเจ็กต์
invideoPromotion
ของทรัพยากรchannel
เพื่ออธิบายว่ามีเพียงเจ้าของช่องที่ดึงข้อมูลออบเจ็กต์ได้ -
ระบบได้อัปเดตรายการพารามิเตอร์สำหรับเมธอด
videos.rate
เพื่อแสดงให้เห็นว่าเมธอดนั้นไม่รองรับพารามิเตอร์onBehalfOfContentOwner
จริงๆ นี่เป็นข้อผิดพลาดในเอกสารเนื่องจากคำขอvideos.rate
ที่ตั้งค่าพารามิเตอร์นี้แสดงข้อผิดพลาด500
31 มีนาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
พร็อพเพอร์ตี้
status.publishAt
ใหม่ของทรัพยากรvideo
ช่วยให้คุณระบุวันที่และเวลาที่กำหนดให้เผยแพร่วิดีโอส่วนตัวได้ คุณจะตั้งค่าพร็อพเพอร์ตี้นี้ได้ก็ต่อเมื่อสถานะความเป็นส่วนตัวของวิดีโอคือprivate
และไม่เคยมีการเผยแพร่วิดีโอ พร็อพเพอร์ตี้ใหม่นี้ไม่อยู่ภายใต้นโยบายการเลิกใช้งาน
13 มีนาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
API รองรับส่วน
contentOwnerDetails
สำหรับทรัพยากรchannel
แล้ว ส่วนใหม่จะมีข้อมูลช่องที่เกี่ยวข้องกับพาร์ทเนอร์ YouTube ที่ลิงก์กับช่อง ซึ่งรวมถึงรหัสของเจ้าของเนื้อหาที่ลิงก์กับช่อง ตลอดจนวันที่และเวลาที่เจ้าของเนื้อหากับช่องลิงก์กัน โปรดทราบว่าส่วนใหม่นี้ไม่อยู่ภายใต้นโยบายการเลิกใช้งาน -
เอกสารประกอบจะแสดงความยาวอักขระสูงสุดที่รองรับสำหรับพร็อพเพอร์ตี้ต่อไปนี้
ทรัพยากร พร็อพเพอร์ตี้ ความยาวสูงสุด channel
invideoPromotion.items[].customMessage
40 อักขระ video
snippet.title
100 อักขระ video
snippet.description
5000 ไบต์ video
snippet.tags
500 อักขระ โปรดทราบว่าค่าพร็อพเพอร์ตี้เป็นรายการ และเครื่องหมายจุลภาคระหว่างรายการในลิสต์จะนับรวมในขีดจำกัด -
พร็อพเพอร์ตี้
brandingSettings.watch.featuredPlaylistId
ของทรัพยากรchannel
เลิกใช้งานแล้ว API จะแสดงข้อผิดพลาดหากคุณพยายามตั้งค่า -
เพิ่มพร็อพเพอร์ตี้ทรัพยากร
video
ต่อไปนี้ลงในรายการค่าที่ตั้งค่าได้เมื่อแทรกหรืออัปเดตวิดีโอ -
ตอนนี้เอกสารข้อผิดพลาดจะระบุโค้ดตอบกลับ HTTP สำหรับข้อผิดพลาดแต่ละประเภท
-
ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest (400)
invalidCriteria
เมธอด channels.list
จะแสดงผลข้อผิดพลาดนี้หากคำขอระบุพารามิเตอร์ตัวกรองที่ใช้ร่วมกันไม่ได้badRequest (400)
channelTitleUpdateForbidden
เมธอด channels.update
จะแสดงผลข้อผิดพลาดนี้หากคุณพยายามอัปเดตส่วนbrandingSettings
ของช่องและเปลี่ยนค่าของพร็อพเพอร์ตี้brandingSettings.channel.title
(โปรดทราบว่า API จะไม่แสดงข้อผิดพลาดหากคุณไม่ใส่พร็อพเพอร์ตี้ดังกล่าว)badRequest (400)
invalidRecentlyUploadedBy
เมธอด channels.update
จะแสดงข้อผิดพลาดนี้หากพร็อพเพอร์ตี้invideoPromotion.items[].id.recentlyUploadedBy
ระบุรหัสแชแนลที่ไม่ถูกต้องbadRequest (400)
invalidTimingOffset
เมธอด channels.update
จะแสดงผลข้อผิดพลาดนี้หากส่วนinvideoPromotion
ระบุการชดเชยเวลาที่ไม่ถูกต้องbadRequest (400)
tooManyPromotedItems
เมธอด channels.update
จะแสดงผลข้อผิดพลาดนี้หากส่วนinvideoPromotion
ระบุรายการที่โปรโมตมากกว่าจำนวนที่อนุญาตforbidden (403)
promotedVideoNotAllowed
เมธอด channels.update
จะแสดงข้อผิดพลาดนี้หากพร็อพเพอร์ตี้invideoPromotion.items[].id.videoId
ระบุรหัสวิดีโอที่ไม่พบหรือใช้เป็นรายการที่โปรโมตไม่ได้forbidden (403)
websiteLinkNotAllowed
เมธอด channels.update
จะแสดงผลข้อผิดพลาดนี้หากพร็อพเพอร์ตี้invideoPromotion.items[].id.websiteUrl
ระบุ URL ที่ไม่ได้รับอนุญาตrequired (400)
requiredTimingType
เมธอด channels.update
จะแสดงผลข้อผิดพลาดนี้หากคำขอไม่ได้ระบุการตั้งค่าเวลาเริ่มต้นว่าเมื่อใดที่ YouTube ควรแสดงรายการที่โปรโมตrequired (400)
requiredTiming
เมธอด channels.update
ต้องระบุออบเจ็กต์invideoPromotion.items[].timing
สำหรับแต่ละรายการที่โปรโมตrequired (400)
requiredWebsiteUrl
เมธอด channels.update
ต้องระบุพร็อพเพอร์ตี้invideoPromotion.items[].id.websiteUrl
สำหรับรายการที่โปรโมตแต่ละรายการbadRequest (400)
invalidPublishAt
เมธอด videos.insert
จะแสดงผลข้อผิดพลาดนี้หากข้อมูลเมตาของคำขอระบุเวลาการเผยแพร่ที่กำหนดไว้ไม่ถูกต้อง
4 มีนาคม 2014
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ขณะนี้ API ข้อมูลของ YouTube เวอร์ชัน 3 จะอยู่ภายใต้นโยบายการเลิกใช้งานที่อธิบายไว้ในข้อกำหนดในการให้บริการ API ของ YouTube โปรดทราบว่าหน้าที่แสดง API ที่อยู่ภายใต้นโยบายการเลิกใช้งานจะยกเว้นฟังก์ชันการทำงานของ API v3 บางอย่างไม่ให้เป็นไปตามนโยบาย
5 ธันวาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เอกสารประกอบของเมธอด
search.list
ได้รับการอัปเดตอย่างเหมาะสมเพื่อแสดงให้เห็นว่าคุณไม่จำเป็นต้องระบุค่าสำหรับพารามิเตอร์ตัวกรอง 1 รายการเมื่อส่งคำขอการค้นหา แต่คุณสามารถกำหนดค่าให้กับพารามิเตอร์ตัวกรองเป็นศูนย์ หรือสำหรับพารามิเตอร์ตัวกรองหนึ่งรายการได้ -
อัปเดตคําจํากัดความสําหรับพารามิเตอร์ของเมธอด
search.list
แล้ว โปรดทราบว่าคุณต้องตั้งค่าของพารามิเตอร์type
เป็นvideo
หากระบุค่าสําหรับพารามิเตอร์ใดๆ ต่อไปนี้ด้วยeventType
videoCaption
videoCategoryId
videoDefinition
videoDimension
videoDuration
videoEmbeddable
videoLicense
videoSyndicated
videoType
-
ขนาดขั้นต่ำของรูปภาพแบนเนอร์ของช่องที่อัปโหลดได้ลดลงเป็น 2048px x 1152px (ก่อนหน้านี้ ขนาดขั้นต่ำคือ 2120 x 1192 พิกเซล) นอกจากนี้ โปรดทราบว่าเอกสารประกอบของทรัพยากร
channel
ระบุขนาดสูงสุดของรูปภาพแบนเนอร์ที่แสดงจาก API ตัวอย่างเช่น ขนาดสูงสุดของรูปภาพbrandingSettings.image.bannerTvImageUrl
สำหรับแอปพลิเคชันโทรทัศน์คือ 2120 x 1192 พิกเซล แต่รูปภาพจริงอาจมีขนาด 2048 x 1152 พิกเซล ศูนย์ช่วยเหลือของ YouTube มีคำแนะนำเพิ่มเติมในการเพิ่มประสิทธิภาพหน้าปกช่องเพื่อการแสดงผลบนอุปกรณ์ประเภทต่างๆ -
ระบบได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้ทรัพยากร
channel
หลายรายการเพื่อแสดงข้อมูลต่อไปนี้- ค่าของพร็อพเพอร์ตี้
brandingSettings.channel.description
มีความยาวสูงสุดอยู่ที่ 1,000 อักขระ - พร็อพเพอร์ตี้
brandingSettings.channel.featuredChannelsTitle
มีความยาวได้สูงสุด 30 อักขระ - ตอนนี้พร็อพเพอร์ตี้
brandingSettings.channel.featuredChannelsUrls[]
แสดงช่องได้สูงสุด 100 ช่องแล้ว - ค่าพร็อพเพอร์ตี้
brandingSettings.channel.unsubscribedTrailer
หากตั้งค่าไว้ ต้องระบุรหัสวิดีโอ YouTube ของวิดีโอสาธารณะหรือที่ไม่เป็นสาธารณะที่เจ้าของช่องเป็นเจ้าของ
- ค่าของพร็อพเพอร์ตี้
-
ตอนนี้เมธอด
channels.update
รองรับการอัปเดตพร็อพเพอร์ตี้invideoPromotion.items[].promotedByContentOwner
แล้ว พร็อพเพอร์ตี้ดังกล่าวระบุว่าชื่อของเจ้าของเนื้อหาจะแสดงเมื่อแสดงโปรโมชันหรือไม่ โดยจะตั้งค่าได้ต่อเมื่อมีการสร้างคำขอ API ที่ตั้งค่าพร็อพเพอร์ตี้ในนามของเจ้าของเนื้อหาโดยใช้พารามิเตอร์onBehalfOfContentOwner
-
ขณะนี้เมธอด
playlistItems.list
และplaylistItems.insert
รองรับพารามิเตอร์onBehalfOfContentOwner
แล้ว ซึ่งวิธีอื่นๆ นั้นรองรับอยู่แล้ว -
ปัจจุบันพร็อพเพอร์ตี้
contentDetails.contentRating.acbRating
สามารถระบุการจัดประเภทจาก Australian Classification Board (ACB) ของภาพยนตร์ หรือจาก Australian Communications and Media Authority (ACMA) สำหรับรายการโทรทัศน์สำหรับเด็กได้ -
พร็อพเพอร์ตี้
contentDetails.contentRating.catvRating
และcontentDetails.contentRating.catvfrRating
ใหม่ระบุการจัดประเภทที่วิดีโอได้รับภายใต้ระบบการจัดประเภททีวีของแคนาดาและระบบการจัดประเภท Régie du cinéma ภาษาฝรั่งเศสซึ่งใช้ในควิเบกตามลำดับ -
พร็อพเพอร์ตี้
snippet.assignable
ใหม่ของทรัพยากรvideoCategory
จะระบุว่าวิดีโอที่อัปเดตหรือวิดีโอที่อัปโหลดใหม่เชื่อมโยงกับหมวดหมู่วิดีโอดังกล่าวได้หรือไม่ -
เพิ่มตัวอย่างโค้ดสำหรับวิธีการต่อไปนี้แล้ว
activities.insert
(ไป)channelBanners.insert
(Python)channels.update
(Python)playlistItems.list
(ไป)search.list
(ไป)thumbnails.set
(Java)videos.insert
(ไป)
24 ตุลาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
API ประกอบด้วยฟีเจอร์เพิ่มเติม 2 อย่างที่ออกแบบมาเพื่อช่วยค้นหาและแสดงเนื้อหาการถ่ายทอดสด
พร็อพเพอร์ตี้
snippet.liveBroadcastContent
ใหม่ในผลการค้นหาจะระบุว่าทรัพยากรของวิดีโอหรือช่องมีเนื้อหาการถ่ายทอดสดหรือไม่ ค่าพร็อพเพอร์ตี้ที่ถูกต้องคือupcoming
,active
และnone
-
พร็อพเพอร์ตี้
snippet.liveBroadcastContent
ใหม่ของทรัพยากรvideo
จะระบุว่าวิดีโอเป็นการถ่ายทอดสดที่กำลังจะเผยแพร่หรือดำเนินอยู่ รายการด้านล่างอธิบายค่าที่เป็นไปได้ของพร็อพเพอร์ตี้upcoming
– วิดีโอเป็นการถ่ายทอดสดที่ยังไม่เริ่มactive
– วิดีโอเป็นการถ่ายทอดสดที่กำลังดำเนินอยู่none
– วิดีโอไม่ได้เป็นการถ่ายทอดสดที่กำลังจะมีขึ้นหรือกำลังดำเนินอยู่ ตัวแปรนี้จะเป็นค่าพร็อพเพอร์ตี้สำหรับการออกอากาศที่เสร็จสมบูรณ์ซึ่งยังคงดูได้ใน YouTube
-
พร็อพเพอร์ตี้
liveStreamingDetails
ใหม่ของทรัพยากรvideo
เป็นออบเจ็กต์ที่มีข้อมูลเมตาเกี่ยวกับการเผยแพร่วิดีโอสด หากต้องการดึงข้อมูลเมตานี้ ให้ใส่liveStreamingDetails
ในรายการส่วนทรัพยากรของค่าพารามิเตอร์part
ข้อมูลเมตาจะมีพร็อพเพอร์ตี้ใหม่ต่อไปนี้liveStreamingDetails.actualStartTime
– เวลาที่การแพร่ภาพเริ่มต้นจริง (ค่านี้จะปรากฏเมื่อสถานะของการออกอากาศคือactive
)liveStreamingDetails.actualEndTime
– เวลาที่การออกอากาศสิ้นสุดลงจริง (ค่านี้จะปรากฏเมื่อการออกอากาศสิ้นสุด)liveStreamingDetails.scheduledStartTime
– เวลาที่กำหนดให้เริ่มการออกอากาศliveStreamingDetails.scheduledEndTime
– เวลาสิ้นสุดของการออกอากาศ หากค่าของพร็อพเพอร์ตี้ว่างเปล่าหรือไม่มีพร็อพเพอร์ตี้ นั่นแปลว่าการออกอากาศจะดำเนินต่อเนื่องไปโดยไม่มีกำหนดสิ้นสุดliveStreamingDetails.concurrentViewers
– จำนวนคนที่ดูการถ่ายทอดสด
หากต้องการดึงข้อมูลเมตานี้ ให้ใส่
liveStreamingDetails
ในค่าพารามิเตอร์part
เมื่อเรียกใช้เมธอดvideos.list
,videos.insert
หรือvideos.update
โปรดทราบว่าได้เปิดตัวคุณลักษณะอีก 2 อย่างสำหรับการระบุเนื้อหาการถ่ายทอดสดเมื่อวันที่ 1 ตุลาคม 2013 ซึ่งได้แก่ พารามิเตอร์
eventType
ของเมธอดsearch.list
และพร็อพเพอร์ตี้snippet.liveBroadcastContent
ของผลการค้นหา -
-
ตอนนี้เมธอด
videos.insert
รองรับพารามิเตอร์notifySubscribers
แล้ว ซึ่งระบุว่า YouTube ควรส่งการแจ้งเตือนเกี่ยวกับวิดีโอใหม่แก่ผู้ใช้ที่ติดตามช่องของวิดีโอนั้นหรือไม่ ค่าเริ่มต้นของพารามิเตอร์คือTrue
ซึ่งระบุว่าผู้ติดตามจะได้รับการแจ้งเตือนเกี่ยวกับวิดีโอที่อัปโหลดใหม่ อย่างไรก็ตาม เจ้าของช่องที่อัปโหลดวิดีโอจำนวนมากอาจต้องการกำหนดค่าเป็นFalse
เพื่อหลีกเลี่ยงการแจ้งเตือนเกี่ยวกับวิดีโอใหม่แต่ละรายการไปยังผู้ติดตามของช่อง -
ระบบได้อัปเดตรายการพร็อพเพอร์ตี้ที่แก้ไขได้เมื่อเรียกใช้เมธอด
channels.update
ให้รวมพร็อพเพอร์ตี้invideoPromotion.items[].customMessage
และinvideoPromotion.items[].websiteUrl
นอกจากนี้ ยังมีการแก้ไขรายการเพื่อระบุพร็อพเพอร์ตี้brandingSettings
ที่แก้ไขได้ พร็อพเพอร์ตี้brandingSettings
เหล่านี้แก้ไขได้อยู่แล้ว การเปลี่ยนแปลงในเอกสารจึงไม่ได้สะท้อนถึงการเปลี่ยนแปลงฟังก์ชันที่มีอยู่ของ API -
ขณะนี้เมธอด
playlists.insert
,playlists.update
และplaylists.delete
รองรับพารามิเตอร์onBehalfOfContentOwner
แล้ว ซึ่งวิธีอื่นๆ นั้นรองรับอยู่แล้ว -
ตอนนี้เมธอด
playlists.insert
รองรับพารามิเตอร์onBehalfOfContentOwnerChannel
แล้ว ซึ่งวิธีอื่นๆ นั้นรองรับอยู่แล้ว -
พร็อพเพอร์ตี้
contentDetails.contentRating.tvpgRating
ของทรัพยากรvideo
รองรับค่าpg14
ซึ่งสอดคล้องกับคะแนนTV-14
แล้ว -
แก้ไขคำจำกัดความของพร็อพเพอร์ตี้
snippet.liveBroadcastContent
ซึ่งเป็นส่วนหนึ่งของผลการค้นหา เพื่อแสดงให้เห็นว่าlive
เป็นค่าพร็อพเพอร์ตี้ที่ถูกต้อง แต่active
ไม่ใช่ค่าพร็อพเพอร์ตี้ที่ถูกต้อง -
ตอนนี้พร็อพเพอร์ตี้
contentDetails.contentRating.mibacRating
ของทรัพยากรvideo
รองรับการให้คะแนนเพิ่มเติม 2 รายการแล้ว ดังนี้mibacVap
(VAP) – เด็กควรมีผู้ใหญ่คอยชี้แนะด้วยmibacVm6
(เวอร์ชัน 6) – จำกัดสำหรับผู้ที่มีอายุตั้งแต่ 6 ปีขึ้นไปmibacVm12
(V.M.12) – จำกัดสำหรับผู้ที่มีอายุ 12 ปีขึ้นไป
-
พร็อพเพอร์ตี้
invideoPromotion.items[].promotedByContentOwner
ใหม่ของทรัพยากรchannel
ระบุว่าชื่อของเจ้าของเนื้อหาจะปรากฏเมื่อแสดงโปรโมชันหรือไม่ ตั้งค่าช่องนี้ได้เฉพาะในกรณีที่มีการสร้างคำขอ API ที่ตั้งค่าแทนเจ้าของเนื้อหาเท่านั้น ดูข้อมูลเพิ่มเติมได้ในพารามิเตอร์onBehalfOfContentOwner
1 ตุลาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ออบเจ็กต์
auditDetails
ใหม่ของทรัพยากรchannel
มีข้อมูลช่องที่เครือข่ายแบบหลายช่อง (MCN) จะประเมินขณะตัดสินใจว่าจะยอมรับหรือปฏิเสธช่องใดช่องหนึ่ง โปรดทราบว่าคำขอ API ที่เรียกส่วนแหล่งข้อมูลนี้ต้องระบุโทเค็นการให้สิทธิ์ที่มีขอบเขตhttps://www.googleapis.com/auth/youtubepartner-channel-audit
นอกจากนี้ โทเค็นที่ใช้ขอบเขตนั้นจะต้องถูกเพิกถอนเมื่อ MCN ตัดสินใจที่จะยอมรับหรือปฏิเสธช่อง หรือภายใน 2 สัปดาห์นับจากวันที่ออกโทเค็น -
ตอนนี้พร็อพเพอร์ตี้
invideoPromotion.items[].id.type
ของทรัพยากรchannel
รองรับค่าrecentUpload
ซึ่งระบุว่ารายการที่โปรโมตเป็นวิดีโอที่อัปโหลดล่าสุดจากช่องที่ระบุโดยค่าเริ่มต้น ช่องจะเหมือนกับช่องที่มีการตั้งค่าข้อมูลโปรโมชันในวิดีโอ แต่คุณโปรโมตวิดีโอที่อัปโหลดล่าสุดจากช่องอื่นได้โดยตั้งค่าของพร็อพเพอร์ตี้
invideoPromotion.items[].id.recentlyUploadedBy
ใหม่เป็นรหัสช่องสำหรับช่องดังกล่าว -
ทรัพยากร
channel
มีพร็อพเพอร์ตี้ใหม่ 3 รายการ ได้แก่brandingSettings.image.bannerTvLowImageUrl
,brandingSettings.image.bannerTvMediumImageUrl
,brandingSettings.image.bannerTvHighImageUrl
ซึ่งระบุ URL ของรูปภาพแบนเนอร์ที่แสดงในหน้าช่องในแอปพลิเคชันโทรทัศน์ -
พร็อพเพอร์ตี้
snippet.liveBroadcastContent
ใหม่ในผลการค้นหาจะระบุว่าทรัพยากรของวิดีโอหรือช่องมีเนื้อหาการถ่ายทอดสดหรือไม่ ค่าพร็อพเพอร์ตี้ที่ถูกต้องคือupcoming
,active
และnone
- สำหรับแหล่งข้อมูล
video
ค่าupcoming
หมายความว่าวิดีโอเป็นการถ่ายทอดสดที่ยังไม่เริ่ม ขณะที่ค่าactive
แสดงว่าวิดีโอเป็นการถ่ายทอดสดที่กำลังดำเนินอยู่ - สำหรับแหล่งข้อมูล
channel
ค่าupcoming
หมายความว่าช่องมีการออกอากาศตามกำหนดการที่ยังไม่เริ่ม ในขณะที่ค่าacive
แสดงว่าช่องมีการถ่ายทอดสดที่ดำเนินอยู่
- สำหรับแหล่งข้อมูล
-
ในแหล่งข้อมูล
watermark
พร็อพเพอร์ตี้targetChannelId
ได้เปลี่ยนจากออบเจ็กต์เป็นสตริง ตอนนี้พร็อพเพอร์ตี้targetChannelId
จะระบุค่านั้นของตัวเอง แทนที่จะมีพร็อพเพอร์ตี้ย่อยที่ระบุรหัสช่อง YouTube ของช่องที่รูปภาพที่มีลายน้ำลิงก์อยู่ ด้วยเหตุนี้ ระบบจึงนำพร็อพเพอร์ตี้targetChannelId.value
ของทรัพยากรดังกล่าวออก -
ตอนนี้เมธอด
thumbnails.set
รองรับพารามิเตอร์onBehalfOfContentOwner
แล้ว ซึ่งวิธีอื่นๆ นั้นรองรับอยู่แล้ว -
ตอนนี้เมธอด
search.list
รองรับพารามิเตอร์eventType
แล้ว ซึ่งจำกัดการค้นหาให้แสดงเฉพาะกิจกรรมที่กำลังออกอากาศ กิจกรรมที่กำลังจะมีขึ้น หรือที่เสร็จสมบูรณ์แล้วเท่านั้น -
พร็อพเพอร์ตี้
contentDetails.contentRating.mibacRating
ใหม่ระบุการจัดประเภทวิดีโอที่ได้รับจาก Ministero dei Beni e delle Attivita Culturali e del Turismo ของอิตาลี -
ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest
invalidImage
เมธอด thumbnails.set
จะแสดงผลข้อผิดพลาดนี้หากเนื้อหารูปภาพที่ระบุไม่ถูกต้องforbidden
videoRatingDisabled
เมธอด videos.rate
จะแสดงข้อผิดพลาดนี้หากเจ้าของวิดีโอที่กำลังจัดประเภทปิดใช้การให้คะแนนของวิดีโอนั้นๆ
27 สิงหาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ทรัพยากร
watermark
ใหม่ระบุรูปภาพที่แสดงระหว่างการเล่นวิดีโอของช่องที่ระบุ นอกจากนี้ คุณสามารถระบุช่องเป้าหมายที่รูปภาพจะลิงก์ไป รวมถึงรายละเอียดเวลาที่กำหนดว่าลายน้ำจะปรากฏระหว่างการเล่นวิดีโอเมื่อใดและระยะเวลาที่มองเห็นเมธอด
watermarks.set
จะอัปโหลดและตั้งค่ารูปภาพลายน้ำของช่อง เมธอดwatermarks.unset
จะลบรูปภาพลายน้ำของช่องเอกสารประกอบเกี่ยวกับข้อผิดพลาดจะอธิบายข้อความแสดงข้อผิดพลาดที่ API รองรับเมธอด
watermarks.set
และwatermarks.unset
โดยเฉพาะ -
พร็อพเพอร์ตี้
statistics.hiddenSubscriberCount
ใหม่ของทรัพยากรchannel
มีค่าบูลีนที่ระบุว่าจำนวนผู้ติดตามของช่องซ่อนอยู่หรือไม่ ดังนั้น ค่าของพร็อพเพอร์ตี้คือfalse
หากจำนวนผู้ติดตามของช่องปรากฏต่อสาธารณะ -
ตอนนี้เมธอด
playlists.list
รองรับพารามิเตอร์onBehalfOfContentOwner
และonBehalfOfContentOwnerChannel
แล้ว มีการรองรับพารามิเตอร์ทั้งสองสำหรับวิธีการอื่นๆ อยู่แล้ว -
ตอนนี้เมธอด
videos.list
รองรับพารามิเตอร์regionCode
ซึ่งระบุภูมิภาคของเนื้อหาที่ควรเรียกแผนภูมิแล้ว พารามิเตอร์นี้สามารถใช้ร่วมกับพารามิเตอร์chart
เท่านั้น ค่าพารามิเตอร์คือรหัสประเทศ ISO 3166-1 alpha-2 -
error documentation
อธิบายถึงข้อผิดพลาดที่พบบ่อยใหม่ต่อไปนี้ ซึ่งอาจเกิดขึ้นได้กับเมธอด API หลายรายการประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย forbidden
insufficientPermissions
ขอบเขตที่เชื่อมโยงกับโทเค็น OAuth 2.0 ที่ให้ไว้สำหรับคำขอไม่เพียงพอสำหรับการเข้าถึงข้อมูลที่ขอ
15 สิงหาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ออบเจ็กต์
invideoPromotion
ของทรัพยากรchannel
มีพร็อพเพอร์ตี้ใหม่และที่อัปเดตต่อไปนี้-
ตอนนี้ API รองรับความสามารถในการระบุเว็บไซต์เป็นรายการที่โปรโมตแล้ว ซึ่งทำได้โดยตั้งค่าพร็อพเพอร์ตี้
invideoPromotion.items[].id.type
เป็นwebsite
และใช้พร็อพเพอร์ตี้invideoPromotion.items[].id.websiteUrl
ใหม่เพื่อระบุ URL นอกจากนี้ ให้ใช้พร็อพเพอร์ตี้invideoPromotion.items[].customMessage
ใหม่เพื่อกำหนดข้อความที่กำหนดเองที่จะแสดงสำหรับโปรโมชันลิงก์อาจเป็นเว็บไซต์ที่เกี่ยวข้อง เว็บไซต์ผู้ขาย หรือเว็บไซต์โซเชียลเน็ตเวิร์กก็ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปิดใช้ลิงก์สำหรับเนื้อหาของคุณได้จากวิธีการในศูนย์ช่วยเหลือของ YouTube สำหรับเว็บไซต์ที่เกี่ยวข้องและเว็บไซต์ผู้ขาย
การเพิ่มลิงก์โปรโมชันหมายความว่าคุณยอมรับว่าจะไม่มีการนำลิงก์เหล่านั้นไปใช้เปลี่ยนเส้นทางการเข้าชมไปยังเว็บไซต์ที่ไม่ได้รับอนุญาต และลิงก์เหล่านั้นจะเป็นไปตามนโยบาย AdWords, นโยบายโฆษณาของ YouTube, หลักเกณฑ์ของชุมชน YouTube และข้อกำหนดในการให้บริการของ YouTube
-
มีการปรับโครงสร้างคุณสมบัติที่เกี่ยวข้องกับการตั้งค่าเวลาสำหรับแสดงรายการที่โปรโมตในระหว่างการเล่นวิดีโอใหม่ ดังนี้
-
ย้ายออบเจ็กต์
invideoPromotion.timing
ไปที่invideoPromotion.items[].timing
แล้ว ออบเจ็กต์นี้ช่วยให้คุณปรับแต่งข้อมูลเวลาของแต่ละรายการที่โปรโมตในรายการinvideoPromotion.items[]
ได้แล้ว -
ออบเจ็กต์
invideoPromotion.defaultTiming
ใหม่จะระบุการตั้งค่าช่วงเวลาเริ่มต้นสำหรับโปรโมชัน การตั้งค่าดังกล่าวจะกำหนดว่ารายการที่โปรโมตจะแสดงเมื่อใดระหว่างการเล่นวิดีโอรายการใดรายการหนึ่งในช่องของคุณ คุณลบล้างเวลาเริ่มต้นสำหรับรายการที่โปรโมตที่กำหนดได้โดยใช้ออบเจ็กต์invideoPromotion.items[].timing
-
พร็อพเพอร์ตี้
invideoPromotion.items[].timing.durationMs
ใหม่ระบุระยะเวลาเป็นมิลลิวินาทีที่โปรโมชันควรแสดง นอกจากนี้ ออบเจ็กต์invideoPromotion.defaultTiming
ยังมีช่องdurationMs
ที่ระบุระยะเวลาเริ่มต้นที่รายการที่โปรโมตจะแสดง
-
-
ย้ายทั้งพร็อพเพอร์ตี้
invideoPromotion.items[].type
และinvideoPromotion.items[].videoId
ไปยังออบเจ็กต์invideoPromotion.items[].id
แล้ว
-
-
ตอนนี้เมธอด
subscriptions.list
รองรับพารามิเตอร์onBehalfOfContentOwner
และonBehalfOfContentOwnerChannel
แล้ว มีการรองรับพารามิเตอร์ทั้งสองสำหรับวิธีการอื่นๆ อยู่แล้ว -
ในการตอบกลับ API สำหรับคำขอ
thumbnails.set
ค่าพร็อพเพอร์ตี้kind
ได้เปลี่ยนจากyoutube#thumbnailListResponse
เป็นyoutube#thumbnailSetResponse
-
เพิ่มตัวอย่างโค้ดสำหรับวิธีการต่อไปนี้แล้ว
channels.update
(Java, Python)playlists.insert
(.NET, PHP)subscriptions.insert
(PHP, Python)thumbnails.set
(PHP, Python)videos.insert
(PHP)videos.list
(PHP)videos.rate
(Python)videos.update
(Java, PHP, Python)
โปรดทราบว่ามีการนําตัวอย่าง Python สําหรับเมธอด
playlistItems.insert
ออกด้วย เนื่องจากตอนนี้ฟังก์ชันที่แสดงได้รับการจัดการโดยเมธอดvideos.rate
-
error documentation
อธิบายข้อผิดพลาดด้านบริบทคำขอใหม่ต่อไปนี้ ซึ่งอาจเกิดขึ้นได้สำหรับเมธอด API ใดๆ ที่รองรับพารามิเตอร์คำขอmine
ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest
invalidMine
ไม่สามารถใช้พารามิเตอร์ mine
ในคำขอที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์เป็นพาร์ทเนอร์ YouTube คุณควรนำพารามิเตอร์mine
ออก ตรวจสอบสิทธิ์ในฐานะผู้ใช้ YouTube โดยนำพารามิเตอร์onBehalfOfContentOwner
ออก หรือดำเนินการเป็นหนึ่งในช่องของพาร์ทเนอร์โดยระบุพารามิเตอร์onBehalfOfContentOwnerChannel
หากมีสำหรับเมธอดที่เรียก
8 สิงหาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ส่วนการใช้โควต้าของคู่มือเริ่มต้นใช้งาน API ข้อมูลของ YouTube ได้รับการอัปเดตเพื่อแสดงการเปลี่ยนแปลงต้นทุนโควต้าสำหรับการอัปโหลดวิดีโอจากประมาณ 16,000 หน่วยเป็นประมาณ 1,600 หน่วย
30 กรกฎาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ในทรัพยากร
channelBanner
ค่าของพร็อพเพอร์ตี้kind
เปลี่ยนจากyoutube#channelBannerInsertResponse
เป็นyoutube#channelBannerResource
ทรัพยากรนี้จะแสดงผลตามคำขอchannelBanners.insert
-
พร็อพเพอร์ตี้
brandingSettings.channel.profileColor
ใหม่ของทรัพยากรchannel
ระบุสีที่โดดเด่นซึ่งส่งเสริมเนื้อหาของช่อง ค่าพร็อพเพอร์ตี้คือเครื่องหมายสี่เหลี่ยม (#
) ตามด้วยสตริงฐานสิบหก 6 อักขระ เช่น#2793e6
-
ขณะนี้ API รองรับความสามารถในการระบุว่าการติดตามมีไว้สำหรับกิจกรรมทั้งหมดของช่องหรือสำหรับการอัปโหลดใหม่เท่านั้น พร็อพเพอร์ตี้
contentDetails.activityType
ใหม่ของทรัพยากรsubscription
ระบุประเภทของกิจกรรมที่สมาชิกจะได้รับแจ้ง ค่าพร็อพเพอร์ตี้ที่ถูกต้องคือall
และuploads
-
เมธอด
videos.list
รองรับพารามิเตอร์ใหม่สำหรับการเรียกอันดับของวิดีโอที่ได้รับความนิยมมากที่สุดบน YouTube ดังนี้- พารามิเตอร์
chart
ระบุแผนภูมิที่คุณต้องการดึงข้อมูล ปัจจุบันค่าที่รองรับมีเพียงmostPopular
ค่า โปรดทราบว่าพารามิเตอร์chart
เป็นพารามิเตอร์ตัวกรอง ซึ่งหมายความว่าไม่สามารถใช้ในคำขอเดียวกันกับพารามิเตอร์ตัวกรองอื่นๆ (id
และmyRating
) - พารามิเตอร์
videoCategoryId
จะระบุหมวดหมู่วิดีโอที่ควรดึงข้อมูลแผนภูมิ พารามิเตอร์นี้สามารถใช้ร่วมกับพารามิเตอร์chart
เท่านั้น โดยค่าเริ่มต้น แผนภูมิจะไม่จำกัดเฉพาะหมวดหมู่ใดหมวดหมู่หนึ่ง
- พารามิเตอร์
-
พร็อพเพอร์ตี้
topicDetails.relevantTopicIds[]
ใหม่ของทรัพยากรvideo
จะแสดงรายการรหัสหัวข้อ Freebase ที่เกี่ยวข้องกับวิดีโอหรือเนื้อหา เรื่องของหัวข้อเหล่านี้อาจกล่าวถึงหรือปรากฏในวิดีโอ -
พร็อพเพอร์ตี้
recordingDetails.location.elevation
ของทรัพยากรvideo
ได้เปลี่ยนชื่อเป็นrecordingDetails.location.altitude
และพร็อพเพอร์ตี้fileDetails.recordingLocation.location.elevation
ได้เปลี่ยนชื่อเป็นfileDetails.recordingLocation.location.altitude
-
ออบเจ็กต์
contentDetails.contentRating
ของทรัพยากรvideo
ระบุการจัดประเภทที่วิดีโอได้รับภายใต้รูปแบบการจัดประเภทต่างๆ รวมถึงการจัดประเภทของ MPAA, การจัดประเภท TVPG และอื่นๆ สำหรับระบบการจัดประเภทแต่ละระบบ ตอนนี้ API รองรับค่าการจัดประเภทที่ระบุว่าวิดีโอยังไม่ได้รับการจัดประเภท โปรดทราบว่าสำหรับการจัดประเภท MPAA ค่า "ไม่มีการจัดประเภท" การจัดประเภทมักใช้เพื่อระบุภาพยนตร์เวอร์ชันไม่ตัดต่อซึ่งภาพยนตร์เวอร์ชันที่ตัดต่อมานั้นได้รับการจัดประเภทอย่างเป็นทางการ -
พร็อพเพอร์ตี้
contentDetails.contentRating.ytRating
ใหม่ของทรัพยากรvideo
ระบุเนื้อหาที่จำกัดอายุผู้ชม ค่าพร็อพเพอร์ตี้จะเป็นytAgeRestricted
หาก YouTube ระบุว่าวิดีโอมีเนื้อหาที่ไม่เหมาะสมสำหรับผู้ใช้ที่มีอายุต่ำกว่า 18 ปี หากไม่มีหรือค่าของพร็อพเพอร์ตี้ว่างเปล่า จะไม่มีการระบุว่าเนื้อหามีการจำกัดอายุผู้ชม -
พารามิเตอร์
mySubscribers
ของเมธอดchannels.list
เลิกใช้งานแล้ว ใช้เมธอดsubscriptions.list
และพารามิเตอร์mySubscribers
ของเมธอดเพื่อเรียกข้อมูลรายการสมาชิกของช่องของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์แล้ว -
ขณะนี้เมธอด
channelBanners.insert
,channels.update
,videos.getRating
และvideos.rate
รองรับพารามิเตอร์onBehalfOfContentOwner
แล้ว พารามิเตอร์ดังกล่าวระบุว่าผู้ใช้ที่ตรวจสอบสิทธิ์แล้วดำเนินการในนามของเจ้าของเนื้อหาที่ระบุไว้ในค่าพารามิเตอร์ -
เอกสารประกอบของเมธอด
channels.update
ได้รับการอัปเดตเพื่อแสดงข้อเท็จจริงที่ว่าเมธอดนั้นใช้เพื่ออัปเดตออบเจ็กต์brandingSettings
และพร็อพเพอร์ตี้ย่อยของทรัพยากรchannel
ได้ เอกสารประกอบยังแสดงรายการพร็อพเพอร์ตี้ที่อัปเดตแล้วซึ่งคุณตั้งค่าสำหรับออบเจ็กต์invideoPromotion
ของทรัพยากรchannel
ได้ด้วย -
error documentation
อธิบายข้อผิดพลาดใหม่ต่อไปนี้ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย forbidden
accountDelegationForbidden
ข้อผิดพลาดนี้ไม่ได้เฉพาะเจาะจงกับเมธอด API ใดโดยเฉพาะ ระบุว่าผู้ใช้ที่ตรวจสอบสิทธิ์แล้วไม่ได้รับอนุญาตให้ดำเนินการในนามของบัญชี Google ที่ระบุ forbidden
authenticatedUserAccountClosed
ข้อผิดพลาดนี้ไม่ได้เฉพาะเจาะจงกับเมธอด API ใดโดยเฉพาะ ซึ่งเป็นการระบุว่าบัญชี YouTube ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ถูกปิดแล้ว หากผู้ใช้ดำเนินการในนามของบัญชี Google อื่น ข้อผิดพลาดนี้จะระบุว่าบัญชีดังกล่าวถูกปิดแล้ว forbidden
authenticatedUserAccountSuspended
ข้อผิดพลาดนี้ไม่ได้เฉพาะเจาะจงกับเมธอด API ใดโดยเฉพาะ ข้อความระบุว่าบัญชี YouTube ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ถูกระงับ หากผู้ใช้ดำเนินการในนามของบัญชี Google อื่น ข้อผิดพลาดนี้จะระบุว่าบัญชีดังกล่าวถูกระงับ forbidden
authenticatedUserNotChannel
ข้อผิดพลาดนี้ไม่ได้เฉพาะเจาะจงกับเมธอด API ใดโดยเฉพาะ ซึ่งระบุว่าเซิร์ฟเวอร์ API ระบุช่องที่เชื่อมโยงกับคำขอ API ไม่ได้ หากคำขอได้รับอนุญาตและใช้พารามิเตอร์ onBehalfOfContentOwner
คุณควรตั้งค่าพารามิเตอร์onBehalfOfContentOwnerChannel
ด้วยforbidden
cmsUserAccountNotFound
ข้อผิดพลาดนี้ไม่ได้เฉพาะเจาะจงกับเมธอด API ใดโดยเฉพาะ ผู้ใช้ CMS ไม่ได้รับอนุญาตให้ดำเนินการในนามของเจ้าของเนื้อหาที่ระบุ notFound
contentOwnerAccountNotFound
ข้อผิดพลาดนี้ไม่ได้เฉพาะเจาะจงกับเมธอด API ใดโดยเฉพาะ ไม่พบบัญชีเจ้าของเนื้อหาที่ระบุ badRequest
invalidPart
ข้อผิดพลาดนี้ไม่ได้เฉพาะเจาะจงกับเมธอด API ใดโดยเฉพาะ พารามิเตอร์ part
ของคำขอระบุส่วนที่เขียนพร้อมกันไม่ได้badRequest
videoChartNotFound
เมธอด videos.list
จะแสดงข้อผิดพลาดนี้เมื่อคำขอระบุแผนภูมิวิดีโอที่ไม่รองรับหรือไม่พร้อมใช้งานnotFound
videoNotFound
เมธอด videos.update
จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าไม่พบวิดีโอที่คุณพยายามอัปเดต ตรวจสอบค่าของพร็อพเพอร์ตี้id
ในเนื้อหาคำขอเพื่อให้แน่ใจว่าถูกต้อง
10 มิถุนายน 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
พารามิเตอร์
forUsername
ใหม่ของเมธอดchannels.list
ช่วยให้คุณเรียกข้อมูลเกี่ยวกับช่องได้ด้วยการป้อนชื่อผู้ใช้ YouTube ของช่องนั้น -
ตอนนี้เมธอด
activities.list
รองรับพารามิเตอร์regionCode
แล้ว ซึ่งจะสั่งให้ API แสดงผลการค้นหาที่เกี่ยวข้องกับประเทศที่ระบุ YouTube จะใช้ค่านี้เมื่อกิจกรรมก่อนหน้าของผู้ใช้ที่ได้รับอนุญาตใน YouTube ไม่ได้ให้ข้อมูลที่เพียงพอในการสร้างฟีดกิจกรรม -
ทรัพยากรสำหรับเพลย์ลิสต์มีพร็อพเพอร์ตี้
snippet.tags
แล้ว ระบบจะส่งพร็อพเพอร์ตี้ให้กับผู้ใช้ที่ได้รับอนุญาตซึ่งกำลังเรียกข้อมูลเกี่ยวกับเพลย์ลิสต์ของตนเองเท่านั้น ผู้ใช้ที่ได้รับอนุญาตยังตั้งค่าแท็กเพลย์ลิสต์เมื่อเรียกใช้เมธอดplaylists.insert
หรือplaylists.update
ได้ด้วย -
ตอนนี้พารามิเตอร์
onBehalfOfContentOwner
ซึ่งก่อนหน้านี้รองรับเมธอดchannels.list
และsearch.list
ก็รองรับเมธอดvideos.insert
,videos.update
และvideos.delete
แล้วเช่นกัน โปรดทราบว่าเมื่อใช้พารามิเตอร์นี้ในการเรียกเมธอดvideos.insert
คำขอต้องระบุค่าสำหรับพารามิเตอร์onBehalfOfContentOwnerChannel
ใหม่ด้วย ซึ่งระบุช่องที่จะเพิ่มวิดีโอ ช่องต้องลิงก์กับเจ้าของเนื้อหาที่พารามิเตอร์onBehalfOfContentOwner
ระบุไว้พารามิเตอร์นี้จะระบุว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุผู้ใช้ YouTube CMS ที่ทำหน้าที่ในนามของเจ้าของเนื้อหาที่ระบุไว้ในค่าพารามิเตอร์ บัญชี CMS ที่ผู้ใช้ตรวจสอบสิทธิ์จะต้องลิงก์กับเจ้าของเนื้อหา YouTube ที่ระบุ
พารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาที่เป็นเจ้าของและจัดการช่อง YouTube ต่างๆ จำนวนมาก พารามิเตอร์นี้ช่วยให้พาร์ทเนอร์เหล่านั้นตรวจสอบสิทธิ์เพียงครั้งเดียวและเข้าถึงข้อมูลวิดีโอและช่องทั้งหมดได้ โดยไม่ต้องระบุข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์สำหรับแต่ละช่อง
สำหรับการเปิดตัวครั้งนี้ พารามิเตอร์นี้จะช่วยให้พาร์ทเนอร์ด้านเนื้อหาแทรก อัปเดต หรือลบวิดีโอในช่อง YouTube ใดก็ได้ที่พาร์ทเนอร์เป็นเจ้าของ
-
error documentation
อธิบายข้อผิดพลาดใหม่ต่อไปนี้ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย forbidden
insufficientCapabilities
ข้อผิดพลาดนี้ไม่ได้เฉพาะเจาะจงกับเมธอด API ใดโดยเฉพาะ ระบุว่าผู้ใช้ CMS ที่เรียกใช้ API มีสิทธิ์ไม่เพียงพอที่จะดำเนินการที่ขอ ข้อผิดพลาดนี้เชื่อมโยงกับการใช้พารามิเตอร์ onBehalfOfContentOwner
ซึ่งรองรับเมธอด API หลายวิธีunauthorized
authorizationRequired
เมธอด activities.list
จะแสดงข้อผิดพลาดนี้เมื่อคำขอใช้พารามิเตอร์home
แต่ไม่ได้รับอนุญาตอย่างถูกต้อง -
ในทรัพยากร
channels
พร็อพเพอร์ตี้invideoPromotion.channelId
ถูกนำออกไปแล้ว เนื่องจากมีการระบุรหัสแชแนลโดยใช้พร็อพเพอร์ตี้id
ของทรัพยากรดังกล่าวอยู่แล้ว -
คู่มือการทำงานกับรหัสช่องใหม่จะอธิบายวิธีที่ API ใช้รหัสช่อง คู่มือนี้อาจมีประโยชน์อย่างยิ่งสำหรับนักพัฒนาที่ย้ายข้อมูลมาจาก API เวอร์ชันก่อนหน้าและมีแอปพลิเคชันที่ขอเนื้อหาสำหรับผู้ใช้
default
หรืออาศัยความเชื่อที่ว่าช่อง YouTube แต่ละช่องมีชื่อผู้ใช้ที่ไม่ซ้ำกัน ซึ่งตอนนี้ไม่เป็นเช่นนั้นแล้ว
22 พฤษภาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เมธอด
channelBanners.insert
ใหม่ช่วยให้คุณสามารถอัปโหลดรูปภาพแบนเนอร์ที่ตั้งค่าให้เป็นรูปภาพแบนเนอร์สำหรับช่องได้ในภายหลังโดยใช้พร็อพเพอร์ตี้brandingSettings.image.bannerExternalUrl
ใหม่ของทรัพยากรchannel
-
เอกสารสำหรับเมธอด
channels.update
ได้รับการอัปเดตเพื่อแสดงพร็อพเพอร์ตี้ที่แก้ไขได้เมื่อเรียกใช้เมธอด -
เอกสารประกอบเกี่ยวกับแหล่งข้อมูล
video
ไม่ได้แสดงรายการunspecified
เป็นค่าพร็อพเพอร์ตี้ที่ถูกต้องสำหรับพร็อพเพอร์ตี้suggestions.processingErrors[]
,suggestions.processingHints[]
,suggestions.processingWarnings[]
และsuggestions.editorSuggestions[]
อีกต่อไป -
ตอนนี้พารามิเตอร์
maxResults
ของเมธอดvideos.list
มีค่าเริ่มต้นเป็น5
-
ตอนนี้
error documentation
จะแสดงข้อผิดพลาดสำหรับเมธอดchannelBanners.insert
และsubscriptions.list
และยังแสดงข้อผิดพลาดใหม่หลายรายการสำหรับเมธอดchannels.update
ด้วย
14 พฤษภาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตอนนี้หน้าสแตนด์อโลนจะแสดงตัวอย่างโค้ดสำหรับ Java, .NET, PHP และ Ruby
-
ตอนนี้หน้าที่แสดงตัวอย่างโค้ด Python จะมีตัวอย่างการเพิ่มการสมัครใช้บริการ การสร้างเพลย์ลิสต์ และการอัปเดตวิดีโอ
10 พฤษภาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
YouTube ไม่ได้ระบุฟีเจอร์และบริการ API แบบทดลองอีกต่อไป แต่ตอนนี้ เราจะแสดงรายการ YouTube API ที่อยู่ภายใต้นโยบายการเลิกใช้งานแทน
8 พฤษภาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ขณะนี้ทรัพยากรของช่องรองรับออบเจ็กต์
inVideoPromotion
ซึ่งระบุข้อมูลเกี่ยวกับแคมเปญโปรโมชันที่เชื่อมโยงกับช่องแล้ว ช่องสามารถใช้แคมเปญโปรโมตในวิดีโอเพื่อแสดงภาพขนาดย่อของวิดีโอโปรโมตภายในโปรแกรมเล่นวิดีโอระหว่างการเล่นวิดีโอของช่องคุณดึงข้อมูลนี้ได้โดยการใส่
invideoPromotion
ในค่าพารามิเตอร์part
ในคำขอchannels.list
-
คุณใช้เมธอด
channels.update
ใหม่เพื่ออัปเดตข้อมูลแคมเปญโปรโมตในวิดีโอของช่องได้ โปรดทราบว่าวิธีนี้รองรับเฉพาะการอัปเดตในส่วนinvideoPromotion
ของทรัพยากรchannel
และยังไม่รองรับการอัปเดตส่วนอื่นๆ ของทรัพยากรดังกล่าว
2 พฤษภาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ขณะนี้ทรัพยากรของช่องรองรับพร็อพเพอร์ตี้
status.isLinked
แล้ว ซึ่งจะระบุว่าข้อมูลช่องระบุผู้ใช้ซึ่งลิงก์กับชื่อผู้ใช้ YouTube หรือบัญชี Google+ แล้วหรือไม่ ผู้ใช้ที่มีลิงก์ใดลิงก์หนึ่งเหล่านี้มีข้อมูลประจำตัว YouTube สาธารณะอยู่แล้ว ซึ่งเป็นข้อกำหนดเบื้องต้นสำหรับการดำเนินการหลายอย่าง เช่น การอัปโหลดวิดีโอ -
ทรัพยากรการสมัครใช้บริการรองรับส่วน
subscriberSnippet
แล้ว ในออบเจ็กต์ดังกล่าวประกอบด้วยตัวอย่างข้อมูลสำหรับช่องของสมาชิก -
ปัจจุบัน API รองรับเมธอด
videos.getRating
ซึ่งจะดึงข้อมูลการจัดประเภทที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ให้กับรายการวิดีโออย่างน้อย 1 รายการ -
พารามิเตอร์
myRating
ใหม่ของเมธอดvideos.list
ช่วยให้คุณสามารถดึงรายการวิดีโอที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์จัดประเภทด้วยการให้คะแนนlike
หรือdislike
ตอนนี้ทั้งพารามิเตอร์
myRating
และพารามิเตอร์id
ถือเป็นพารามิเตอร์ตัวกรอง ซึ่งหมายความว่าคำขอ API ต้องระบุพารามิเตอร์ที่แน่ชัด 1 รายการ (ก่อนหน้านี้ พารามิเตอร์id
เป็นพารามิเตอร์ที่จำเป็นสำหรับเมธอดนี้)เมธอดนี้จะแสดงข้อผิดพลาด
forbidden
สำหรับคำขอที่พยายามเรียกข้อมูลการให้คะแนนวิดีโอ แต่ไม่ได้รับอนุญาตอย่างถูกต้องให้ทำเช่นนั้น -
เมื่อมีการแนะนำพารามิเตอร์
myRating
ระบบจะอัปเดตเมธอดvideos.list
ให้รองรับการใส่เลขหน้า อย่างไรก็ตาม โปรดทราบว่าพารามิเตอร์การแบ่งหน้ารองรับเฉพาะคำขอที่ใช้พารามิเตอร์myRating
เท่านั้น (ระบบไม่รองรับข้อมูลและพารามิเตอร์การแบ่งหน้าสำหรับคำขอที่ใช้พารามิเตอร์id
)-
พารามิเตอร์
maxResults
ระบุจำนวนวิดีโอที่ API สามารถแสดงในชุดผลลัพธ์ และพารามิเตอร์pageToken
ระบุหน้าที่เฉพาะเจาะจงในชุดผลลัพธ์ที่คุณต้องการเรียก -
ทรัพยากร
youtube#videoListResponse
ซึ่งแสดงผลตามคำขอvideos.list
มีออบเจ็กต์pageInfo
ซึ่งมีรายละเอียด เช่น จำนวนผลลัพธ์ทั้งหมด และจำนวนผลลัพธ์ที่รวมอยู่ในชุดผลลัพธ์ปัจจุบัน ทรัพยากรyoutube#videoListResponse
อาจมีพร็อพเพอร์ตี้nextPageToken
และprevPageToken
ด้วย โดยแต่ละพร็อพเพอร์ตี้จะมีโทเค็นที่ใช้เพื่อดึงหน้าเว็บที่เฉพาะเจาะจงในชุดผลลัพธ์ได้
-
-
เมธอด
videos.insert
รองรับพารามิเตอร์ใหม่ต่อไปนี้autoLevels
– ตั้งค่าพารามิเตอร์นี้เป็นtrue
เพื่อสั่งให้ YouTube ปรับแสงและสีของวิดีโอโดยอัตโนมัติstabilize
– ตั้งค่าพารามิเตอร์นี้เป็นtrue
เพื่อสั่งให้ YouTube ปรับวิดีโอโดยนำการสั่นซึ่งเกิดจากการเคลื่อนไหวของกล้องออก
-
เพิ่มพร็อพเพอร์ตี้
channelTitle
ในsnippet
สำหรับทรัพยากรต่อไปนี้แล้วplaylistItem
– พร็อพเพอร์ตี้ระบุชื่อช่องที่เพิ่มรายการเพลย์ลิสต์playlist
– พร็อพเพอร์ตี้ระบุชื่อของช่องที่สร้างเพลย์ลิสต์subscription
– พร็อพเพอร์ตี้ระบุชื่อของช่องที่ติดตาม
-
เพิ่มตัวอย่างโค้ดสำหรับวิธีการต่อไปนี้แล้ว
activities.insert
(ทับทิม)playlistItems.list
(.NET)search.list
(.NET)subscriptions.insert
(Java, Ruby)videos.insert
(.NET, ทับทิม)
-
พารามิเตอร์
mySubscribers
ใหม่ของเมธอดsubscriptions.list
ช่วยให้คุณเรียกข้อมูลรายการสมาชิกของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วในปัจจุบันได้ สามารถใช้พารามิเตอร์นี้ในคำขอที่ได้รับอนุญาตอย่างถูกต้องเท่านั้นหมายเหตุ: ฟังก์ชันนี้มีไว้เพื่อแทนที่พารามิเตอร์
mySubscribers
ที่รองรับเมธอดchannels.list
ในปัจจุบัน เราจะเลิกใช้งานพารามิเตอร์ดังกล่าว -
ในทรัพยากร
video
ค่าพร็อพเพอร์ตี้unspecified
จะไม่ใช่ค่าที่เป็นไปได้สำหรับพร็อพเพอร์ตี้ต่อไปนี้อีกต่อไป -
ขณะนี้คำขอ API ที่มีพารามิเตอร์ที่ไม่คาดคิดจะแสดงข้อผิดพลาด
badRequest
และเหตุผลที่รายงานสำหรับข้อผิดพลาดคือunexpectedParameter
-
ข้อผิดพลาดที่แสดงเมธอด
playlistItems.insert
เมื่อเพลย์ลิสต์มีรายการที่อนุญาตครบจำนวนสูงสุดแล้ว ระบบรายงานข้อผิดพลาดเป็นforbidden
และสาเหตุของข้อผิดพลาดคือplaylistContainsMaximumNumberOfVideos
19 เมษายน 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เมธอด
videos.rate
ใหม่ช่วยให้ผู้ใช้กำหนดการจัดประเภทlike
หรือdislike
ในวิดีโอหรือนำการให้คะแนนออกจากวิดีโอได้นอกจากนี้ ยังมีการอัปเดตเอกสารข้อผิดพลาดเพื่อแสดงรายการข้อผิดพลาดที่ API อาจส่งคืนเมื่อมีการเรียกใช้เมธอด
videos.rate
-
ขณะนี้ระบบระบุภาพขนาดย่อในเอกสารประกอบของ API เป็นทรัพยากรแยกต่างหาก และเมธอด
thumbnails.set
ใหม่จะช่วยให้คุณอัปโหลดภาพปกวิดีโอที่กำหนดเองไปยัง YouTube และตั้งค่าให้สำหรับวิดีโอได้นอกจากนี้ ยังมีการอัปเดตเอกสารข้อผิดพลาดเพื่อแสดงรายการข้อผิดพลาดที่ API อาจส่งคืนเมื่อมีการเรียกใช้เมธอด
thumbnails.set
โปรดทราบว่าการเปลี่ยนแปลงนี้จะไม่ส่งผลต่อทรัพยากรที่มีอยู่ซึ่งแสดงผลภาพขนาดย่อ ระบบจะแสดงภาพขนาดย่อในทรัพยากรเหล่านั้นในลักษณะเดียวกับก่อนหน้านี้ แม้ว่าเอกสารจะแสดงชื่อของภาพขนาดย่อขนาดต่างๆ ที่ API อาจแสดง
-
ส่วน
brandingSettings
ใหม่ของแหล่งข้อมูลchannel
จะระบุการตั้งค่า ข้อความ และรูปภาพสำหรับหน้าช่องและหน้าดูวิดีโอของช่อง -
ทรัพยากร
playlistItem
มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้-
ออบเจ็กต์
status
ใหม่สรุปข้อมูลสถานะเกี่ยวกับรายการเพลย์ลิสต์ และพร็อพเพอร์ตี้status.privacyStatus
จะระบุสถานะความเป็นส่วนตัวของรายการเพลย์ลิสต์
-
-
ทรัพยากร
video
มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้-
พร็อพเพอร์ตี้
status.publicStatsViewable
ระบุว่าสถิติวิดีโอที่ขยายในหน้าดูวิดีโอจะแสดงต่อสาธารณะหรือไม่ โดยค่าเริ่มต้น สถิติเหล่านั้นจะสามารถดูได้ และสถิติต่างๆ เช่น จำนวนการดูและการให้คะแนนของวิดีโอจะยังคงแสดงแบบสาธารณะ แม้ว่าค่าของพร็อพเพอร์ตี้นี้จะกำหนดเป็นfalse
ก็ตาม คุณสามารถตั้งค่าของพร็อพเพอร์ตี้นี้เมื่อเรียกใช้เมธอดvideos.insert
หรือvideos.update
-
ออบเจ็กต์
contentDetails.contentRating
สรุปการจัดประเภทที่วิดีโอได้รับภายใต้รูปแบบการจัดประเภทต่างๆ รายการด้านล่างระบุระบบการจัดประเภทที่รองรับและมีลิงก์ไปยังที่พักที่เชื่อมโยงกับระบบการจัดประเภทแต่ละระบบ คําจํากัดความของที่พักจะระบุค่าการจัดประเภทที่รองรับสําหรับแต่ละระบบประเทศ ระบบการจัดประเภท พร็อพเพอร์ตี้ สหรัฐอเมริกา สมาคมภาพยนตร์แห่งสหรัฐอเมริกา (MPAA) contentDetails.contentRating.mpaaRating
สหรัฐอเมริกา TV Parental Guidelines contentDetails.contentRating.tvpgRating
ออสเตรเลีย คณะกรรมการการจัดประเภทแห่งออสเตรเลีย (ACB) contentDetails.contentRating.acbRating
บราซิล Departamento de Justiça, Classificação, Qualificação e Títulos contentDetails.contentRating.djctqRating
แคนาดา ระบบการจัดเรตโฮมวิดีโอของแคนาดา (CHVRS) contentDetails.contentRating.chvrsRating
ฝรั่งเศส Centre National du cinéma et de l'image animée (กระทรวงวัฒนธรรมของฝรั่งเศส) contentDetails.contentRating.fmocRating
เยอรมนี Freiwillige Selbstkontrolle der Filmwirtschaft (FSK) contentDetails.contentRating.fskRating
สหราชอาณาจักร คณะกรรมการการจัดประเภทภาพยนตร์ของอังกฤษ (British Board of Film Classification หรือ BBFC) contentDetails.contentRating.bbfcRating
อินเดีย Central Board of Film Certification (CBFC) contentDetails.contentRating.cbfcRating
ญี่ปุ่น 映倫管の委員会 (EIRIN) contentDetails.contentRating.eirinRating
เกาหลี 영상물이springตอบรีวิวบาร์ และอาจเรียกว่า KMRB) contentDetails.contentRating.kmrbRating
เม็กซิโก คณะกรรมการทั่วไปด้านวิทยุ โทรทัศน์ และการถ่ายทำภาพยนตร์ (RTC) contentDetails.contentRating.rtcRating
นิวซีแลนด์ ฝ่ายการจัดประเภทภาพยนตร์และวรรณกรรม contentDetails.contentRating.oflcRating
รัสเซีย สำนักทะเบียนภาพยนตร์แห่งชาติสหพันธรัฐรัสเซีย contentDetails.contentRating.russiaRating
สเปน Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA) contentDetails.contentRating.icaaRating
-
-
เอกสารประกอบของเมธอด
playlistItems.update
ได้รับการอัปเดตเพื่อแสดงข้อเท็จจริงที่ว่าต้องระบุพร็อพเพอร์ตี้snippet.resourceId
ในทรัพยากรที่ส่งเป็นเนื้อความของคำขอ -
ตอนนี้เมธอด
search.list
รองรับฟังก์ชันต่อไปนี้แล้ว-
พารามิเตอร์
forMine
ใหม่จะจำกัดการค้นหาให้ดึงเฉพาะวิดีโอของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์แล้วเท่านั้น -
ตอนนี้พารามิเตอร์
order
รองรับความสามารถในการจัดเรียงผลลัพธ์ตามตัวอักษรตามชื่อ (order=title
) หรือตามจำนวนวิดีโอตามลำดับจากมากไปน้อย (order=videoCount
) แล้ว -
พารามิเตอร์
safeSearch
ใหม่ระบุว่าผลการค้นหาควรมีเนื้อหาที่ถูกจำกัดหรือไม่
-
-
เมธอด
videos.insert
รองรับข้อผิดพลาดใหม่ๆ หลายรายการตามที่แสดงในตารางด้านล่างประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย badRequest
invalidCategoryId
พร็อพเพอร์ตี้ snippet.categoryId
ระบุรหัสหมวดหมู่ที่ไม่ถูกต้อง ใช้เมธอดvideoCategories.list
เพื่อเรียกข้อมูลหมวดหมู่ที่รองรับbadRequest
invalidRecordingDetails
metadata specifies invalid recording details.
badRequest
invalidVideoGameRating
ข้อมูลเมตาของคำขอระบุการจัดประเภทวิดีโอเกมที่ไม่ถูกต้อง badRequest
invalidVideoMetadata
ข้อมูลเมตาของคำขอไม่ถูกต้อง -
นำพารามิเตอร์
onBehalfOfContentOwner
ออกจากรายการพารามิเตอร์ที่รองรับสำหรับเมธอดvideos.update
และvideos.delete
แล้ว
12 มีนาคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เพิ่มพร็อพเพอร์ตี้
channelTitle
ในsnippet
สำหรับทรัพยากรต่อไปนี้แล้ว -
เมธอด
search.list
รองรับพารามิเตอร์ใหม่ต่อไปนี้-
พารามิเตอร์
channelType
ช่วยให้คุณจำกัดการค้นหาแชแนลเพื่อดึงข้อมูลแชแนลทั้งหมดหรือเพื่อดึงเฉพาะรายการเท่านั้นได้ -
พารามิเตอร์
videoType
ช่วยให้คุณจำกัดการค้นหาวิดีโอเพื่อเรียกวิดีโอทั้งหมด หรือดึงเฉพาะภาพยนตร์หรือเฉพาะตอนของรายการทีวีได้
-
-
อัปเดตคําจํากัดความของส่วน
recordingDetails
ของทรัพยากรvideo
แล้ว โปรดทราบว่าระบบจะส่งคืนออบเจ็กต์ในวิดีโอเท่านั้นหากมีการตั้งค่าข้อมูลตำแหน่งทางภูมิศาสตร์หรือเวลาในการบันทึกของวิดีโอไว้ -
ตอนนี้เมธอด
playlistItems.update
จะแสดงข้อผิดพลาดinvalidSnippet
ซึ่งระบบจะส่งคืนหากคำขอ API ไม่ได้ระบุข้อมูลโค้ดที่ถูกต้อง -
มีเมธอด API หลายวิธีที่รองรับพารามิเตอร์ใหม่ที่มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ YouTube โดยเฉพาะ พาร์ทเนอร์เนื้อหาของ YouTube ได้แก่ สตูดิโอภาพยนตร์และโทรทัศน์ ค่ายเพลง และคอนเทนต์ครีเอเตอร์รายอื่นๆ ที่เผยแพร่เนื้อหาของตนบน YouTube
-
พารามิเตอร์
onBehalfOfContentOwner
ระบุว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุผู้ใช้ YouTube CMS ที่ทำหน้าที่ในนามของเจ้าของเนื้อหาที่ระบุไว้ในค่าพารามิเตอร์ บัญชี CMS ที่ผู้ใช้ตรวจสอบสิทธิ์จะต้องลิงก์กับเจ้าของเนื้อหา YouTube ที่ระบุพารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาที่เป็นเจ้าของและจัดการช่อง YouTube ต่างๆ จำนวนมาก พารามิเตอร์นี้ช่วยให้พาร์ทเนอร์เหล่านั้นตรวจสอบสิทธิ์เพียงครั้งเดียวและเข้าถึงข้อมูลวิดีโอและช่องทั้งหมดได้ โดยไม่ต้องระบุข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์สำหรับแต่ละช่อง
วิธี
channels.list
,search.list
,videos.delete
,videos.list
และvideos.update
รองรับพารามิเตอร์นี้ -
พารามิเตอร์
managedByMe
ซึ่งเมธอดchannels.list
รองรับ จะสั่งให้ API แสดงผลช่องทั้งหมดที่เจ้าของเนื้อหาเป็นเจ้าของที่พารามิเตอร์onBehalfOfContentOwner
ระบุ -
พารามิเตอร์
forContentOwner
ซึ่งเมธอดsearch.list
รองรับจะสั่งให้ API จำกัดผลการค้นหาให้รวมเฉพาะทรัพยากรที่เป็นของเจ้าของเนื้อหาซึ่งพารามิเตอร์onBehalfOfContentOwner
ระบุเท่านั้น
-
25 กุมภาพันธ์ 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
API รองรับชิ้นส่วนและพร็อพเพอร์ตี้ใหม่ๆ มากมายสำหรับทรัพยากร
video
ดังนี้-
ส่วน
fileDetails
,processingDetails
และsuggestions
ใหม่จะให้ข้อมูลแก่เจ้าของวิดีโอเกี่ยวกับวิดีโอที่อัปโหลด ข้อมูลนี้เป็นประโยชน์มากในแอปพลิเคชันที่เปิดใช้การอัปโหลดวิดีโอและประกอบด้วยสิ่งต่อไปนี้- สถานะและความคืบหน้าในการประมวลผล
- ข้อผิดพลาดหรือปัญหาอื่นๆ ที่พบขณะประมวลผลวิดีโอ
- ความพร้อมใช้งานของภาพขนาดย่อ
- คําแนะนําในการปรับปรุงคุณภาพวิดีโอหรือข้อมูลเมตา
- รายละเอียดเกี่ยวกับไฟล์ต้นฉบับที่อัปโหลดไปยัง YouTube
ทุกส่วนเหล่านี้มีเพียงเจ้าของวิดีโอเท่านั้นที่ดึงข้อมูลได้ รายการด้านล่างอธิบายส่วนใหม่คร่าวๆ และเอกสารทรัพยากร
video
จะอธิบายพร็อพเพอร์ตี้ทั้งหมดของแต่ละส่วน-
ออบเจ็กต์
fileDetails
มีข้อมูลเกี่ยวกับไฟล์วิดีโอที่อัปโหลดไปยัง YouTube รวมถึงความละเอียดของไฟล์ ระยะเวลา ตัวแปลงสัญญาณเสียงและวิดีโอ อัตราบิตของสตรีม และอื่นๆ -
ออบเจ็กต์
processingProgress
มีข้อมูลเกี่ยวกับความคืบหน้าในการประมวลผลไฟล์วิดีโอที่อัปโหลดของ YouTube พร็อพเพอร์ตี้ของออบเจ็กต์จะระบุสถานะการประมวลผลปัจจุบันและประเมินเวลาที่เหลือจนกว่า YouTube จะประมวลผลวิดีโอเสร็จสิ้น ส่วนนี้ยังระบุว่าวิดีโอมีเนื้อหาหรือเนื้อหาประเภทต่างๆ เช่น รายละเอียดไฟล์หรือภาพขนาดย่อ หรือไม่ออบเจ็กต์นี้ออกแบบมาให้มีการสำรวจเพื่อให้ผู้อัปโหลดวิดีโอสามารถติดตามความคืบหน้าที่ YouTube ดำเนินการในการประมวลผลไฟล์วิดีโอที่อัปโหลด
-
ออบเจ็กต์
suggestions
มีคำแนะนำที่ระบุโอกาสในการปรับปรุงคุณภาพหรือข้อมูลเมตาของวิดีโอที่อัปโหลด
-
ส่วน
contentDetails
มีพร็อพเพอร์ตี้ใหม่ 4 รายการ พร็อพเพอร์ตี้เหล่านี้สามารถดึงข้อมูลได้ด้วยคำขอที่ไม่ผ่านการตรวจสอบสิทธิ์dimension
– ระบุว่าวิดีโอพร้อมให้รับชมแบบ 2 มิติหรือ 3 มิติdefinition
– ระบุว่าวิดีโอพร้อมให้รับชมในรูปแบบมาตรฐานหรือความละเอียดสูงcaption
– ระบุว่ามีคำบรรยายในวิดีโอหรือไม่licensedContent
– ระบุว่าวิดีโอมีเนื้อหาที่ถูกอ้างสิทธิ์โดยพาร์ทเนอร์เนื้อหาของ YouTube หรือไม่
-
ส่วน
status
มีพร็อพเพอร์ตี้ใหม่ 2 รายการ เจ้าของวิดีโอสามารถกำหนดค่าสำหรับพร็อพเพอร์ตี้ทั้ง 2 รายการได้เมื่อแทรกหรืออัปเดตวิดีโอ พร็อพเพอร์ตี้เหล่านี้ยังสามารถดึงข้อมูลด้วยคำขอที่ไม่ผ่านการตรวจสอบสิทธิ์embeddable
– ระบุว่าสามารถฝังวิดีโอในเว็บไซต์อื่นได้หรือไม่license
– ระบุใบอนุญาตของวิดีโอ ค่าที่ถูกต้องคือcreativeCommon
และyoutube
-
-
อัปเดตคำจำกัดความของพารามิเตอร์
part
สำหรับเมธอดvideos.list
,videos.insert
และvideos.update
เพื่อแสดงรายการส่วนที่เพิ่มใหม่ตามที่อธิบายไว้ข้างต้น รวมถึงส่วนrecordingDetails
แล้ว ซึ่งระบบละเว้นไว้โดยไม่ตั้งใจ -
พร็อพเพอร์ตี้
contentDetails.googlePlusUserId
ใหม่ของทรัพยากรchannel
ระบุรหัสโปรไฟล์ Google+ ที่เชื่อมโยงกับช่อง คุณสามารถใช้ค่านี้เพื่อสร้างลิงก์ไปยังโปรไฟล์ Google+ -
ออบเจ็กต์ภาพขนาดย่อแต่ละรายการจะระบุความกว้างและความสูงของรูปภาพ ขณะนี้ระบบแสดงผลภาพขนาดย่อในทรัพยากร
activity
,channel
,playlist
,playlistItem
,search result
,subscription
และvideo
-
ตอนนี้
playlistItems.list
รองรับพารามิเตอร์videoId
แล้ว ซึ่งสามารถใช้ร่วมกับพารามิเตอร์playlistId
เพื่อดึงเฉพาะรายการเพลย์ลิสต์ที่แสดงวิดีโอที่ระบุAPI จะแสดงข้อผิดพลาด
notFound
หากไม่พบวิดีโอที่พารามิเตอร์ระบุในเพลย์ลิสต์ -
เอกสารข้อผิดพลาดจะอธิบายข้อผิดพลาด
forbidden
ใหม่ ซึ่งระบุว่าคำขอไม่ได้รับอนุญาตอย่างถูกต้องสำหรับการดำเนินการที่ร้องขอ -
นำพร็อพเพอร์ตี้
snippet.channelId
ของทรัพยากรchannel
ออกแล้ว พร็อพเพอร์ตี้id
ของทรัพยากรระบุค่าเดียวกัน
30 มกราคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
หน้าข้อผิดพลาดใหม่จะแสดงข้อผิดพลาดที่ API สามารถแสดงได้ หน้าเว็บมีข้อผิดพลาดทั่วไป ซึ่งอาจเกิดขึ้นได้กับเมธอด API ต่างๆ หลายวิธี รวมถึงข้อผิดพลาดเฉพาะเมธอดด้วย
16 มกราคม 2013
การอัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ตอนนี้ตัวอย่างโค้ดพร้อมให้บริการสำหรับวิธีการและภาษาที่แสดงในรายการด้านล่างแล้ว
activities.insert
– JavaplaylistItems.insert
– PythonplaylistItems.list
– Java, JavaScript, PHP, Python, Rubyplaylists.insert
– Java, JavaScript, Pythonsearch.list
– Java, JavaScript, Python, Rubyvideos.insert
– Java
-
ตอนนี้แหล่งข้อมูล
activity
สามารถรายงานการดำเนินการ "channelItem
" ซึ่งจะเกิดขึ้นเมื่อ YouTube เพิ่มวิดีโอลงในช่อง YouTube ที่สร้างขึ้นโดยอัตโนมัติแล้ว (YouTube จะใช้อัลกอริทึมในการระบุหัวข้อที่มีตัวตนบนเว็บไซต์ YouTube เป็นอย่างมาก และสร้างช่องสำหรับหัวข้อเหล่านั้นโดยอัตโนมัติ) -
อัปเดตพารามิเตอร์
search.list
ต่อไปนี้แล้ว- พารามิเตอร์
q
ไม่ได้รับการกำหนดเป็นตัวกรองอีกต่อไป ซึ่งหมายความว่า... - พารามิเตอร์
relatedToVideo
เปลี่ยนชื่อเป็นrelatedToVideoId
แล้ว - พารามิเตอร์
published
ถูกแทนที่ด้วยพารามิเตอร์ใหม่ 2 รายการ คือpublishedAfter
และpublishedBefore
ตามที่อธิบายไว้ด้านล่าง
- พารามิเตอร์
-
เมธอด
search.list
รองรับพารามิเตอร์ใหม่ต่อไปนี้ชื่อพารามิเตอร์ ค่า คำอธิบาย channelId
string
แสดงผลทรัพยากรที่สร้างโดยแชแนลที่ระบุ publishedAfter
datetime
แสดงผลทรัพยากรที่สร้างหลังจากเวลาที่ระบุ publishedBefore
datetime
แสดงผลทรัพยากรที่สร้างก่อนเวลาที่ระบุ regionCode
string
แสดงผลทรัพยากรสำหรับประเทศที่ระบุ videoCategoryId
string
กรองผลการค้นหาวิดีโอเพื่อรวมเฉพาะวิดีโอที่เชื่อมโยงกับหมวดหมู่วิดีโอที่ระบุ videoEmbeddable
string
กรองผลการค้นหาวิดีโอให้รวมเฉพาะวิดีโอที่สามารถเล่นในโปรแกรมเล่นแบบฝังบนหน้าเว็บได้ ตั้งค่าพารามิเตอร์เป็น true
เพื่อเรียกดูเฉพาะวิดีโอที่ฝังได้videoSyndicated
string
กรองผลการค้นหาวิดีโอให้รวมเฉพาะวิดีโอที่สามารถเล่นนอก YouTube.com เท่านั้น ตั้งค่าพารามิเตอร์เป็น true
เพื่อเรียกเฉพาะวิดีโอที่เผยแพร่เท่านั้น -
ทรัพยากร API หลายรายการรองรับพร็อพเพอร์ตี้ใหม่ ตารางด้านล่างจะระบุทรัพยากรและพร็อพเพอร์ตี้ใหม่
ทรัพยากร ชื่อพร็อพเพอร์ตี้ ค่า คำอธิบาย activity
contentDetails.playlistItem.playlistItemId
string
รหัสรายการเพลย์ลิสต์ที่ YouTube กำหนดให้ระบุรายการในเพลย์ลิสต์โดยไม่ซ้ำกัน activity
contentDetails.channelItem
object
ออบเจ็กต์ที่มีข้อมูลเกี่ยวกับทรัพยากรที่เพิ่มลงในแชแนล พร็อพเพอร์ตี้นี้จะปรากฏเมื่อ snippet.type
คือchannelItem
เท่านั้นactivity
contentDetails.channelItem.resourceId
object
ออบเจ็กต์ที่ระบุทรัพยากรที่เพิ่มลงในแชแนล เช่นเดียวกับพร็อพเพอร์ตี้ resourceId
อื่นๆ จะมีพร็อพเพอร์ตี้kind
ที่ระบุประเภททรัพยากร เช่น วิดีโอหรือเพลย์ลิสต์ และยังมีพร็อพเพอร์ตี้หลายรายการ เช่นvideoId
,playlistId
ฯลฯ ที่ระบุรหัสที่ระบุทรัพยากรนั้นแบบไม่ซ้ำchannel
status
object
ออบเจ็กต์นี้สรุปข้อมูลเกี่ยวกับสถานะความเป็นส่วนตัวของช่อง channel
status.privacyStatus
string
สถานะความเป็นส่วนตัวของช่อง ค่าที่ถูกต้องคือ private
และpublic
playlist
contentDetails
object
ออบเจ็กต์นี้มีข้อมูลเมตาเกี่ยวกับเนื้อหาของเพลย์ลิสต์ playlist
contentDetails.itemCount
unsigned integer
จำนวนวิดีโอในเพลย์ลิสต์ playlist
player
object
ออบเจ็กต์นี้มีข้อมูลที่คุณจะใช้เพื่อเล่นเพลย์ลิสต์ในโปรแกรมเล่นแบบฝัง playlist
player.embedHtml
string
แท็ก <iframe>
ที่ฝังโปรแกรมเล่นวิดีโอที่เล่นเพลย์ลิสต์นั้นvideo
recordingDetails
object
ออบเจ็กต์นี้สรุปข้อมูลที่ระบุหรืออธิบายสถานที่และเวลาที่มีการบันทึกวิดีโอ video
recordingDetails.location
object
วัตถุนี้มีข้อมูลตำแหน่งทางภูมิศาสตร์ที่เชื่อมโยงกับวิดีโอ video
recordingDetails.location.latitude
double
ละติจูด หน่วยเป็นองศา video
recordingDetails.location.longitude
double
ลองจิจูด เป็นองศา video
recordingDetails.location.elevation
double
ระดับความสูงเหนือพื้นโลก หน่วยเป็นเมตร video
recordingDetails.locationDescription
string
ข้อความอธิบายสถานที่ที่มีการบันทึกวิดีโอ video
recordingDetails.recordingDate
datetime
วันที่และเวลาที่มีการบันทึกวิดีโอ ค่าที่ระบุอยู่ในรูปแบบ ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ
) -
เอกสารสำหรับเมธอด API หลายวิธีจะระบุพร็อพเพอร์ตี้ที่ต้องระบุในเนื้อหาคำขอหรือที่อัปเดตตามค่าในเนื้อหาคำขอ ตารางด้านล่างแสดงวิธีการเหล่านั้น ตลอดจนพร็อพเพอร์ตี้ที่จำเป็นหรือแก้ไขได้
หมายเหตุ: เอกสารประกอบสำหรับวิธีการอื่นๆ อาจแสดงพร็อพเพอร์ตี้ที่จำเป็นและแก้ไขได้อยู่แล้ว
วิธีการ พร็อพเพอร์ตี้ activities.insert
พร็อพเพอร์ตี้ที่จำเป็น snippet.description
snippet.description
contentDetails.bulletin.resourceId
playlists.update
พร็อพเพอร์ตี้ที่จำเป็น id
playlistItems.update
พร็อพเพอร์ตี้ที่จำเป็น id
videos.update
พร็อพเพอร์ตี้ที่จำเป็น id
-
API จะไม่รายงานข้อผิดพลาด
playlistAlreadyExists
อีกต่อไปหากคุณพยายามสร้างหรืออัปเดตเพลย์ลิสต์ที่อาจมีชื่อเดียวกันกับเพลย์ลิสต์ที่มีอยู่แล้วในช่องเดียวกัน -
มีเมธอด API หลายวิธีที่รองรับข้อผิดพลาดประเภทใหม่ ตารางด้านล่างระบุวิธีการและข้อผิดพลาดใหม่ๆ ที่รองรับ
วิธีการ ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย guideCategories.list
notFound
notFound
ไม่พบหมวดหมู่ไกด์ที่ระบุโดยพารามิเตอร์ id
ใช้เมธอด guideCategories.list เพื่อเรียกดูรายการค่าที่ถูกต้องplaylistItems.delete
forbidden
playlistItemsNotAccessible
คำขอไม่ได้รับอนุญาตอย่างถูกต้องให้ลบรายการเพลย์ลิสต์ที่ระบุ videoCategories.list
notFound
videoCategoryNotFound
ไม่พบหมวดหมู่วิดีโอที่ระบุโดยพารามิเตอร์ id
ใช้เมธอด videoCategories.list เพื่อเรียกดูรายการค่าที่ถูกต้อง