ประวัติการแก้ไข

หน้านี้จะแสดงการเปลี่ยนแปลงของ YouTube Data API (v3) และการอัปเดตเอกสาร ติดตามบันทึกการเปลี่ยนแปลงนี้ ติดตาม

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 ซึ่งใช้ขั้นตอนการให้สิทธิ์ที่แตกต่างกันเล็กน้อย วิธีดูตัวอย่างแบบเต็ม (และการเปลี่ยนแปลงนี้)

    1. ไปที่เครื่องมือข้อมูลโค้ดแบบอินเทอร์แอกทีฟหรือเอกสารสำหรับเมธอด API เช่น เมธอด channels.list
    2. คลิกแท็บ Python เหนือตัวอย่างโค้ด
    3. คลิกปุ่มสลับเหนือแท็บเพื่อสลับจากการดูตัวอย่างเป็นตัวอย่างแบบเต็ม
    4. ตอนนี้แท็บควรแสดงตัวอย่างโค้ดที่สมบูรณ์ซึ่งใช้ขั้นตอนการให้สิทธิ์ InstalledAppFlow คำอธิบายด้านบนตัวอย่างจะอธิบายเรื่องนี้และลิงก์ไปยังตัวอย่างสำหรับแอปพลิเคชันเว็บเซิร์ฟเวอร์
    5. คลิกลิงก์เพื่อสลับไปยังตัวอย่างเว็บเซิร์ฟเวอร์ ตัวอย่างนี้ใช้เฟรมเวิร์กเว็บแอปพลิเคชัน Flask และขั้นตอนการให้สิทธิ์อื่น

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

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 แล้ว:
    ชื่อรหัสหัวข้อ
    Business/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 พร็อพเพอร์ตี้นี้ได้รับการสนับสนุนจนถึงวันที่ 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 กันยายน 2016 contentDetails.relatedPlaylists.watchHistory จะแสดงผลค่า HL และพร็อพเพอร์ตี้ contentDetails.relatedPlaylists.watchLater จะแสดงผลค่า WL สำหรับทุกแชแนล

      คำขอเรียกดูรายละเอียดเพลย์ลิสต์ (playlists.list) สำหรับประวัติการดูหรือเพลย์ลิสต์ดูภายหลังของช่องจะแสดงรายการที่ว่างเปล่าหลังจากวันที่ 12 กันยายน 2016 คำขอเรียกรายการเพลย์ลิสต์ (playlistItems.list) ในเพลย์ลิสต์เหล่านั้นจะแสดงรายการที่ว่างเปล่าหลังจากนั้นด้วย ค่าใหม่ได้แก่ HL และ WL รวมถึงประวัติการดูหรือรหัสเพลย์ลิสต์ดูภายหลังที่ไคลเอ็นต์ API อาจจัดเก็บไว้แล้ว

    • ออบเจ็กต์ fileDetails.recordingLocation ของทรัพยากร video หรือพร็อพเพอร์ตี้ย่อยใดๆ ของทรัพยากรดังกล่าวจะไม่แสดงหลังจากวันที่ 12 กันยายน 2016 มีเพียงเจ้าของวิดีโอเท่านั้นที่ดึงข้อมูลนี้ได้ เนื่องจากออบเจ็กต์ fileDetails ระดับบนสุดดึงได้โดยเจ้าของวิดีโอเท่านั้น

13 มิถุนายน 2016

อัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

  • พร็อพเพอร์ตี้ contentDetails.googlePlusUserId ของทรัพยากร channel เลิกใช้งานแล้ว ก่อนหน้านี้ พร็อพเพอร์ตี้จะแสดงก็ต่อเมื่อช่องเชื่อมโยงกับโปรไฟล์ Google+ เท่านั้น หลังจากการเลิกใช้งาน พร็อพเพอร์ตี้ดังกล่าวจะไม่รวมอยู่ในทรัพยากร channel ใดๆ อีกต่อไป

  • พร็อพเพอร์ตี้ snippet.authorGoogleplusProfileUrl ของทรัพยากร comment เลิกใช้งานแล้ว ก่อนหน้านี้ พร็อพเพอร์ตี้จะแสดงก็ต่อเมื่อช่องเชื่อมโยงกับโปรไฟล์ Google+ เท่านั้น หลังจากการเลิกใช้งาน พร็อพเพอร์ตี้ดังกล่าวจะไม่รวมอยู่ในทรัพยากร comment ใดๆ อีกต่อไป

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

31 พฤษภาคม 2016

อัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

  • พารามิเตอร์ myRecentSubscribers ใหม่ของเมธอด subscriptions.list จะดึงรายชื่อผู้ติดตามช่องของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์โดยเรียงตามลำดับเวลาจากใหม่ไปหาเก่า

    โปรดทราบว่าพารามิเตอร์ใหม่รองรับเฉพาะการดึงข้อมูลจากสมาชิก 1,000 รายล่าสุดไปยังช่องของผู้ใช้ที่ผ่านการตรวจสอบสิทธิ์เท่านั้น หากต้องการดึงข้อมูลรายการสมาชิกทั้งหมด ให้ใช้พารามิเตอร์ mySubscribers พารามิเตอร์ดังกล่าวซึ่งไม่แสดงผลผู้ติดตามในลำดับหนึ่งๆ จะไม่จำกัดจำนวนผู้ติดตามที่ดึงข้อมูลได้

  • มีการอัปเดตคำจำกัดความของพร็อพเพอร์ตี้ snippet.thumbnails.(key) สำหรับแหล่งข้อมูลกิจกรรม, playlistItem, เพลย์ลิสต์ ผลการค้นหา ภาพปก และวิดีโอ โปรดทราบว่าวิดีโอบางรายการมีภาพขนาดย่อเพิ่มเติม

    • รูปภาพ standard กว้าง 640 พิกเซลและสูง 480 พิกเซล
    • รูปภาพ maxres กว้าง 1280 พิกเซลและสูง 720 พิกเซล
  • อัปเดตคําจํากัดความของพารามิเตอร์ part ของเมธอด channelSection.list แล้วเพื่อให้ดึงข้อมูลส่วน targeting ได้โดยใช้หน่วยโควต้า 2 หน่วย

  • ตอนนี้เมธอด videos.list จะแสดงข้อผิดพลาดต้องห้าม (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 จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าวิดีโอที่คุณพยายามเพิ่มลงในเพลย์ลิสต์นั้นอยู่ในรายการซีรีส์อื่นแล้ว ดูข้อมูลเพิ่มเติมเกี่ยวกับรายการซีรีส์ได้ที่ศูนย์ช่วยเหลือของ YouTube
    badRequest (400) subscriptionForbidden เมธอด subscriptions.insert จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าคุณมีการสมัครใช้บริการครบตามจำนวนสูงสุดแล้ว หรือคุณสร้างการสมัครใช้บริการล่าสุดมากเกินไป ในกรณีหลัง คุณสามารถลองส่งคำขออีกครั้งหลังจากผ่านไป 2-3 ชั่วโมง
    badRequest (400) invalidCategoryId เมธอด videos.update จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้ snippet.categoryId ในทรัพยากร video ที่อัปโหลดระบุรหัสหมวดหมู่ที่ไม่ถูกต้อง ใช้เมธอด videoCategories.list เพื่อดึงข้อมูลหมวดหมู่ที่รองรับ
    badRequest (400) invalidDescription เมธอด videos.update จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้ snippet.description ในทรัพยากร video ที่อัปโหลดระบุค่าที่ไม่ถูกต้อง
    badRequest (400) invalidPublishAt เมธอด videos.update จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้ status.publishAt ในทรัพยากร video ที่อัปโหลดระบุเวลาการเผยแพร่ที่กำหนดไว้ไม่ถูกต้อง
    badRequest (400) invalidRecordingDetails เมธอด videos.update จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าออบเจ็กต์ recordingDetails ในทรัพยากร video ที่อัปโหลดระบุรายละเอียดการบันทึกที่ไม่ถูกต้อง
    badRequest (400) invalidTags เมธอด videos.update จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้ snippet.tags ในทรัพยากร video ที่อัปโหลดระบุค่าที่ไม่ถูกต้อง
    badRequest (400) invalidTitle เมธอด videos.update จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้ snippet.title ในทรัพยากร video ที่อัปโหลดระบุชื่อวิดีโอที่ไม่ถูกต้องหรือว่างเปล่า
    badRequest (400) invalidVideoMetadata เมธอด videos.update จะแสดงผลข้อผิดพลาดนี้เพื่อระบุว่าข้อมูลเมตาของคำขอไม่ถูกต้อง ข้อผิดพลาดนี้เกิดขึ้นหากคำขออัปเดตส่วน snippet ของทรัพยากร video แต่ไม่ได้ตั้งค่าสำหรับทั้งพร็อพเพอร์ตี้ snippet.title และ snippet.categoryId

18 ธันวาคม 2015

กฎหมายของสหภาพยุโรป (EU) กำหนดว่าต้องมีการเปิดเผยข้อมูลบางอย่างต่อผู้ใช้ปลายทางในสหภาพยุโรปและได้รับการยินยอมจากผู้ใช้ ดังนั้น สำหรับผู้ใช้ปลายทางในสหภาพยุโรป คุณต้องปฏิบัติตามนโยบายความยินยอมของผู้ใช้ EU เราได้เพิ่มประกาศข้อกำหนดนี้ไว้ในข้อกำหนดในการให้บริการ API ของ YouTube

19 พฤศจิกายน 2015

ตอนนี้ API รองรับความสามารถในการตั้งค่าและเรียกข้อความที่แปลแล้วสำหรับพร็อพเพอร์ตี้ snippet.title และ snippet.description ของทรัพยากร playlist และ video พร็อพเพอร์ตี้ snippet.title ของทรัพยากร channelSection และพร็อพเพอร์ตี้ snippet.description ของทรัพยากร channel

  • การตั้งค่าชื่อและคำอธิบายที่แปลแล้ว

    คุณสามารถกำหนดค่าที่แปลแล้วสำหรับทรัพยากรได้เมื่อเรียกใช้เมธอด insert หรือ update สำหรับทรัพยากรนั้นๆ หากต้องการกำหนดค่าที่แปลแล้วสำหรับทรัพยากร ให้ทำทั้ง 2 อย่างต่อไปนี้

    • ตรวจสอบว่าได้กำหนดค่าให้กับพร็อพเพอร์ตี้ snippet.defaultLanguage ของทรัพยากรแล้ว พร็อพเพอร์ตี้ดังกล่าวจะระบุภาษาของพร็อพเพอร์ตี้ snippet.title และ snippet.description ของทรัพยากร ค่าอาจเป็นภาษาของแอปพลิเคชันที่รองรับหรือรหัสภาษา ISO 639-1:2002 อื่นๆ ส่วนใหญ่ ตัวอย่างเช่น หากคุณอัปโหลดวิดีโอที่มีชื่อและคำอธิบายเป็นภาษาอังกฤษ คุณจะตั้งค่าพร็อพเพอร์ตี้ snippet.defaultLanguage เป็น en

      หมายเหตุสำหรับการอัปเดตทรัพยากร channel: หากต้องการตั้งค่าพร็อพเพอร์ตี้ snippet.defaultLanguage สำหรับทรัพยากร channel คุณจะต้องอัปเดตพร็อพเพอร์ตี้ brandingSettings.channel.defaultLanguage จริงๆ

    • เพิ่มออบเจ็กต์ localizations ไปยังทรัพยากรที่คุณกำลังอัปเดต คีย์ออบเจ็กต์แต่ละคีย์เป็นสตริงที่ระบุภาษาของแอปพลิเคชันหรือรหัสภาษา ISO 639-1:2002 และแต่ละคีย์แมปกับออบเจ็กต์ที่มีชื่อที่แปลแล้ว (และคำอธิบาย) สำหรับทรัพยากร

      ตัวอย่างข้อมูลโค้ดด้านล่างตั้งค่าภาษาเริ่มต้นของแหล่งข้อมูลเป็นภาษาอังกฤษ นอกจากนี้ ยังเพิ่มชื่อและคำอธิบายภาษาเยอรมันและภาษาสเปนลงในวิดีโอด้วย

      {
        "kind": "youtube#video",
        ...
        "snippet": {
          "title": "Playing soccer",
          "description": "We play soccer in the park on Sundays.",
          "defaultLanguage": "en",
          ...
        },
        "localizations":
          "de": {
            "title": "Fußball spielen",
            "description": "Wir spielen Fußball im Park am Sonntag"
          },
          "es": {
            "title": "Jugar al fútbol",
            "description": "Nosotros jugamos fútbol en el parque los domingos",
          }
        }
      }
    • สำคัญ: โปรดทราบว่าเมื่อคุณอัปเดตข้อมูลที่แปลแล้วสำหรับทรัพยากร คำขอ API จะต้องมีข้อมูลเวอร์ชันแปลที่มีอยู่ทั้งหมด ตัวอย่างเช่น หากคุณส่งคำขอหลังจากนั้นเพื่อเพิ่มข้อมูลภาษาโปรตุเกสลงในวิดีโอในตัวอย่างข้างต้น คำขอดังกล่าวจะต้องมีข้อมูลที่แปลเป็นภาษาโปรตุเกส เยอรมัน และสเปน

  • การดึงค่าที่แปลแล้ว

    API รองรับ 2 วิธีในการเรียกค่าที่แปลแล้วสำหรับทรัพยากรหนึ่งๆ ดังนี้

    • เพิ่มพารามิเตอร์ hl ในคำขอ channels.list, channelSections.list, playlists.list หรือ videos.list เพื่อดึงข้อมูลที่แปลแล้วสำหรับภาษาแอปพลิเคชันที่เฉพาะเจาะจงซึ่งเว็บไซต์ YouTube รองรับ หากมีรายละเอียดทรัพยากรที่แปลแล้วในภาษานั้น ออบเจ็กต์ snippet.localized ของทรัพยากรจะมีค่าที่แปล อย่างไรก็ตาม หากไม่มีรายละเอียดที่แปลเป็นภาษาท้องถิ่น ออบเจ็กต์ snippet.localized จะมีรายละเอียดทรัพยากรในภาษาเริ่มต้นของทรัพยากร

      ตัวอย่างเช่น สมมติว่าคำขอ videos.list ดึงข้อมูลสำหรับวิดีโอที่อธิบายไว้ข้างต้นด้วยข้อมูลภาษาเยอรมันและสเปน หากตั้งค่าพารามิเตอร์ hl เป็น de ทรัพยากรจะมีข้อมูลต่อไปนี้

      {
        "kind": "youtube#video",
        ...
        "snippet": {
          "title": "Playing soccer",
          "description": "We play soccer in the park on Sundays.",
          "defaultLanguage": "en",
          "localized": {
            "title": "Fußball spielen",
            "description": "Wir spielen Fußball im Park am Sonntag"
          }
          ...
        }
      }

      อย่างไรก็ตาม หากตั้งค่าพารามิเตอร์ hl เป็น fr ออบเจ็กต์ snippet.localized จะมีชื่อและคำอธิบายภาษาอังกฤษ เนื่องจากภาษาอังกฤษเป็นภาษาเริ่มต้นของแหล่งข้อมูล ส่วนรายละเอียดที่แปลเป็นภาษาฝรั่งเศสจะไม่พร้อมใช้งาน

      สำคัญ: พารามิเตอร์ hl รองรับเฉพาะค่าที่ระบุภาษาของแอปพลิเคชันที่เว็บไซต์ YouTube รองรับ ในการพิจารณาว่าข้อความที่แปลแล้วพร้อมใช้งานสำหรับภาษาอื่นหรือไม่ คุณจะต้องเรียกข้อมูลส่วน localizations สำหรับแหล่งข้อมูลและตัวกรองเพื่อดูว่ามีข้อความที่แปลแล้วหรือไม่

      ตัวอย่างเช่น คุณจะต้องดึงรายการการแปลทั้งหมดเพื่อพิจารณาว่าข้อความที่แปลแล้วพร้อมใช้งานเป็นภาษาอังกฤษแบบแอปพาเลเชียหรือไม่

    • เมื่อเรียกข้อมูลทรัพยากร ให้ใส่ 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
      รหัสตอบกลับ HTTPbadRequest (400)
      เหตุผลinvalidMetadata
      คำอธิบายพร็อพเพอร์ตี้ kind ไม่ตรงกับประเภทของรหัสที่ระบุ
      commentThreads.update
      comments.insert
      comments.update
      รหัสตอบกลับ HTTPbadRequest (400)
      เหตุผลcommentTextTooLong
      คำอธิบายทรัพยากร comment ที่แทรกหรืออัปเดตมีอักขระในพร็อพเพอร์ตี้ snippet.topLevelComment.snippet.textOriginal มากเกินไป
      playlistItems.insert
      playlistItems.update
      รหัสตอบกลับ HTTPforbidden (403)
      เหตุผลplaylistItemsNotAccessible
      คำอธิบายคำขอไม่ได้รับอนุญาตอย่างถูกต้องในการแทรก อัปเดต หรือลบรายการเพลย์ลิสต์ที่ระบุ
      playlists.delete
      playlists.insert
      playlists.update
      รหัสตอบกลับ HTTPbadRequest (400)
      เหตุผลplaylistForbidden
      คำอธิบายการดำเนินการนี้ไม่ได้รับอนุญาตหรือคำขอไม่ได้รับอนุญาตอย่างถูกต้อง
      search.list
      รหัสตอบกลับ HTTPbadRequest (400)
      เหตุผลinvalidLocation
      คำอธิบายค่าพารามิเตอร์ location และ/หรือ locationRadius มีรูปแบบไม่ถูกต้อง
      search.list
      รหัสตอบกลับ HTTPbadRequest (400)
      เหตุผลinvalidRelevanceLanguage
      คำอธิบายค่าพารามิเตอร์ relevanceLanguage จัดรูปแบบไม่ถูกต้อง
      subscriptions.insert
      รหัสตอบกลับ HTTPbadRequest (400)
      เหตุผลsubscriptionForbidden
      คำอธิบายข้อผิดพลาดนี้จะเกิดขึ้นเมื่อเงื่อนไขต่อไปนี้เป็นจริง
      • มีการสมัครใช้บริการที่คุณพยายามสร้างอยู่แล้ว
      • คุณสมัครใช้บริการครบตามจำนวนสูงสุดแล้ว
      • คุณกำลังพยายามสมัครรับข้อมูลจากช่องของคุณเอง ซึ่งระบบไม่รองรับ
      • คุณสร้างการสมัครใช้บริการมากเกินไปเมื่อเร็วๆ นี้ และต้องรอ 2-3 ชั่วโมงก่อนที่จะลองส่งคำขออีกครั้ง
      videos.update
      รหัสตอบกลับ HTTPbadRequest (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
      รหัสตอบกลับ HTTPbadRequest (400)
      เหตุผลemailNotVerified
      คำอธิบายผู้ใช้ต้องยืนยันอีเมลของตนเองก่อนจัดประเภทวิดีโอ
      videos.rate
      รหัสตอบกลับ HTTPbadRequest (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 แบบ ผู้ใช้ต้องมีคุณสมบัติตรงตามข้อกำหนดการกำหนดเป้าหมายทั้งหมด จึงจะมองเห็นได้ในส่วนแชแนล

    • คําจํากัดความของพร็อพเพอร์ตี้ contentDetails.duration ของทรัพยากร video ได้รับการแก้ไขแล้วเพื่อให้ค่าแสดงถึงชั่วโมง วัน และอื่นๆ

    • เอกสารสำหรับเมธอด channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete และ videos.delete ได้รับการแก้ไขแล้วเพื่อแสดงว่าเมธอดเหล่านั้นทั้งหมดแสดงผลโค้ดตอบกลับ HTTP 204 (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 โปรดทราบว่าไม่มีการรับประกันว่าการตอบกลับจะมีวิดีโอสมัครรับข้อมูลใหม่จำนวนหนึ่งหรือไม่

    • การรองรับฟีด RSS

    • ข้อความ 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 ออกจากแหล่งข้อมูลที่ส่งในเนื้อหาคำขอ หากต้องการให้รายการเพลย์ลิสต์มีตำแหน่งที่เฉพาะเจาะจงในรายการ คุณจะต้องอัปเดตการตั้งค่าการจัดลำดับของเพลย์ลิสต์เป็นกำหนดเองก่อน ปรับการตั้งค่านี้ได้ในเครื่องมือจัดการวิดีโอของ YouTube
    forbidden (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 ซึ่งมีรหัสสถานะ HTTP 400

  • ขณะนี้ทรัพยากร 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 แสดงผลโค้ดตอบกลับ HTTP 204 สำหรับคำขอไปยังเมธอดเหล่านั้นที่สำเร็จ

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

อัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

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

อัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

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 จะระบุว่าวิดีโอที่อัปเดตหรือวิดีโอที่อัปโหลดใหม่เชื่อมโยงกับหมวดหมู่วิดีโอนั้นได้หรือไม่

  • เพิ่มตัวอย่างโค้ดสำหรับวิธีการต่อไปนี้แล้ว

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

  • เพิ่มตัวอย่างโค้ดสำหรับวิธีการต่อไปนี้แล้ว

    โปรดทราบว่าตัวอย่าง Python สำหรับเมธอด playlistItems.insert ก็ถูกนำออกด้วยเช่นกัน เนื่องจากตอนนี้เมธอด videos.rate จะจัดการฟังก์ชันการทำงานที่แสดงแทน

  • error documentation อธิบายข้อผิดพลาดเกี่ยวกับบริบทคำขอใหม่ต่อไปนี้ ซึ่งอาจเกิดขึ้นสำหรับเมธอด API ที่รองรับพารามิเตอร์คำขอ mine

    ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
    badRequest invalidMine ไม่สามารถใช้พารามิเตอร์ mine ในคำขอที่ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วเป็นพาร์ทเนอร์ YouTube คุณควรนำพารามิเตอร์ mine ออก ตรวจสอบสิทธิ์ในฐานะผู้ใช้ YouTube โดยนำพารามิเตอร์ onBehalfOfContentOwner ออก หรือดำเนินการในฐานะหนึ่งในแชแนลของพาร์ทเนอร์โดยการใส่พารามิเตอร์ onBehalfOfContentOwnerChannel หากมีสำหรับเมธอดที่เรียกใช้

8 สิงหาคม 2013

อัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

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

อัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

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 – พร็อพเพอร์ตี้ระบุชื่อของช่องที่ติดตาม

  • เพิ่มตัวอย่างโค้ดสำหรับวิธีการต่อไปนี้แล้ว

  • พารามิเตอร์ 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 สำหรับทรัพยากรต่อไปนี้แล้ว

    • activity – พร็อพเพอร์ตี้ระบุชื่อช่องที่รับผิดชอบกิจกรรม
    • search – พร็อพเพอร์ตี้ระบุชื่อของแชแนลที่เชื่อมโยงกับทรัพยากรที่ผลการค้นหาระบุ
    • video – พร็อพเพอร์ตี้ระบุชื่อของช่องที่อัปโหลดวิดีโอ

  • เมธอด 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

อัปเดตนี้มีการเปลี่ยนแปลงต่อไปนี้

  • ตัวอย่างโค้ดพร้อมให้บริการสำหรับเมธอดและภาษาที่แสดงในรายการด้านล่างแล้ว

  • แหล่งข้อมูล 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 เพื่อดึงรายการค่าที่ถูกต้อง