หน้านี้จะแสดงการเปลี่ยนแปลงของ YouTube Data API (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
มีการอัปเดตคำจำกัดความของ liveStreamingDetails.concurrentViewers
ของทรัพยากร video
โปรดทราบว่าจำนวนผู้ชมที่ดูพร้อมกันที่ API ข้อมูลของ YouTube ส่งคืนอาจแตกต่างจากจำนวนผู้ชมที่ดูพร้อมกันที่ผ่านการประมวลผลและกำจัดสแปมที่มีอยู่ผ่าน YouTube Analytics ดูข้อมูลเพิ่มเติมเกี่ยวกับเมตริกสตรีมมิงแบบสดได้ที่ศูนย์ช่วยเหลือของ YouTube
7 สิงหาคม 2023
ตามที่ได้ประกาศเมื่อวันที่ 12 มิถุนายน 2023 เราได้เลิกใช้งานพารามิเตอร์ relatedToVideoId
ของเมธอด search.list
แล้ว ระบบไม่รองรับพารามิเตอร์ดังกล่าวอีกต่อไป และระบบได้นำการอ้างอิงไปยังพารามิเตอร์ออกจากเอกสารประกอบของ API แล้ว
28 มิถุนายน 2023
ตอนนี้เมธอด thumbnails.set รองรับข้อผิดพลาด uploadRateLimitExceeded
ซึ่งบ่งบอกว่าช่องอัปโหลดภาพขนาดย่อมากเกินไปในช่วง 24 ชั่วโมงที่ผ่านมา และควรลองอีกครั้งในภายหลัง
12 มิถุนายน 2023
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
พารามิเตอร์ relatedToVideoId
ของเมธอด search.list เลิกใช้งานแล้ว 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
จะรองรับทั้งรหัสแทร็กคำบรรยายวิดีโอเดิมและใหม่ อย่างไรก็ตาม YouTube จะหยุดรองรับรหัสแทร็กคำบรรยายวิดีโอเดิมในวันที่ 1 ธันวาคม 2022 หรือหลังจากนั้น เมื่อถึงเวลานั้น การเรียกใช้เมธอด API ที่มีรหัสแทร็กคำบรรยายวิดีโอเก่าจะทำให้เกิดข้อผิดพลาด captionNotFound
คุณควรวางแผนแทนที่ข้อมูลแทร็กคำบรรยายวิดีโอที่จัดเก็บไว้ทั้งหมดตั้งแต่วันนี้จนถึงวันที่ 1 ธันวาคม 2022 เพื่อเตรียมพร้อมสำหรับการเปลี่ยนแปลงนี้ ซึ่งหมายความว่าสำหรับวิดีโอใดก็ตามที่คุณจัดเก็บข้อมูลแทร็กคำบรรยายวิดีโอไว้ คุณควรลบข้อมูลที่จัดเก็บไว้ในปัจจุบัน แล้วเรียกใช้เมธอด captions.list
เพื่อเรียกข้อมูลชุดแทร็กคำบรรยายวิดีโอปัจจุบันของวิดีโอและจัดเก็บข้อมูลในการตอบสนองของ API ตามปกติ
12 กรกฎาคม 2022
มีการอัปเดตข้อกำหนดในการให้บริการของบริการ API ของ YouTube โปรดดูข้อมูลเพิ่มเติมในข้อกำหนดในการให้บริการของบริการ API ของ YouTube - ประวัติการแก้ไข
27 เมษายน 2022
อัปเดตคำอธิบายเมธอด videos.insert
แล้ว โปรดทราบว่าขนาดไฟล์สูงสุดสำหรับวิดีโอที่อัปโหลดเพิ่มขึ้นจาก 128GB เป็น 256GB
8 เมษายน 2022
มีการอัปเดตทั้งคำจำกัดความพารามิเตอร์ myRecentSubscribers
และ mySubscribers
ของเมธอด subscriptions.list
เพื่อระบุว่า API จะแสดงจำนวนผู้ติดตามสูงสุดที่ API แสดงผลได้
การเปลี่ยนแปลงนี้เป็นการแก้ไขเอกสาร ไม่ใช่การเปลี่ยนแปลงลักษณะการทำงานของ API
15 ธันวาคม 2021
ตามที่ได้ประกาศไปเมื่อวันที่ 18 พฤศจิกายน 2021 รวมถึงการเปลี่ยนแปลงในการทำให้จำนวนการกดไม่ชอบวิดีโอเป็นแบบส่วนตัวทั่วทั้งแพลตฟอร์ม YouTube ตอนนี้พร็อพเพอร์ตี้ statistics.dislikeCount
ของทรัพยากร video
ได้เป็นแบบส่วนตัวแล้ว
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงนี้ได้ในบล็อกอย่างเป็นทางการของ YouTube
18 พฤศจิกายน 2021
และนอกเหนือจากการเปลี่ยนแปลงในการทำให้จำนวนการกดไม่ชอบวิดีโอเป็นแบบส่วนตัวทั่วทั้งแพลตฟอร์ม YouTube พร็อพเพอร์ตี้ statistics.dislikeCount
ของทรัพยากร video
จะกลายเป็นแบบส่วนตัวตั้งแต่วันที่ 13 ธันวาคม 2021 ซึ่งหมายความว่าพร็อพเพอร์ตี้จะรวมอยู่ในการตอบกลับจาก API จากปลายทาง videos.list
เท่านั้น หากเจ้าของวิดีโอตรวจสอบสิทธิ์คำขอ API แล้ว
ปลายทาง videos.rate
จะไม่ได้รับผลกระทบจากการเปลี่ยนแปลงนี้
นักพัฒนาแอปที่ไม่แสดงจำนวนการกดไม่ชอบแบบสาธารณะและยังต้องการจำนวนการกดไม่ชอบสำหรับไคลเอ็นต์ API ของตน สามารถสมัครเพื่อให้อยู่ในรายชื่ออนุญาตสำหรับการยกเว้นได้ คุณต้องกรอกแบบฟอร์มการสมัครนี้หากต้องการสมัครขอรับการยกเว้น
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงนี้ได้ในบล็อกอย่างเป็นทางการของ YouTube
2 กรกฎาคม 2021
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
ปลายทาง commentThreads.update
เลิกใช้งานแล้วและไม่มีการรองรับอีกต่อไป
ปลายทางนี้มีฟังก์ชันการทำงานที่ซ้ำกันซึ่งพร้อมใช้งานผ่านปลายทาง API อื่นๆ แต่คุณโทรหา comments.update
แทนได้
commentThreads
ให้เรียกเมธอด commentThreads.list
เป็นครั้งที่ 2
1 กรกฎาคม 2021
นักพัฒนาซอฟต์แวร์ทั้งหมดที่ใช้บริการ API ของ YouTube ต้องผ่านการตรวจสอบการปฏิบัติตามข้อกำหนด API เพื่อให้ได้รับมากกว่าการจัดสรรโควต้าเริ่มต้น 10,000 หน่วย จนถึงตอนนี้ นักพัฒนาแอปได้กรอกข้อมูลและส่งบริการ YouTube API - แบบฟอร์มการตรวจสอบและขยายโควต้า ทั้งกระบวนการตรวจสอบการปฏิบัติตามข้อกำหนดและคำขอการจัดสรรหน่วยโควต้าเพิ่มเติม
เราได้เพิ่มแบบฟอร์มใหม่ 3 แบบฟอร์มและคำแนะนำในการกรอกแบบฟอร์มเหล่านั้น เพื่อชี้แจงกระบวนการเหล่านี้และตอบสนองความต้องการของนักพัฒนาซอฟต์แวร์ที่ใช้บริการ API ของเราให้ดียิ่งขึ้น
- แบบฟอร์มคำขอสำหรับนักพัฒนาแอปที่ได้รับการตรวจสอบแล้ว: นักพัฒนาซอฟต์แวร์ที่ผ่านการตรวจสอบการปฏิบัติตามข้อกำหนด API แล้วสามารถกรอกและส่งแบบฟอร์มสั้นๆ นี้เพื่อขอขยายโควต้าที่จัดสรรได้
- แบบฟอร์มคำร้อง: นักพัฒนาซอฟต์แวร์ที่โปรเจ็กต์ API ไม่ผ่านการตรวจสอบการปฏิบัติตามข้อกำหนด (หรือถูกปฏิเสธการเพิ่มหน่วยโควต้า) สามารถกรอกข้อมูลและส่งแบบฟอร์มนี้ได้
- แบบฟอร์มขอเปลี่ยนการควบคุม: นักพัฒนาแอปหรือบุคคลใดก็ตามที่ใช้งานไคลเอ็นต์ API ในนามของนักพัฒนาแอปซึ่งพบการเปลี่ยนแปลงการควบคุม (เช่น ผ่านทางการซื้อหรือขายหุ้น การควบรวมธุรกิจ หรือธุรกรรมองค์กรรูปแบบอื่น) ที่เชื่อมโยงกับโปรเจ็กต์ API ต้องกรอกข้อมูลและส่งแบบฟอร์มนี้ ซึ่งจะทำให้ทีม API ของ YouTube สามารถอัปเดตบันทึกของเรา ตรวจสอบการปฏิบัติตามกรณีการใช้งานของโครงการ API ใหม่ และตรวจสอบการจัดสรรโควต้าปัจจุบันของนักพัฒนาซอฟต์แวร์
แบบฟอร์มใหม่แต่ละแบบฟอร์มจะแจ้งให้เราทราบถึงการใช้งาน API ของ YouTube ที่คุณต้องการ และจะช่วยให้เราช่วยเหลือคุณได้ดียิ่งขึ้น
ดูรายละเอียดเพิ่มเติมได้ในคู่มือการตรวจสอบการปฏิบัติตามข้อกำหนด API ใหม่
12 พฤษภาคม 2021
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
การอัปเดตนี้ครอบคลุมถึงการเปลี่ยนแปลง API ต่อไปนี้
-
เลิกใช้งานพร็อพเพอร์ตี้
contentDetails.relatedPlaylists.favorites
ของทรัพยากรchannel
แล้ว เราได้เลิกใช้งานฟังก์ชันการทำงานของวิดีโอโปรดมาเป็นเวลาหลายปีแล้วตามที่ระบุไว้ในรายการประวัติการแก้ไขในวันที่ 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[]
พารามิเตอร์
hl
ของเมธอดchannelSection.list
จะถูกปฏิเสธควบคู่กับการเปลี่ยนแปลงนี้เช่นกันเนื่องจากระบบไม่รองรับฟีเจอร์ที่รองรับนำพร็อพเพอร์ตี้ทั้งหมดออกจากการแสดงทรัพยากรของ
channelSection
และคำจำกัดความได้ถูกนำออกจากรายการพร็อพเพอร์ตี้ของทรัพยากรแล้ว นอกจากนี้ ได้มีการนำข้อผิดพลาดที่เกี่ยวข้องกับพร็อพเพอร์ตี้เหล่านี้ออกจากเอกสารสำหรับแต่ละเมธอดด้วย -
สำหรับพร็อพเพอร์ตี้
snippet.type
ของทรัพยากรchannelSection
มีการเลิกใช้งานค่าต่อไปนี้แล้ว เนื่องจากหน้าช่อง YouTube ไม่รองรับค่าเหล่านี้อยู่แล้ว และด้วยเหตุนี้ ระบบจึงไม่รองรับค่าเหล่านี้ผ่าน API อีกต่อไปlikedPlaylists
likes
postedPlaylists
postedVideos
recentActivity
recentPosts
-
เลิกใช้งานพร็อพเพอร์ตี้
snippet.tags[]
ของทรัพยากรplaylist
แล้ว 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
(คำขอไม่ถูกต้อง) -
นำข้อผิดพลาด
watchHistoryNotAccessible
และwatchLaterNotAccessible
ของเมธอดplaylistItems.list
ออกจากเอกสารประกอบแล้ว แม้ว่าประวัติการดูและรายการดูภายหลังของผู้ใช้จะเข้าถึงผ่าน API ไม่ได้ แต่ API จะไม่แสดงผลข้อผิดพลาดที่เฉพาะเจาะจงเหล่านี้
15 ตุลาคม 2020
มีการเพิ่มส่วนใหม่ 2 ส่วนในนโยบายสำหรับนักพัฒนาแอป ได้แก่
- ส่วน III.E.4.i ใหม่จะให้ข้อมูลเพิ่มเติมเกี่ยวกับข้อมูลที่รวบรวมและส่งผ่านโปรแกรมเล่นแบบฝังของ YouTube คุณต้องรับผิดชอบต่อข้อมูลผู้ใช้ที่คุณส่งให้เราผ่านโปรแกรมเล่นแบบฝังของ YouTube ก่อนที่ผู้ใช้จะโต้ตอบกับโปรแกรมเล่นเพื่อระบุความตั้งใจในการเล่น คุณจำกัดข้อมูลที่แชร์กับ YouTube ก่อนที่ผู้ใช้จะโต้ตอบกับโปรแกรมเล่นได้โดยการตั้งค่าการเล่นอัตโนมัติเป็น "เท็จ"
- ส่วน III.E.4.j ใหม่เกี่ยวข้องกับการตรวจสอบสถานะเนื้อหาที่สร้างมาเพื่อเด็ก (MFK) ก่อนฝังเนื้อหาดังกล่าวลงในเว็บไซต์และแอป คุณมีหน้าที่รับผิดชอบในการทราบว่าวิดีโอที่คุณฝังในไคลเอ็นต์ API เป็นวิดีโอที่สร้างมาเพื่อเด็กเมื่อใด และจัดการกับข้อมูลที่รวบรวมจากโปรแกรมเล่นแบบฝังตามความเหมาะสม ด้วยเหตุนี้ คุณจึงต้องตรวจสอบสถานะของเนื้อหาโดยใช้บริการ YouTube Data API ก่อนฝังเนื้อหาดังกล่าวลงในไคลเอ็นต์ API ผ่านโปรแกรมเล่นที่ฝังของ YouTube
คำแนะนำเกี่ยวกับการค้นหาสถานะ MadeForKids ของวิดีโอใหม่จะอธิบายวิธีค้นหาสถานะ MFK ของวิดีโอโดยใช้บริการ YouTube Data API
และนอกเหนือจากนั้น เรายังได้เพิ่มการช่วยเตือนลงในเอกสารประกอบของพารามิเตอร์โปรแกรมเล่นแบบฝังเพื่ออธิบายว่าหากคุณเปิดใช้การเล่นอัตโนมัติ การเล่นจะเกิดขึ้นโดยไม่มีการโต้ตอบของผู้ใช้กับโปรแกรมเล่นวิดีโอ ดังนั้น การรวบรวมและการแชร์ข้อมูลการเล่นจะเกิดขึ้นเมื่อหน้าเว็บโหลดขึ้น
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
และพร็อพเพอร์ตี้ย่อยทั้งหมด
- พร็อพเพอร์ตี้
- พารามิเตอร์ตัวกรอง
categoryId
ของเมธอดchannels.list
- ทรัพยากร
guideCategories
และเมธอดguideCategories.list
- พร็อพเพอร์ตี้ทรัพยากร
-
การตอบกลับ API สำหรับเมธอด
channels.list
จะไม่มีพร็อพเพอร์ตี้prevPageToken
อีกต่อไป หากคำขอ API ตั้งค่าพารามิเตอร์managedByMe
เป็นtrue
การเปลี่ยนแปลงนี้จะไม่ส่งผลต่อพร็อพเพอร์ตี้prevPageToken
สำหรับคำขอchannels.list
อื่นๆ และจะไม่ส่งผลต่อพร็อพเพอร์ตี้nextPageToken
สำหรับคำขอใดๆ -
มีการประกาศทั้งพร็อพเพอร์ตี้
contentDetails.relatedPlaylists.watchLater
และcontentDetails.relatedPlaylists.watchHistory
ของทรัพยากรchannel
ในวันที่ 11 สิงหาคม 2016 ตอนนี้เราเลิกใช้งานการรองรับเมธอดplaylistItems.insert
และเมธอดplaylistItems.delete
สำหรับเพลย์ลิสต์เหล่านี้โดยสมบูรณ์แล้ว รวมถึงได้นำพร็อพเพอร์ตี้ทั้ง 2 รายการออกจากเอกสารประกอบด้วย -
พารามิเตอร์
mySubscribers
ของเมธอดchannels.list
ซึ่งประกาศว่าเลิกใช้งานเมื่อวันที่ 30 กรกฎาคม 2013 ได้ถูกนำออกจากเอกสารประกอบแล้ว ใช้เมธอดsubscriptions.list
และพารามิเตอร์mySubscribers
เพื่อเรียกข้อมูลรายการผู้ติดตามไปยังช่องของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์ -
ออบเจ็กต์
invideoPromotion
ของทรัพยากรchannel
และพร็อพเพอร์ตี้ย่อยทั้งหมดของทรัพยากรดังกล่าวซึ่งประกาศว่าเลิกใช้งานเมื่อวันที่ 27 พฤศจิกายน 2017 ถูกนำออกจากเอกสารประกอบแล้ว
29 กรกฎาคม 2020
เราได้ทำให้กระบวนการสำหรับโควต้าการเรียกเก็บเงินสำหรับคำขอ API ง่ายขึ้นโดยการนำค่าใช้จ่ายเพิ่มเติมที่เชื่อมโยงกับพารามิเตอร์ part
ออก เราจะเรียกเก็บเฉพาะค่าใช้จ่ายพื้นฐานสําหรับวิธีที่มีการเรียกใช้เท่านั้น โดยจะมีผลบังคับใช้ทันที ดูข้อมูลเพิ่มเติมเกี่ยวกับโควต้าแบบง่ายได้ที่นี่
ผลกระทบของการเปลี่ยนแปลงนี้คือการเรียก API ส่วนใหญ่จะมีต้นทุนโควต้าต่ำลงเล็กน้อย ในขณะที่การเรียก API บางรายการจะยังคงมีค่าใช้จ่ายเท่าเดิม การเปลี่ยนแปลงนี้ไม่ได้เพิ่มค่าใช้จ่ายในการเรียก API โดยรวมแล้ว ผลกระทบที่อาจเกิดขึ้นคือโควต้าที่จัดสรรไว้ ซึ่งดูได้ใน Google Cloud Console จะเพิ่มขึ้นอีกเล็กน้อย
เราขอแนะนำให้นักพัฒนาแอปทุกรายทำการตรวจสอบการปฏิบัติตามข้อกำหนดสำหรับโปรเจ็กต์ของตนเพื่อให้แน่ใจว่าสามารถเข้าถึงบริการ YouTube API ได้ต่อไป
รายการประวัติการแก้ไขนี้เผยแพร่ครั้งแรกเมื่อวันที่ 20 กรกฎาคม 2020
28 กรกฎาคม 2020
วิดีโอทั้งหมดที่อัปโหลดผ่านปลายทาง videos.insert
จากโปรเจ็กต์ API ที่ไม่ได้รับการยืนยันซึ่งสร้างหลังวันที่ 28 กรกฎาคม 2020 จะถูกจำกัดอยู่ในโหมดดูแบบส่วนตัว หากต้องการยกเลิกการจำกัดนี้ แต่ละโปรเจ็กต์ต้องได้รับการตรวจสอบเพื่อยืนยันว่าเป็นไปตามข้อกำหนดในการให้บริการ
ครีเอเตอร์ที่ใช้ไคลเอ็นต์ API ที่ไม่ได้รับการยืนยันเพื่ออัปโหลดวิดีโอจะได้รับอีเมลอธิบายว่ามีการล็อกวิดีโอให้เป็นแบบส่วนตัว และผู้ใช้สามารถหลีกเลี่ยงข้อจำกัดดังกล่าวได้ด้วยการใช้ไคลเอ็นต์อย่างเป็นทางการหรือที่ได้รับการตรวจสอบแล้ว
ปัจจุบันโปรเจ็กต์ API ที่สร้างขึ้นก่อนวันที่ 28 กรกฎาคม 2020 จะไม่ได้รับผลกระทบจากการเปลี่ยนแปลงนี้ อย่างไรก็ตาม เราขอแนะนำให้นักพัฒนาแอปทุกรายดำเนินการตรวจสอบการปฏิบัติตามข้อกำหนดสำหรับโครงการของตนเพื่อให้แน่ใจว่าสามารถเข้าถึงบริการ YouTube API ได้ต่อไป
21 กรกฎาคม 2020
[อัปเดตเมื่อ 28 กรกฎาคม 2020] การอัปเดตเอกสารที่อ้างอิงในรายการประวัติการแก้ไขนี้มีการเผยแพร่ซ้ำเมื่อวันที่ 28 กรกฎาคม 2020
เมื่อวานนี้ เราได้เผยแพร่การอัปเดตเอกสารเกี่ยวกับขั้นตอนสำหรับโควต้าการเรียกเก็บเงินของเรา อย่างไรก็ตาม เนื่องจากสถานการณ์ที่ไม่คาดคิด การเปลี่ยนแปลงโควต้าจึงยังไม่มีผลบังคับใช้ ด้วยเหตุนี้ ระบบจึงเปลี่ยนกลับเอกสารประกอบดังกล่าวเพื่อความถูกต้อง เราได้นำรายการประวัติการแก้ไขที่อธิบายการเปลี่ยนแปลงออกไปแล้ว และจะเผยแพร่อีกครั้งในอนาคตอันใกล้เพื่อไม่ให้เกิดความสับสน
7 กรกฎาคม 2020
หมายเหตุ: นี่เป็นประกาศการเลิกใช้งาน
ตอนนี้พารามิเตอร์ autoLevels
และ stabilize
ของเมธอด videos.insert
เลิกใช้งานแล้ว รวมถึงได้นำพารามิเตอร์ทั้ง 2 รายการออกจากเอกสารประกอบแล้ว ระบบจะไม่สนใจค่าของวิดีโอและไม่ส่งผลต่อวิธีการประมวลผลวิดีโอที่อัปโหลดใหม่
15 มิถุนายน 2020
คู่มือการปฏิบัติตามนโยบายสำหรับนักพัฒนาแอป YouTube ใหม่จะมีคำแนะนำและตัวอย่างเพื่อช่วยให้คุณมั่นใจได้ว่าไคลเอ็นต์ API จะปฏิบัติตามข้อกำหนดและนโยบาย (ข้อกำหนดในการให้บริการของ API) ของบริการ API ของ YouTube
คำแนะนำนี้จะให้ข้อมูลเชิงลึกเกี่ยวกับวิธีที่ 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
ที่บันทึกไว้เป็นส่วนหนึ่งของ YouTube Live Streaming API ตอนนี้เราเลิกใช้งานทรัพยากรsponsor
แล้ว และไคลเอ็นต์ API ควรอัปเดตการเรียกเมธอดsponsors.list
ไปใช้เมธอดmembers.list
แทน -
ทรัพยากร
membershipsLevel
ใหม่จะระบุระดับราคาที่จัดการโดยครีเอเตอร์ซึ่งให้สิทธิ์คำขอ API เมธอดmembershipsLevels.list
จะเรียกข้อมูลรายการระดับการเป็นสมาชิกทั้งหมดของครีเอเตอร์
-
10 มกราคม 2020
ขณะนี้ API รองรับความสามารถในการระบุเนื้อหาที่มีเด็กเป็นกลุ่มเป้าหมาย ซึ่ง YouTube เรียกเนื้อหาว่า "สร้างมาเพื่อเด็ก" ดูข้อมูลเพิ่มเติมเกี่ยวกับเนื้อหาที่ "สร้างมาเพื่อเด็ก" ในศูนย์ช่วยเหลือของ YouTube
แหล่งข้อมูล channel
และ video
รองรับพร็อพเพอร์ตี้ใหม่ 2 รายการที่ช่วยให้ครีเอเตอร์เนื้อหาและผู้ชมระบุเนื้อหาที่สร้างมาเพื่อเด็กได้ ดังนี้
-
พร็อพเพอร์ตี้
selfDeclaredMadeForKids
ช่วยให้ครีเอเตอร์เนื้อหาระบุได้ว่าช่องหรือวิดีโอสร้างมาเพื่อเด็ก
สำหรับแชแนล คุณจะตั้งค่าพร็อพเพอร์ตี้นี้ได้เมื่อเรียกใช้เมธอด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 คน การเปลี่ยนแปลงนี้ส่งผลต่อพร็อพเพอร์ตี้ statistics.subscriberCount ของทรัพยากร channel
หมายเหตุ: การเปลี่ยนแปลงนี้จะส่งผลต่อค่าของพร็อพเพอร์ตี้นี้แม้ในกรณีที่ผู้ใช้ส่งคำขอที่ได้รับอนุญาตสำหรับข้อมูลเกี่ยวกับช่องของตนเอง เจ้าของช่องจะยังดูจำนวนผู้ติดตามที่แน่นอนได้ใน 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 ได้รับการอัปเดตให้อธิบาย Use Case ที่พบบ่อยสำหรับแต่ละเมธอดได้ดียิ่งขึ้น และเพื่อส่งตัวอย่างโค้ดแบบไดนามิกและมีคุณภาพสูงผ่านวิดเจ็ต API Explorer ดูตัวอย่างเอกสารของเมธอด
channels.list
ขณะนี้มีองค์ประกอบใหม่ 2 อย่างในหน้าเว็บที่อธิบายถึงเมธอด API ดังนี้-
วิดเจ็ต API Explorer ช่วยให้คุณสามารถเลือกขอบเขตการให้สิทธิ์ ป้อนค่าตัวอย่างพารามิเตอร์และพร็อพเพอร์ตี้ จากนั้นส่งคำขอ API จริงและดูการตอบกลับจาก API ตามจริง วิดเจ็ตนี้ยังนำเสนอมุมมองแบบเต็มหน้าจอที่แสดงตัวอย่างโค้ดที่สมบูรณ์ซึ่งจะมีการอัปเดตแบบไดนามิกเพื่อใช้ขอบเขตและค่าที่คุณป้อนไว้
-
ในส่วน Use Case ทั่วไป จะอธิบาย Use Case ที่พบบ่อยอย่างน้อย 1 รายการสําหรับวิธีที่อธิบายในหน้า เช่น คุณอาจเรียกใช้เมธอด
channels.list
เพื่อดึงข้อมูลเกี่ยวกับช่องทางหนึ่งๆ หรือเพื่อดึงข้อมูลเกี่ยวกับช่องของผู้ใช้ปัจจุบันคุณสามารถใช้ลิงก์ในส่วนดังกล่าวเพื่อเติมค่าใน API Explorer ด้วยค่าตัวอย่างสำหรับกรณีการใช้งาน หรือเปิด API Explorer แบบเต็มหน้าจอด้วยค่าเหล่านั้นที่มีการป้อนข้อมูลแล้ว การเปลี่ยนแปลงเหล่านี้มีจุดมุ่งหมายเพื่อช่วยให้คุณดูตัวอย่างโค้ดที่เกี่ยวข้องโดยตรงกับ Use Case ที่คุณพยายามจะปรับใช้ในแอปพลิเคชันของคุณเองได้ง่ายขึ้น
ปัจจุบันตัวอย่างโค้ดรองรับ Java, JavaScript, PHP, Python และ curl
-
-
นอกจากนี้ เครื่องมือตัวอย่างโค้ดยังได้รับการอัปเดตด้วย UI ใหม่ที่เสนอฟีเจอร์เดียวกันทั้งหมดดังที่อธิบายไว้ข้างต้น เครื่องมือนี้จะช่วยให้คุณสำรวจกรณีการใช้งานสำหรับวิธีการต่างๆ โหลดค่าลงใน API Explorer และเปิด API Explorer แบบเต็มหน้าจอเพื่อรับตัวอย่างโค้ดใน Java, JavaScript, PHP และ Python ได้
เราได้นำหน้าเว็บที่ก่อนหน้านี้แสดงตัวอย่างโค้ดที่พร้อมใช้งานสำหรับ Java, JavaScript, PHP และ Python ออกร่วมกับการเปลี่ยนแปลงนี้
-
อัปเดตคู่มือเริ่มใช้งานฉบับย่อสำหรับ Java, JavaScript, PHP และ Python แล้ว คำแนะนำที่แก้ไขจะอธิบายวิธีเรียกใช้ตัวอย่างด้วยคีย์ 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
เราได้ปรับปรุงคำแนะนำการใช้งาน หรือที่ก่อนหน้านี้เรียกว่าคำแนะนำการติดตั้งใช้งานและการย้ายข้อมูล เพื่อนำวิธีการย้ายข้อมูลจาก API v2 ไปยัง 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
อัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
- คู่มือเริ่มใช้งานฉบับย่อสำหรับ YouTube Data API ใหม่มีให้บริการสำหรับ iOS แล้ว คำแนะนำนี้จะอธิบายวิธีใช้ YouTube Data API ในแอปพลิเคชัน 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 ได้สำหรับวิธีใดก็ตาม เครื่องมือจะแสดงข้อมูลโค้ดสำหรับกรณีการใช้งานอย่างน้อย 1 กรณี และกรณีการใช้งานแต่ละกรณีอธิบายวิธีทั่วไปในการเรียกใช้วิธีการนั้น เช่น คุณอาจเรียกใช้เมธอด
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
อัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
รายการรหัสหัวข้อที่จะรองรับตั้งแต่วันที่ 10 กุมภาพันธ์ 2017 จะมีการเปลี่ยนแปลงเล็กน้อย 3 ประการดังนี้
- หมวดหมู่
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 ความกว้างของโปรแกรมเล่นก็จะเท่ากับ 640pxด้วยพารามิเตอร์ใหม่ คุณสามารถระบุได้ว่า โค้ดสำหรับฝังควรใช้ความสูงและ/หรือความกว้างที่เหมาะกับการจัดวางแอปพลิเคชันของคุณ แทนขนาดเริ่มต้น เซิร์ฟเวอร์ API จะปรับขนาดโปรแกรมเล่นตามความเหมาะสมเพื่อให้มั่นใจว่าโปรแกรมเล่นแบบฝังไม่มีแถบสีดำที่ล้อมรอบวิดีโอ โปรดทราบว่าพารามิเตอร์ทั้ง 2 รายการจะระบุขนาดสูงสุดของโปรแกรมเล่นแบบฝัง ดังนั้น หากมีการระบุพารามิเตอร์ทั้ง 2 ค่า มิติข้อมูล 1 รายการอาจยังคงน้อยกว่าจํานวนสูงสุดที่อนุญาตสําหรับมิติข้อมูลนั้น
เช่น สมมติว่าวิดีโอมีสัดส่วนภาพ 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
จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าคำขอพยายามเรียกข้อมูลรายการในเพลย์ลิสต์ "ประวัติการดู" แต่เรียกดูรายการเหล่านั้นโดยใช้ API ไม่ได้forbidden (403)
watchLaterNotAccessible
เมธอด playlistItems.list
จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าคำขอพยายามเรียกข้อมูลรายการในเพลย์ลิสต์ "ดูภายหลัง" แต่เรียกดูรายการเหล่านั้นโดยใช้ API ไม่ได้badRequest (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 กันยายน 2016contentDetails.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
จะแสดงข้อผิดพลาดต้องห้าม (403
) เมื่อคำขอที่ได้รับอนุญาตอย่างไม่ถูกต้องพยายามเรียกส่วนfileDetails
,processingDetails
หรือsuggestions
ของทรัพยากรvideo
เฉพาะเจ้าของวิดีโอเท่านั้นที่จะเข้าถึงส่วนเหล่านั้นได้
17 พฤษภาคม 2016
เครื่องมือข้อมูลโค้ด Data API ใหม่จะให้ข้อมูลโค้ดสั้นๆ สำหรับกรณีการใช้งานทั่วไปของ YouTube Data API ปัจจุบันข้อมูลโค้ดพร้อมใช้งานกับเมธอด API แบบอ่านอย่างเดียวทั้งหมดใน Apps Script, Go, JavaScript, PHP, Python และ Ruby
สำหรับแต่ละวิธี เครื่องมือจะแสดงตัวอย่างโค้ดสำหรับกรณีการใช้งานอย่างน้อย 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 Console ซึ่งคุณสามารถดูโควต้าจริงและการใช้งานโควต้าได้
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
จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าวิดีโอที่คุณพยายามเพิ่มลงในเพลย์ลิสต์นั้นอยู่ในรายการซีรีส์อื่นแล้ว ดูข้อมูลเพิ่มเติมเกี่ยวกับรายการซีรีส์ได้ที่ศูนย์ช่วยเหลือของ YouTubebadRequest (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
สำหรับแหล่งข้อมูลและตัวกรองเพื่อดูว่ามีข้อความที่แปลแล้วหรือไม่
ตัวอย่างเช่น คุณจะต้องดึงรายการการแปลทั้งหมดเพื่อพิจารณาว่าข้อความที่แปลแล้วพร้อมใช้งานเป็นภาษาอังกฤษแบบแอปพาเลเชียหรือไม่
-
เมื่อเรียกข้อมูลทรัพยากร ให้ใส่
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 Classion ของฝรั่งเศส พร็อพเพอร์ตี้นี้แทนที่พร็อพเพอร์ตี้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 v2 รองรับ แม้ว่าจะไม่ได้เหมือนกันก็ตาม
-
พร็อพเพอร์ตี้
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 เวอร์ชัน 2 ไม่รองรับแต่รองรับใน API เวอร์ชัน 3 ซึ่งรวมถึงการใช้งานดังต่อไปนี้
- การเรียกความคิดเห็นเกี่ยวกับช่อง
- เรียกดูชุดความคิดเห็นทั้งหมดที่เกี่ยวข้องกับช่องได้ ซึ่งหมายความว่าการตอบกลับจาก API อาจมีความคิดเห็นเกี่ยวกับช่องหรือวิดีโอใดๆ ในช่องได้
- การอัปเดตข้อความของความคิดเห็น
- การทำเครื่องหมายความคิดเห็นว่าเป็นสแปม
- การตั้งค่าสถานะการดูแลความคิดเห็น
-
เราได้อัปเดตคู่มือการสมัครรับข้อความ Push เพื่อแสดงให้เห็นว่าการแจ้งเตือนจะพุชไปยังฮับ Google PubSubHubBub เท่านั้น และไม่ได้ส่งไปยังฮับ Superfeedr ตามที่ได้ระบุไว้ก่อนหน้านี้
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 ใหม่จะอธิบายการรองรับข้อความ Push แบบใหม่ของ API ผ่าน PubSubHubBub ซึ่งเป็นโปรโตคอลการเผยแพร่/สมัครรับข้อมูลแบบเซิร์ฟเวอร์ต่อเซิร์ฟเวอร์สำหรับทรัพยากรที่เข้าถึงได้บนเว็บ เซิร์ฟเวอร์เรียกกลับ PubSubHubBub จะได้รับการแจ้งเตือนฟีด Atom เมื่อช่องทำกิจกรรมต่อไปนี้
- อัปโหลดวิดีโอ
- อัปเดตชื่อของวิดีโอ
- อัปเดตคำอธิบายของวิดีโอ
-
นอกจากนี้ เรายังได้อัปเดตคำแนะนำในการย้ายข้อมูลเพื่อให้ทราบถึงการรองรับข้อความ Push ใหม่ อย่างไรก็ตาม เนื่องจาก API v2 รองรับข้อความ Push ประเภทอื่นๆ มากมายที่ไม่รองรับใน API v3 การกล่าวถึงการรองรับ 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 รายการเดียวAPI รองรับเมธอดในการแสดงรายการ แทรก อัปเดต ดาวน์โหลด และลบแทร็กคำบรรยายวิดีโอ
-
นอกจากนี้ยังมีการอัปเดตคำแนะนำในการย้ายข้อมูลเพื่ออธิบายวิธีย้ายข้อมูลแอปพลิเคชันที่ยังคงใช้ฟังก์ชันคำบรรยายใน API เวอร์ชัน 2 อีกด้วย
-
ขอบเขต
https://www.googleapis.com/auth/youtube.force-ssl
ใหม่ของ API จำเป็นต้องมีการสื่อสารกับเซิร์ฟเวอร์ API ผ่านการเชื่อมต่อ SSLขอบเขตใหม่นี้ให้สิทธิ์การเข้าถึงเดียวกันกับขอบเขต
https://www.googleapis.com/auth/youtube
และที่จริงแล้ว 2 ขอบเขตนี้มีฟังก์ชันการทำงานเหมือนกันเนื่องจากเซิร์ฟเวอร์ YouTube API ใช้งานได้ผ่านปลายทาง HTTPS เท่านั้น ดังนั้น แม้ว่าขอบเขตhttps://www.googleapis.com/auth/youtube
จะไม่ต้องใช้การเชื่อมต่อ SSL แต่จริงๆ แล้วจะไม่มีวิธีอื่นๆ ในการส่งคำขอ APIจำเป็นต้องมีขอบเขตใหม่นี้ในการเรียกใช้เมธอดทั้งหมดของทรัพยากร
caption
11 มีนาคม 2015
อัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
คำแนะนำในการย้ายข้อมูล YouTube Data API (v3) มีแท็บใหม่ชื่อใหม่ใน API v3 ซึ่งแสดงฟีเจอร์ที่ v3 API รองรับและ API v2 ไม่รองรับ ลักษณะเดียวกันนี้มีอยู่ก่อนหน้านี้และยังคงแสดงอยู่ในแท็บอื่นๆ ในคำแนะนำ ตัวอย่างเช่น ฟีเจอร์ใหม่ที่อธิบายวิธีอัปเดตข้อมูลแคมเปญการโปรโมตในวิดีโอของช่องจะแสดงอยู่ในแท็บช่อง (โปรไฟล์) ด้วย
-
เราได้ปรับปรุงคำแนะนำในการย้ายข้อมูล YouTube Data API (v3) โปรดทราบว่า API v3 จะรองรับฟีเจอร์ v2 API ต่อไปนี้
-
เราได้ปรับปรุงคำแนะนำในการย้ายข้อมูล YouTube Data API (v3) โปรดทราบว่าฟีเจอร์ API v2 ต่อไปนี้จะไม่รองรับใน API v3
-
เรียกดูวิดีโอแนะนำ – API v3 จะไม่เรียกข้อมูลรายการที่มีเฉพาะวิดีโอที่แนะนำสำหรับผู้ใช้ API ปัจจุบันเท่านั้น อย่างไรก็ตาม คุณใช้ v3 API เพื่อค้นหาวิดีโอแนะนำได้โดยเรียกใช้เมธอด
activities.list
และตั้งค่าพารามิเตอร์home
เป็นtrue
ในการตอบกลับของ API ทรัพยากรจะตรงกับวิดีโอแนะนำหากค่าของพร็อพเพอร์ตี้
snippet.type
คือrecommendation
ในกรณีดังกล่าว พร็อพเพอร์ตี้contentDetails.recommendation.reason
และcontentDetails.recommendation.seedResourceId
จะมีข้อมูลเกี่ยวกับเหตุผลของการแนะนำวิดีโอ โปรดทราบว่าไม่มีการรับประกันว่าการตอบกลับจะมีวิดีโอแนะนำจำนวนหนึ่งหรือไม่ -
เรียกดูวิดีโอที่สมัครรับข้อมูลใหม่ – v3 API จะไม่เรียกข้อมูลรายการที่มีเฉพาะวิดีโอที่เพิ่งอัปโหลดไปยังช่องที่ผู้ใช้ API สมัครรับข้อมูล อย่างไรก็ตาม คุณใช้ v3 API เพื่อค้นหาวิดีโอที่มีการสมัครใช้บริการใหม่ได้โดยเรียกใช้เมธอด
activities.list
และตั้งค่าพารามิเตอร์home
เป็นtrue
ในการตอบกลับของ API ทรัพยากรจะสอดคล้องกับวิดีโอที่ต้องสมัครใช้บริการใหม่ หากค่าของพร็อพเพอร์ตี้
snippet.type
คือupload
โปรดทราบว่าไม่มีการรับประกันว่าการตอบกลับจะมีวิดีโอสมัครรับข้อมูลใหม่จำนวนหนึ่งหรือไม่ -
ข้อความ Push สำหรับการอัปเดตฟีด – API v2 รองรับข้อความ Push โดยใช้ Simple Update Protocol (sup) หรือ PubSubHubbub ในการตรวจสอบฟีดกิจกรรมของผู้ใช้ YouTube โดยจะมีการแจ้งเตือนสำหรับการติดตามช่องใหม่ และเมื่อมีการให้คะแนน แชร์ ทำเครื่องหมายเป็นรายการโปรด แสดงความคิดเห็น หรืออัปโหลดวิดีโอ
v3 API จะรองรับข้อความ Push โดยใช้โปรโตคอล PubSubHubbub แต่การแจ้งเตือนจะครอบคลุมเฉพาะการอัปโหลดวิดีโอและการอัปเดตชื่อหรือคำอธิบายวิดีโอ
-
ตำแหน่งของช่อง – API v2 ใช้แท็ก
<yt:location>
เพื่อระบุตำแหน่งของผู้ใช้ตามที่ป้อนในโปรไฟล์สาธารณะของ YouTube ของช่อง แม้ว่านักพัฒนาซอฟต์แวร์บางรายจะใช้ฟิลด์นี้เพื่อเชื่อมโยงช่องกับประเทศใดประเทศหนึ่ง แต่เราไม่สามารถใช้ข้อมูลในช่องนี้เพื่อวัตถุประสงค์ดังกล่าวอย่างสม่ำเสมอ -
ตั้งค่าหรือเรียกแท็กนักพัฒนาซอฟต์แวร์ – API v2 รองรับความสามารถในการเชื่อมโยงคีย์เวิร์ดหรือแท็กนักพัฒนาซอฟต์แวร์กับวิดีโอในขณะที่อัปโหลดวิดีโอดังกล่าว แท็กนักพัฒนาซอฟต์แวร์จะไม่แสดงแก่ผู้ใช้ YouTube แต่เจ้าของวิดีโอสามารถเรียกดูวิดีโอที่ตรงกับแท็กนักพัฒนาซอฟต์แวร์ที่เฉพาะเจาะจง
API v3 มีฟีเจอร์ที่คล้ายกันแต่ไม่ตรงกันทั้งหมด กล่าวคือ นักพัฒนาซอฟต์แวร์จะสามารถค้นหาวิดีโอที่อัปโหลดโดยแอปพลิเคชันของนักพัฒนาซอฟต์แวร์ได้ สำหรับฟีเจอร์นี้ วิดีโอที่อัปโหลดแต่ละรายการจะได้รับการติดแท็กด้วยหมายเลขโปรเจ็กต์ที่เชื่อมโยงกับแอปพลิเคชันของนักพัฒนาซอฟต์แวร์ใน Google Developers Console โดยอัตโนมัติ จากนั้นนักพัฒนาซอฟต์แวร์จะใช้หมายเลขโปรเจ็กต์เดียวกันในการค้นหาวิดีโอ
-
แสดงรายการวิดีโอตามวันที่เผยแพร่ ยอดดู หรือการจัดประเภท – ใน API เวอร์ชัน 2 พารามิเตอร์
orderby
จะให้คุณจัดเรียงวิดีโอในเพลย์ลิสต์ตามตำแหน่ง ระยะเวลา วันที่เผยแพร่ ชื่อ และค่าอื่นๆ อีกหลายรายการ ใน API v3 โดยทั่วไปรายการเพลย์ลิสต์จะจัดเรียงตามอันดับจากน้อยไปมาก และจะไม่มีตัวเลือกการจัดเรียงอื่นๆโดยมีข้อยกเว้นบางประการ ระบบจะเพิ่มการอัปโหลดใหม่ วิดีโอโปรด วิดีโอที่ชอบ หรือวิดีโอที่ดูล่าสุดเป็นรายการแรก (
snippet.position
=0
) สำหรับเพลย์ลิสต์ประเภทต่อไปนี้โดยอัตโนมัติ ดังนั้น แต่ละรายการเหล่านี้จึงได้รับการจัดเรียงจากใหม่ไปเก่าที่สุดอย่างมีประสิทธิภาพ โดยอิงตามเวลาที่เพิ่มสินค้าลงในรายการ- การอัปโหลดของผู้ใช้
- วิดีโอโปรด
- วิดีโอที่ชอบ
- ประวัติการดู
แต่โปรดทราบว่าจะมีการเพิ่มรายการใหม่ที่เพิ่มลงในเพลย์ลิสต์ "ดูภายหลัง" โดยเป็นรายการสุดท้ายในรายการดังกล่าว เพื่อให้จัดเรียงรายการดังกล่าวจากเก่าสุดไปใหม่สุดได้อย่างมีประสิทธิภาพ
-
การประมวลผลแบบกลุ่ม – API v3 รองรับ Use Case การประมวลผลแบบกลุ่มรายการใดรายการหนึ่งที่ 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) เพื่อระบุการเลิกใช้งานช่องฟีดและข้อมูลเมตาพิเศษที่ API v2 จัดเตรียมไว้ให้สำหรับการอธิบายภาพยนตร์ ตัวอย่าง รายการทีวี ซีซันรายการทีวี และตอนของรายการทีวี
14 มกราคม 2015
อัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เราได้ปรับปรุงคำแนะนำในการย้ายข้อมูล YouTube Data API (v3) เพื่ออธิบายวิธีใช้ v3 API เพื่ออัปโหลดวิดีโอโดยใช้ JavaScript (ดูรายละเอียดได้ในส่วนอัปโหลดวิดีโอ) ฟังก์ชันนี้เทียบเคียงได้กับฟังก์ชันการอัปโหลดบนเบราว์เซอร์ที่ API v2 รองรับ โปรดทราบว่าการเปลี่ยนแปลงในคู่มือการย้ายข้อมูลนี้ไม่ได้แสดงถึงการเปลี่ยนแปลง API จริง แต่เป็นความพร้อมใช้งานของโค้ดตัวอย่างใหม่สำหรับการอัปโหลดวิดีโอด้วย JavaScript ฝั่งไคลเอ็นต์
เนื่องจากการรองรับการอัปโหลดวิดีโอด้วยไลบรารีของไคลเอ็นต์ JavaScript และ CORS คำแนะนำในการย้ายข้อมูลจึงจะไม่แสดงการอัปโหลดผ่านเบราว์เซอร์ว่าเป็นฟีเจอร์ที่อาจเลิกใช้งานใน v3 API อีกต่อไป
-
อัปเดตเอกสารประกอบสำหรับเมธอด
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 ระบบ ซึ่งระบุการจัดประเภทที่วิดีโอได้รับจากหน่วยงานการจัดประเภทระดับประเทศต่างๆ {K56, , , {3, 2,10, {33, 337, 35, 0และทำให้พื้นที่ {1, พื้นที่ 13, พื้นที่ 13, พื้นที่ 13, ประเทศ 33, ประเทศ 33, ประเทศ 33, ประเทศ
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
ระบุการจัดประเภทที่วิดีโอได้รับจากสำนักงานการจัดประเภทภาพยนตร์ของไอร์แลนด์ -
อัปเดตคำจำกัดความพร็อพเพอร์ตี้
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 ของผู้ใช้ และผู้ใช้ยังสามารถเลือกภูมิภาคของเนื้อหาที่ต้องการได้จากส่วนท้ายของเว็บไซต์ YouTube ด้วยตนเองAPI รองรับเมธอดในการระบุภูมิภาคเนื้อหาที่รองรับ รหัสภูมิภาคที่รองรับสามารถใช้เป็นค่าของพารามิเตอร์
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
อัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ขณะนี้ YouTube Data API เวอร์ชัน 3 จะอยู่ภายใต้นโยบายการเลิกใช้งานที่อธิบายไว้ในข้อกำหนดในการให้บริการ API ของ YouTube โปรดทราบว่าหน้าที่แสดง API ที่อยู่ภายใต้นโยบายการเลิกใช้งานจะยกเว้นฟังก์ชันการทำงานบางอย่างของ API v3 ไม่ให้เป็นไปตามนโยบายดังกล่าว
5 ธันวาคม 2013
อัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
เอกสารของเมธอด
search.list
ได้รับการอัปเดตให้แสดงอย่างถูกต้องว่าคุณไม่จำเป็นต้องระบุค่าสำหรับพารามิเตอร์ตัวกรองเพียง 1 รายการเมื่อส่งคำขอการค้นหา แต่คุณจะตั้งค่าพารามิเตอร์ตัวกรองเป็น 0 หรือพารามิเตอร์ตัวกรองเพียงรายการเดียวก็ได้ -
อัปเดตคําจํากัดความของพารามิเตอร์ของเมธอด
search.list
แล้ว โปรดทราบว่าคุณต้องกําหนดค่าพารามิเตอร์type
เป็นvideo
หากระบุค่าสําหรับพารามิเตอร์ใดๆ ต่อไปนี้ด้วยeventType
videoCaption
videoCategoryId
videoDefinition
videoDimension
videoDuration
videoEmbeddable
videoLicense
videoSyndicated
videoType
-
ขนาดเล็กสุดของรูปภาพแบนเนอร์ของช่องที่อัปโหลดถูกลดขนาดลงเหลือ 2048 x 1152 พิกเซล (ก่อนหน้านี้ ขนาดขั้นต่ำคือ 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
(V.M.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
เปลี่ยนจากออบเจ็กต์เป็นสตริง แทนที่จะมีพร็อพเพอร์ตี้ย่อยที่ระบุรหัสช่อง YouTube ของช่องที่รูปภาพลายน้ำเชื่อมโยงถึง ตอนนี้พร็อพเพอร์ตี้targetChannelId
จะระบุค่าดังกล่าวเอง ด้วยเหตุนี้ ระบบจึงนำพร็อพเพอร์ตี้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
แล้ว วิธีอื่นๆ ระบบรองรับพารามิเตอร์ทั้ง 2 รายการอยู่แล้ว -
ขณะนี้เมธอด
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 ของ 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
แล้ว วิธีอื่นๆ ระบบรองรับพารามิเตอร์ทั้ง 2 รายการอยู่แล้ว -
ในการตอบกลับของ API สำหรับคำขอ
thumbnails.set
ค่าพร็อพเพอร์ตี้kind
ได้เปลี่ยนจากyoutube#thumbnailListResponse
เป็นyoutube#thumbnailSetResponse
-
เพิ่มตัวอย่างโค้ดสำหรับวิธีการต่อไปนี้แล้ว
channels.update
(Java, Python)playlists.insert
(.NET, เปโซฟิลิปปินส์)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
อัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้
-
ส่วนการใช้โควต้าของคู่มือการเริ่มต้นใช้งาน YouTube Data API ได้รับการอัปเดตเพื่อแสดงการเปลี่ยนแปลงค่าใช้จ่ายโควต้าของการอัปโหลดวิดีโอจากประมาณ 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, Ruby)
-
พารามิเตอร์
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
ออสเตรเลีย Australian Classification Board (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
อินเดีย คณะกรรมการกลางรับรองภาพยนตร์ (CBFC) contentDetails.contentRating.cbfcRating
ญี่ปุ่น 映倫管理委員会 (EIRIN) contentDetails.contentRating.eirinRating
เกาหลี 영사물사뀄號 (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
ระบุว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุผู้ใช้ CMS ของ YouTube ที่ดำเนินการในนามของเจ้าของเนื้อหาที่ระบุไว้ในค่าพารามิเตอร์ บัญชี 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
ออบเจ็กต์ที่ระบุทรัพยากรที่เพิ่มลงในช่อง โดยมีพร็อพเพอร์ตี้ kind
ที่ระบุประเภททรัพยากร เช่น วิดีโอหรือเพลย์ลิสต์ เช่นเดียวกับพร็อพเพอร์ตี้resourceId
อื่นๆ นอกจากนี้ยังมีพร็อพเพอร์ตี้รายการใดรายการหนึ่ง เช่น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 เพื่อดึงรายการค่าที่ถูกต้อง