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

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

10 กรกฎาคม 2025

ตั้งแต่วันที่ 21 กรกฎาคม 2025 เป็นต้นไป YouTube จะปรับเนื้อหาที่แสดงโดยแผนภูมิ mostPopular ของเมธอด video.list ก่อนหน้านี้ ชาร์ต mostPopular จะแสดงวิดีโอที่แนะนำในรายการมาแรง ตอนนี้ชาร์ตmostPopularจะแสดงวิดีโอจากชาร์ตเพลง ภาพยนตร์ และเกมที่กำลังมาแรง การเปลี่ยนแปลง API นี้เกิดขึ้นพร้อมกับการเลิกใช้งานหน้ามาแรงของ YouTube

26 มีนาคม 2025

ตั้งแต่วันที่ 31 มีนาคม 2025 เป็นต้นไป YouTube จะเปลี่ยนวิธีนับยอดดู Shorts ในอดีต YouTube จะนับยอดดู Shorts เมื่อเล่นถึงระยะเวลาที่กำหนดเป็นวินาที ตอนนี้ระบบจะนับยอดดูเป็นจำนวนครั้งที่ Shorts เริ่มเล่นหรือเล่นซ้ำ โดยไม่มีการกำหนดเวลาในการรับชมขั้นต่ำ ดูข้อมูลเพิ่มเติม

ตั้งแต่วันที่ 31 มีนาคม 2025 เป็นต้นไป ช่องต่อไปนี้ใน Data API จะแสดงจำนวนยอดดูของ Shorts ตามการเปลี่ยนแปลงนี้

  • channels.statistics.viewCount
  • videos.statistics.viewCount

30 ตุลาคม 2024

ตอนนี้ API รองรับความสามารถในการระบุวิดีโอที่มีเนื้อหาดัดแปลงหรือ สังเคราะห์ (A/S) ที่ดูสมจริงแล้ว ดูข้อมูลเพิ่มเติมเกี่ยวกับ YouTube นโยบายที่เกี่ยวข้องกับเนื้อหา A/S

ตัวอย่างเนื้อหา A/S ได้แก่ วิดีโอที่มีลักษณะต่อไปนี้

  • ทำให้ดูเหมือนบุคคลที่มีตัวตนจริงพูดหรือกระทำบางอย่างที่บุคคลดังกล่าวไม่ได้พูดหรือกระทำ
  • ดัดแปลงฟุตเทจที่แสดงเหตุการณ์หรือสถานที่จริง
  • สร้างฉากที่ดูสมจริงซึ่งไม่ได้เกิดขึ้นจริง

หากต้องการระบุว่าวิดีโอมีเนื้อหา A/S หรือไม่ ให้ตั้งค่าพร็อพเพอร์ตี้ status.containsSyntheticMedia ตั้งค่าพร็อพเพอร์ตี้นี้ได้เมื่อเรียกใช้เมธอด videos.insert หรือ videos.update หากตั้งค่าไว้ ระบบจะแสดงพร็อพเพอร์ตี้ ในแหล่งข้อมูล video

30 เมษายน 2024

หมายเหตุ: นี่คือประกาศการเลิกใช้งาน

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

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

13 มีนาคม 2024

หมายเหตุ: นี่คือประกาศการเลิกใช้งาน

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

พารามิเตอร์ sync สำหรับเมธอด captions.insert และ captions.update เลิกใช้งานแล้ว YouTube จะหยุดรองรับพารามิเตอร์ ตั้งแต่วันที่ 12 เมษายน 2024

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

12 มีนาคม 2024

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

เราได้อัปเดตเอกสารประกอบสำหรับทรัพยากร captions เพื่อระบุว่าความยาวสูงสุดที่อนุญาตสำหรับฟิลด์ snippet.name คือ 150 อักขระ API จะแสดงข้อผิดพลาด nameTooLong หากชื่อแทร็กยาวกว่านั้น

7 มีนาคม 2024

หมายเหตุ: นี่คือประกาศการเลิกใช้งาน

เลิกใช้งานพร็อพเพอร์ตี้แหล่งข้อมูล channel brandingSettings.channel.moderateComments แล้ว YouTube จะหยุด รองรับพารามิเตอร์ดังกล่าวตั้งแต่วันที่ 7 มีนาคม 2024

31 มกราคม 2024

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

channels.list วิธีการใหม่ของ forHandle พารามิเตอร์ช่วยให้คุณดึงข้อมูลเกี่ยวกับช่องได้โดยการระบุแฮนเดิล YouTube ของช่อง

9 พฤศจิกายน 2023

เราได้นำการอ้างอิงทั้งหมดไปยังทรัพยากร videoId ภายใต้ Comments ออกแล้ว เนื่องจากระบบไม่ได้แสดงผลทรัพยากร videoId โดยใช้การเรียก API

12 กันยายน 2023

หมายเหตุ: นี่คือประกาศการเลิกใช้งาน

เราเลิกใช้งานเมธอด comments.markAsSpam มาหลายปีแล้ว YouTube ไม่รองรับวิธีการนี้อยู่แล้วและจะไม่รองรับผ่าน API อีกต่อไป

เราได้เพิ่มการแจ้งเตือนเรื่องการเลิกใช้งานลงในเอกสารทั้งหมดที่อ้างอิงถึงเมธอด comments.markAsSpam

22 สิงหาคม 2023

ตอนนี้เมธอด search.list รองรับพารามิเตอร์ videoPaidProductPlacement แล้ว พารามิเตอร์นี้ช่วยให้คุณกรองผลการค้นหาเพื่อรวมเฉพาะวิดีโอที่ครีเอเตอร์ระบุว่ามีการโปรโมตแบบชำระเงิน

18 สิงหาคม 2023

คำจำกัดความของvideoแหล่งข้อมูล liveStreamingDetails.concurrentViewers ได้รับการอัปเดตเพื่อระบุว่าจำนวนผู้ชมพร้อมกันที่ YouTube Data API แสดงผลอาจ แตกต่างจากจำนวนผู้ชมพร้อมกันที่ประมวลผลแล้วและไม่มีสแปมซึ่งดูได้ผ่านข้อมูลวิเคราะห์ YouTube ศูนย์ช่วยเหลือของ 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 เป็นสตริงจาก unsigned long

5 สิงหาคม 2022

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

นับจากนี้จนถึงวันที่ 1 ธันวาคม 2022 วิธีการ captions.list, captions.update, captions.download และ captions.delete จะรองรับทั้งรหัสแทร็กคำบรรยายแทนเสียงแบบเก่าและแบบใหม่ อย่างไรก็ตาม ตั้งแต่วันที่ 1 ธันวาคม 2022 เป็นต้นไป YouTube จะหยุดรองรับรหัสแทร็กคำบรรยายแทนเสียงแบบเดิม ในเวลานั้น การเรียกใช้เมธอด API ใดๆ เหล่านั้น ด้วยรหัสแทร็กคำบรรยายแทนเสียงรุ่นเก่าจะทำให้เกิดข้อผิดพลาด captionNotFound

คุณควรวางแผนที่จะแทนที่ข้อมูลแทร็กคำบรรยายแทนเสียงที่จัดเก็บไว้ทั้งหมด อย่างสมบูรณ์ตั้งแต่ตอนนี้จนถึงวันที่ 1 ธันวาคม 2022 เพื่อเตรียมพร้อมรับการเปลี่ยนแปลงนี้ ซึ่งหมายความว่าสำหรับวิดีโอใดก็ตามที่คุณจัดเก็บข้อมูลแทร็กคำบรรยายแทนเสียง คุณควรลบข้อมูลที่จัดเก็บไว้ในปัจจุบัน จากนั้นเรียกใช้เมธอด captions.list เพื่อดึงข้อมูล ชุดแทร็กคำบรรยายแทนเสียงปัจจุบันของวิดีโอ และจัดเก็บข้อมูลในการตอบกลับของ API ตามปกติ

12 กรกฎาคม 2022

เราได้อัปเดตข้อกำหนดในการให้บริการของบริการ API ของ YouTube โปรดดูข้อมูลเพิ่มเติมที่ข้อกำหนดในการให้บริการของ API ของ YouTube - ประวัติการแก้ไข

27 เมษายน 2022

videos.insert คำอธิบายเมธอดได้รับการอัปเดตเพื่อระบุว่าขนาดไฟล์สูงสุดสำหรับวิดีโอที่อัปโหลดเพิ่มขึ้นจาก 128 GB เป็น 256 GB

8 เมษายน 2022

เราได้อัปเดตทั้งคำจำกัดความของเมธอด subscriptions.list myRecentSubscribers และพารามิเตอร์ mySubscribers เพื่อระบุว่า API อาจจำกัดจำนวนผู้ติดตามสูงสุดที่แสดง การเปลี่ยนแปลงนี้เป็นการแก้ไขเอกสารประกอบ ไม่ใช่การเปลี่ยนแปลงลักษณะการทำงานของ API

15 ธันวาคม 2021

ตามที่ประกาศเมื่อวันที่ 18 พฤศจิกายน 2021 ควบคู่ไปกับการเปลี่ยนแปลงเพื่อทำให้จำนวนการไม่ชอบวิดีโอเป็นแบบส่วนตัวในแพลตฟอร์ม YouTube ทั้งหมด ตอนนี้พร็อพเพอร์ตี้ statistics.dislikeCount ของทรัพยากร video เป็นแบบส่วนตัวแล้ว

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงนี้ได้ในบล็อกอย่างเป็นทางการของ YouTube

18 พฤศจิกายน 2021

ควบคู่ไปกับการเปลี่ยนแปลงเพื่อ ทำให้จำนวนการกดไม่ชอบวิดีโอเป็นแบบส่วนตัวทั่วทั้งแพลตฟอร์ม YouTube เราจะทำให้พร็อพเพอร์ตี้ video ของทรัพยากร statistics.dislikeCount เป็นแบบส่วนตัวตั้งแต่วันที่ 13 ธันวาคม 2021 ซึ่งหมายความว่าพร็อพเพอร์ตี้นี้จะรวมอยู่ในการตอบกลับ API จากปลายทาง videos.list ก็ต่อเมื่อเจ้าของวิดีโอได้ตรวจสอบสิทธิ์คำขอ API แล้วเท่านั้น

โดยปลายทาง videos.rate จะไม่ได้รับผลกระทบ จากการเปลี่ยนแปลงนี้

นักพัฒนาแอปที่ไม่ได้แสดงจำนวนไม่ชอบต่อสาธารณะและยังคงต้องการจำนวนไม่ชอบสำหรับไคลเอ็นต์ API ของตน สามารถสมัครเพื่อให้อยู่ในรายการที่อนุญาตสำหรับการยกเว้นได้ หากต้องการขอรับการยกเว้น คุณต้องกรอกแบบฟอร์มใบสมัครนี้

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงนี้ได้ในบล็อกอย่างเป็นทางการของ YouTube

2 กรกฎาคม 2021

หมายเหตุ: นี่คือประกาศการเลิกใช้งาน

เราเลิกใช้งานปลายทาง commentThreads.update แล้ว และไม่รองรับอีกต่อไป โดยอุปกรณ์ปลายทางนี้จะทำซ้ำฟังก์ชันที่มีให้ใช้งานผ่านอุปกรณ์ปลายทาง API อื่นๆ แต่คุณสามารถ โทรหาcomments.update

method และหากโค้ดของคุณต้องใช้commentThreadsรีซอร์ส ให้โทรครั้งที่ 2 ไปยังเมธอด commentThreads.list

1 กรกฎาคม 2021

นักพัฒนาแอปทุกรายที่ใช้บริการ API ของ YouTube ต้องทำการตรวจสอบการปฏิบัติตามข้อกำหนด API ให้เสร็จสมบูรณ์เพื่อรับการจัดสรรโควต้ามากกว่าค่าเริ่มต้นที่ 10,000 หน่วย ปัจจุบันทั้งกระบวนการตรวจสอบการปฏิบัติตามข้อกำหนดและการขอการจัดสรรหน่วยโควต้าเพิ่มเติมดำเนินการโดยนักพัฒนาซอฟต์แวร์ที่กรอกและส่งแบบฟอร์มบริการ API ของ YouTube - การตรวจสอบและการขยายโควต้า

เราจึงเพิ่มแบบฟอร์มใหม่ 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 ก่อนที่ผู้ใช้จะโต้ตอบกับเพลเยอร์ได้โดยตั้งค่าการเล่นอัตโนมัติเป็น "false"
  • ส่วนที่ III.E.4.j ใหม่เกี่ยวข้อง กับการตรวจสอบสถานะสร้างมาเพื่อเด็ก (MFK) ของเนื้อหาก่อนที่จะฝังเนื้อหาดังกล่าวในเว็บไซต์และ แอปของคุณ คุณมีหน้าที่รับผิดชอบในการทราบว่าวิดีโอที่คุณฝังในไคลเอ็นต์ API สร้างมาเพื่อเด็กหรือไม่ และต้องจัดการข้อมูลที่รวบรวมจากเพลเยอร์ที่ฝังตามนั้น ดังนั้น คุณต้อง ตรวจสอบสถานะของเนื้อหาโดยใช้บริการ YouTube Data API ก่อนที่จะฝังเนื้อหาดังกล่าวในไคลเอ็นต์ API ผ่านโปรแกรมเล่นแบบฝังของ YouTube

คำแนะนำการค้นหาสถานะ "สร้างมาเพื่อเด็ก" ของวิดีโอ ใหม่จะอธิบายวิธีค้นหาสถานะ MFK ของวิดีโอโดยใช้ บริการ YouTube Data API

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

8 ตุลาคม 2020

การอัปเดตนี้ครอบคลุมการเปลี่ยนแปลงเล็กๆ 3 อย่างที่เกี่ยวข้องกับ แหล่งข้อมูล channel ดังนี้

  • ออบเจ็กต์ snippet.thumbnails ซึ่งระบุรูปภาพปกวิดีโอของช่องอาจว่างเปล่าสำหรับช่องที่สร้างขึ้นใหม่ และอาจใช้เวลาถึง 1 วันในการเติมข้อมูล
  • พร็อพเพอร์ตี้ statistics.videoCount จะแสดงจำนวนวิดีโอสาธารณะของช่องเท่านั้น แม้แต่เจ้าของช่องเองก็ตาม ลักษณะการทำงานนี้ สอดคล้องกับจำนวนที่แสดงในเว็บไซต์ YouTube
  • ระบบอาจตัดคีย์เวิร์ดของแชแนลที่ระบุในพร็อพเพอร์ตี้ brandingSettings.channel.keywords หากมีความยาวเกินความยาวสูงสุดที่อนุญาต 500 อักขระ หรือหากมีเครื่องหมายคำพูดที่ไม่ได้หลีกเลี่ยง (") โปรดทราบว่าขีดจำกัด 500 อักขระ ไม่ใช่ขีดจำกัดต่อคีย์เวิร์ด แต่เป็นขีดจำกัดความยาวรวมของคีย์เวิร์ดทั้งหมด ลักษณะการทำงานนี้สอดคล้องกับลักษณะการทำงานบนเว็บไซต์ YouTube

9 กันยายน 2020

หมายเหตุ: นี่คือประกาศการเลิกใช้งาน

การอัปเดตนี้ครอบคลุมการเปลี่ยนแปลง API ต่อไปนี้ การเปลี่ยนแปลงทั้งหมดจะมีผลตั้งแต่วันที่ 9 กันยายน 2020 เป็นต้นไป ซึ่งเป็นวันที่ประกาศนี้ ด้วยเหตุนี้ นักพัฒนาแอปจึงไม่ควร ใช้ฟีเจอร์ API ที่ระบุไว้ด้านล่างอีกต่อไป

  • เราเลิกใช้งานทรัพยากร API, เมธอด, พารามิเตอร์ และพร็อพเพอร์ตี้ทรัพยากรต่อไปนี้ โดยทันที และจะหยุดทำงานตั้งแต่วันที่ประกาศนี้เป็นต้นไป
    • พร็อพเพอร์ตี้ของchannelทรัพยากรต่อไปนี้
      • พร็อพเพอร์ตี้ statistics.commentCount
      • ออบเจ็กต์ brandingSettings.image และพร็อพเพอร์ตี้ย่อยทั้งหมดของออบเจ็กต์
      • brandingSettings.hintsรายการและพร็อพเพอร์ตี้ย่อยทั้งหมด
    • พารามิเตอร์ตัวกรองของเมธอด channels.list categoryId
    • guideCategories resource และเมธอด 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 จะใช้งานได้นานขึ้นเล็กน้อย

เราขอแนะนำให้นักพัฒนาแอปทุกรายทำการตรวจสอบการปฏิบัติตามข้อกำหนดสำหรับโปรเจ็กต์ของตนให้เสร็จสมบูรณ์ เพื่อให้มั่นใจว่าจะเข้าถึงบริการ API ของ YouTube ได้อย่างต่อเนื่อง

รายการประวัติการแก้ไขนี้เผยแพร่ครั้งแรกเมื่อวันที่ 20 กรกฎาคม 2020

28 กรกฎาคม 2020

วิดีโอทั้งหมดที่อัปโหลดผ่านปลายทาง videos.insert จากโปรเจ็กต์ API ที่ไม่ได้รับการยืนยันซึ่งสร้างขึ้นหลังจากวันที่ 28 กรกฎาคม 2020 จะถูกจำกัดให้ ดูได้เฉพาะในโหมดส่วนตัว หากต้องการยกเลิกข้อจำกัดนี้ แต่ละโปรเจ็กต์ต้องเข้ารับการตรวจสอบเพื่อยืนยันการปฏิบัติตามข้อกำหนดในการให้บริการ

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

โปรเจ็กต์ API ที่สร้างก่อนวันที่ 28 กรกฎาคม 2020 จะ ไม่ได้รับผลกระทบจากการเปลี่ยนแปลงนี้ในขณะนี้ อย่างไรก็ตาม เราขอแนะนำให้นักพัฒนาแอปทุกรายทำการตรวจสอบการปฏิบัติตามข้อกำหนดสำหรับโปรเจ็กต์ของตนเพื่อให้เข้าถึงบริการ API ของ YouTube ได้อย่างต่อเนื่อง

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

นอกจากนี้ เรายังได้ปรับปรุงข้อกำหนดในการให้บริการของบริการ YouTube API และนโยบายสำหรับนักพัฒนาซอฟต์แวร์ด้วย โปรดดูข้อมูลเพิ่มเติมที่ข้อกำหนดในการให้บริการของ API ของ YouTube - ประวัติการแก้ไข การเปลี่ยนแปลงข้อกำหนดในการให้บริการของบริการ YouTube API และ นโยบายสำหรับนักพัฒนาซอฟต์แวร์จะมีผลในวันที่ 10 มกราคม 2020 ตามเวลาแปซิฟิก

10 กันยายน 2019

เราได้อัปเดตเอกสารอ้างอิง API เพื่อให้สอดคล้องกับการเปลี่ยนแปลงวิธีรายงานจำนวนผู้ติดตาม บน YouTube และในการตอบกลับของ API การเปลี่ยนแปลงนี้จะส่งผลให้ ระบบจะปัดเศษจำนวนผู้ติดตามที่บริการ YouTube Data API แสดงลงให้เหลือตัวเลขที่มีนัยสำคัญ 3 ตัว สำหรับจำนวนผู้ติดตามที่มากกว่า 1,000 คน การเปลี่ยนแปลงนี้ส่งผลต่อพร็อพเพอร์ตี้ channel ของแหล่งข้อมูล statistics.subscriberCount

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

เช่น หากช่องมีผู้ติดตาม 123,456 คน พร็อพเพอร์ตี้ statistics.subscriberCount จะมีค่า 123000 ตารางด้านล่างแสดงตัวอย่างวิธีปัดเศษจำนวนผู้ติดตามในการตอบกลับของ API และ การย่อในอินเทอร์เฟซผู้ใช้ YouTube อื่นๆ ที่แสดงต่อสาธารณะ

ตัวอย่างจำนวนผู้ติดตาม YouTube Data API UI ของ YouTube ที่มองเห็นได้แบบสาธารณะ
1,234 1230 1.23 พัน
12,345 12300 1.23 หมื่น
123,456 123000 1.23 แสน
1,234,567 1230000 1.23 ล้าน
12,345,678 12300000 12.3 ล้าน
123,456,789 123000000 123 ล้าน

4 เมษายน 2019

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

  • เราได้อัปเดตเอกสารอ้างอิง API เพื่ออธิบายกรณีการใช้งานทั่วไปของแต่ละเมธอดให้ดียิ่งขึ้น และเพื่อจัดหาตัวอย่างโค้ดแบบไดนามิกคุณภาพสูงผ่านวิดเจ็ต API Explorer ดูตัวอย่างได้ในเอกสารประกอบของเมธอด channels.list ตอนนี้หน้าเว็บที่อธิบายเมธอด API มีองค์ประกอบใหม่ 2 อย่าง ดังนี้

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

    • ส่วนUse Case ทั่วไปจะอธิบาย Use Case ทั่วไปอย่างน้อย 1 รายการสำหรับเมธอดที่อธิบายไว้ในหน้าเว็บ เช่น คุณสามารถเรียกใช้เมธอด channels.list เพื่อดึงข้อมูลเกี่ยวกับช่องที่เฉพาะเจาะจง หรือดึงข้อมูลเกี่ยวกับช่องของผู้ใช้ปัจจุบัน

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

    ปัจจุบันตัวอย่างโค้ดรองรับ 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

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

9 กรกฎาคม 2018

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

  • คำจำกัดความของพร็อพเพอร์ตี้ snippet.thumbnails ของchannelทรัพยากรได้รับการอัปเดตเพื่อระบุว่าเมื่อแสดงภาพขนาดย่อในแอปพลิเคชัน โค้ดควรใช้ URL ของรูปภาพตรงตามที่แสดงในคำตอบของ API เช่น แอปพลิเคชันของคุณไม่ควรใช้โดเมน http แทนโดเมน https ใน URL ที่แสดงผลในคำตอบของ API

    ตั้งแต่เดือนกรกฎาคม 2018 เป็นต้นไป URL ของภาพปกช่องจะใช้ได้ในโดเมน https เท่านั้น ซึ่งเป็นลักษณะที่ URL ปรากฏในการตอบกลับของ API หลังจากนั้น คุณอาจเห็นรูปภาพที่ไม่สมบูรณ์ในแอปพลิเคชันหากแอปพยายามโหลดรูปภาพ YouTube จากโดเมน http

  • หมายเหตุ: นี่คือประกาศการเลิกใช้งาน

    เลิกใช้งานพร็อพเพอร์ตี้ recordingDetails.location.altitude ของทรัพยากร video แล้ว ไม่มีการรับประกันว่าวิดีโอจะแสดงค่าสำหรับพร็อพเพอร์ตี้นี้ ในทํานองเดียวกัน แม้ว่าคําขอ API จะพยายามตั้งค่าสําหรับพร็อพเพอร์ตี้นั้น แต่ก็เป็นไปได้ที่ระบบจะไม่จัดเก็บข้อมูลขาเข้า

22 มิถุนายน 2018

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

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

    หมายเหตุ: เครื่องมือนี้ยังฝังอยู่ในเอกสารประกอบข้อมูลอ้างอิง API สำหรับเมธอด API (ตัวอย่าง) ด้วย

1 มิถุนายน 2017

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

  • หมายเหตุ: นี่คือประกาศการเลิกใช้งาน

    เราจะเลิกใช้งานพร็อพเพอร์ตี้ทรัพยากร video ต่อไปนี้ แม้ว่าระบบจะรองรับพร็อพเพอร์ตี้จนถึงวันที่ 1 ธันวาคม 2017 แต่ก็ไม่รับประกันว่าวิดีโอจะยังคงแสดงค่าสำหรับพร็อพเพอร์ตี้เหล่านั้นจนถึงเวลานั้น ในทํานองเดียวกัน คําขอ videos.insert และ videos.update ที่ตั้งค่าพร็อพเพอร์ตีเหล่านั้นจะไม่ทําให้เกิดข้อผิดพลาดก่อนวันที่ดังกล่าว แต่เป็นไปได้ว่าระบบจะไม่จัดเก็บข้อมูลขาเข้า

17 พฤษภาคม 2017

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

  • เราได้อัปเดตเอกสารอ้างอิง API เพื่อให้ข้อมูลโค้ดมีความแพร่หลายและมีการโต้ตอบมากขึ้น ตอนนี้หน้าเว็บที่อธิบายเมธอด API เช่น channels.list หรือ videos.rate มีเครื่องมือแบบอินเทอร์แอกทีฟที่ให้คุณดูและปรับแต่งข้อมูลโค้ดใน Java, JavaScript, PHP, Python, Ruby, Apps Script และ Go ได้แล้ว

    สําหรับแต่ละวิธี เครื่องมือจะแสดงข้อมูลโค้ดสําหรับ Use Case อย่างน้อย 1 รายการ และแต่ละ Use Case จะอธิบายวิธีกําหนดวิธีทั่วไป เช่น คุณเรียกใช้เมธอด channels.list เพื่อดึงข้อมูลเกี่ยวกับช่องที่เฉพาะเจาะจงหรือเกี่ยวกับช่องของผู้ใช้ปัจจุบันได้

    คุณยังโต้ตอบกับตัวอย่างโค้ดได้ด้วย โดยทำดังนี้

    • แก้ไขค่าพารามิเตอร์และพร็อพเพอร์ตี้ แล้วข้อมูลโค้ดจะอัปเดตแบบไดนามิกเพื่อให้ตรงกับค่าที่คุณระบุ

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

    • ดำเนินการคำขอโดยคลิกปุ่ม (หากต้องการดำเนินการคำขอ คุณต้องให้สิทธิ์เครื่องมือในการเรียก API ในนามของคุณ)

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

  • นอกจากนี้ เรายังได้อัปเดตเครื่องมือข้อมูลโค้ด Data API ด้วย UI ใหม่ที่มีฟีเจอร์ทั้งหมดแบบเดียวกับที่อธิบายไว้ข้างต้น ฟีเจอร์ใหม่ที่สำคัญซึ่งพร้อมใช้งานในหน้านี้มีดังนี้

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

27 เมษายน 2017

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

  • คู่มือการเริ่มต้นใช้งานฉบับใหม่จะอธิบายวิธีตั้งค่าแอปพลิเคชันอย่างง่ายที่ส่งคำขอไปยัง YouTube Data API ขณะนี้มีคำแนะนำสำหรับ Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python และ Ruby

30 มีนาคม 2017

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

  • channelพร็อพเพอร์ตี้ topicDetails.topicCategories[] ใหม่ของแหล่งข้อมูลมีรายการ URL ของ Wikipedia ที่อธิบายเนื้อหาของช่อง URL ตรงกับรหัสหัวข้อที่แสดงผลในพร็อพเพอร์ตี้ topicDetails.topicIds[] ของทรัพยากร
  • พร็อพเพอร์ตี้ contentDetails.videoPublishedAt ใหม่ของแหล่งข้อมูล playlistItem จะระบุเวลาที่เผยแพร่วิดีโอไปยัง YouTube ทรัพยากรมีพร็อพเพอร์ตี้ snippet.publishedAt อยู่แล้ว ซึ่งระบุเวลาที่เพิ่มรายการลงในเพลย์ลิสต์
  • ตอนนี้ทรัพยากร video จะแสดงพร็อพเพอร์ตี้ topicDetails.topicCategories[] ซึ่งมีรายการ URL ของ Wikipedia ที่อธิบายเนื้อหาของวิดีโอ เช่นเดียวกับทรัพยากร channel สำหรับทรัพยากร video URL จะตรงกับรหัสหัวข้อที่ส่งคืนในพร็อพเพอร์ตี้ topicDetails.relevantTopicIds[] ของทรัพยากร
  • contentDetails.contentRating.mpaatRating พร็อพเพอร์ตี้ใหม่ของทรัพยากร video จะระบุการจัดประเภทที่สมาคมภาพยนตร์แห่งอเมริกา (Motion Picture Association of America) มอบให้แก่ตัวอย่างหรือตัวอย่างภาพยนตร์

27 กุมภาพันธ์ 2017

ตามที่ประกาศเมื่อวันที่ 11 สิงหาคม 2016 YouTube ได้เปลี่ยนรายการรหัสหัวข้อที่รองรับเป็นรายการที่คัดสรรแล้ว รายการรหัสหัวข้อที่รองรับทั้งหมดจะรวมอยู่ในพร็อพเพอร์ตี้ topicDetails สำหรับทรัพยากร channel และ video รวมถึงในพารามิเตอร์ topicId ของเมธอด search.list

โปรดทราบว่ารายการที่ดูแลจัดการมีการเปลี่ยนแปลงหลายอย่างดังนี้

  • เราได้เพิ่มหัวข้อต่อไปนี้เป็นหัวข้อย่อยของ Society
    ชื่อรหัสหัวข้อ
    ธุรกิจ/m/09s1f
    สุขภาพ/m/0kt51
    การทหาร/m/01h6rj
    การเมือง/m/05qt0
    ศาสนา/m/06bvp
  • ระบบได้นำAnimated cartoonหัวข้อซึ่งก่อนหน้านี้เป็นหัวข้อย่อยของEntertainmentออกแล้ว
  • ระบบได้นำChildren's musicหัวข้อซึ่งก่อนหน้านี้เป็นหัวข้อย่อยของMusicออกแล้ว

การเปลี่ยนแปลงนี้ส่งผลให้ระบบจะแสดงหัวข้อที่เกี่ยวข้องกับวิดีโอในค่าพร็อพเพอร์ตี้ topicDetails.relevantTopicIds[] ของทรัพยากร video เสมอ

29 พฤศจิกายน 2016

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

  • เราจะทำการเปลี่ยนแปลงเล็กน้อย 3 รายการในรายการรหัสหัวข้อที่จะรองรับตั้งแต่วันที่ 10 กุมภาพันธ์ 2017 ดังนี้

    • ตอนนี้หมวดหมู่ Professional wrestling ซึ่งก่อนหน้านี้เป็นหมวดหมู่ย่อยของหมวดหมู่ Sports ได้กลายเป็นหมวดหมู่ย่อยของ Entertainment แล้ว
    • หมวดหมู่ TV shows ซึ่งเป็นหมวดหมู่ย่อยของ Entertainment เป็นหมวดหมู่ใหม่
    • ระบบได้นำหมวดหมู่ Health ซึ่งก่อนหน้านี้เป็นหมวดหมู่ย่อยของ Lifestyle ออกแล้ว

    โปรดทราบว่ามีหมวดหมู่หลักอยู่ 5 หมวดหมู่ (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 ความกว้างของเพลเยอร์จะเป็น 640 พิกเซล

      พารามิเตอร์ใหม่ช่วยให้คุณระบุได้ว่าโค้ดฝังควรใช้ความสูงและ/หรือความกว้างที่เหมาะสมกับเลย์เอาต์แอปพลิเคชันแทนที่จะใช้มิติข้อมูลเริ่มต้น เซิร์ฟเวอร์ API จะปรับขนาดเพลเยอร์ตามความเหมาะสมเพื่อให้มั่นใจว่าเพลเยอร์ที่ฝังจะไม่มีแถบสีดำล้อมรอบวิดีโอ โปรดทราบว่าพารามิเตอร์ทั้ง 2 รายการจะระบุขนาดสูงสุดของเพลเยอร์ที่ฝัง ดังนั้น หากระบุทั้ง 2 พารามิเตอร์ ขนาดของมิติข้อมูลหนึ่งอาจยังคงเล็กกว่าจำนวนสูงสุดที่อนุญาตสำหรับมิติข้อมูลนั้น

      เช่น สมมติว่าวิดีโอมีสัดส่วนภาพ 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 คำอธิบายเมธอดได้รับการอัปเดตเพื่อระบุว่าขนาดไฟล์สูงสุดสำหรับวิดีโอที่อัปโหลดเพิ่มขึ้นจาก 64 GB เป็น 128 GB

  • ข้อผิดพลาดใหม่และที่อัปเดต

    • 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 ดังนี้

    • พารามิเตอร์ activities.list ของเมธอด home ช่วยให้ผู้ใช้ที่ได้รับอนุญาตดึงฟีดกิจกรรมที่จะแสดงในหน้าแรกของ 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 รายการนี้หลังจากการเลิกใช้งาน เราจึงได้นำพร็อพเพอร์ตี้ทั้ง 2 รายการออกจากเอกสารประกอบของทรัพยากรที่เกี่ยวข้อง

31 พฤษภาคม 2016

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

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

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

  • เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้ snippet.thumbnails.(key) สำหรับทรัพยากร activity, playlistItem, playlist, search result, thumbnail และ video เพื่อให้ทราบว่าวิดีโอบางรายการมีภาพปกเพิ่มเติมในขนาดอื่นๆ

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

  • ตอนนี้เมธอด videos.list จะแสดงข้อผิดพลาด forbidden (403) เมื่อคำขอที่ไม่ได้รับอนุญาตอย่างถูกต้องพยายามเรียกส่วน fileDetails, processingDetails หรือ suggestions ของทรัพยากร video โดยส่วนดังกล่าวจะพร้อมให้บริการแก่เจ้าของวิดีโอเท่านั้น

17 พฤษภาคม 2016

เครื่องมือข้อมูลโค้ด Data API ใหม่มีข้อมูลโค้ดสั้นๆ สำหรับกรณีการใช้งาน YouTube Data API ทั่วไป ขณะนี้ข้อมูลโค้ดพร้อมใช้งานสำหรับเมธอด API แบบอ่านอย่างเดียวทั้งหมดใน Apps Script, Go, JavaScript, PHP, Python และ Ruby

สําหรับแต่ละวิธี เครื่องมือจะแสดงตัวอย่างโค้ดสําหรับกรณีการใช้งานอย่างน้อย 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 Developers Console ซึ่งคุณจะดูโควต้าจริงและการใช้โควต้าได้

16 มีนาคม 2016

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

  • การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่

    • channelBannerเอกสารประกอบเกี่ยวกับแหล่งข้อมูลได้รับการอัปเดตเพื่อระบุว่าขนาดที่แนะนำสำหรับรูปภาพแบนเนอร์ของช่องที่อัปโหลดคือ 2560x1440 พิกเซล ขนาดขั้นต่ำ (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 และต้องได้รับความยินยอมจากผู้ใช้ปลายทางใน EU ดังนั้น คุณต้องปฏิบัติตามนโยบายความยินยอมของผู้ใช้ EU สำหรับผู้ใช้ปลายทางในสหภาพยุโรป เราได้เพิ่มประกาศเกี่ยวกับข้อกำหนดนี้ในข้อกำหนดในการให้บริการของ YouTube API

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 classification cinematographique ของฝรั่งเศส พร็อพเพอร์ตี้นี้จะแทนที่พร็อพเพอร์ตี้ contentDetails.contentRating.fmocRating ซึ่งตอนนี้เลิกใช้งานแล้ว

    • คำจำกัดความของ channel ของbrandingSettings.channel.keywordsได้รับการอัปเดตเพื่อให้แสดงอย่างถูกต้องว่าค่าพร็อพเพอร์ตี้มีรายการสตริงที่คั่นด้วยช่องว่าง ไม่ใช่รายการที่คั่นด้วยคอมมาตามที่ระบุไว้ก่อนหน้านี้ การอัปเดตนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานของ 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 ตามกำหนดการที่วางไว้ นอกจากนี้ คู่มือการย้ายข้อมูลยังอธิบายฟีเจอร์เหล่านี้ทั้งหมดด้วย

  • การอัปเดตแหล่งข้อมูลและวิธีการที่มีอยู่

    • search.list พารามิเตอร์ตัวกรองใหม่ของเมธอด forDeveloper จะจำกัดการค้นหาให้ดึงเฉพาะวิดีโอที่อัปโหลดผ่านแอปพลิเคชันหรือเว็บไซต์ของนักพัฒนาแอปเท่านั้น คุณใช้พารามิเตอร์ forDeveloper ร่วมกับพารามิเตอร์การค้นหาที่ไม่บังคับ เช่น พารามิเตอร์ q ได้

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

      เมื่อคำขอค้นหาตั้งค่าพารามิเตอร์ forDeveloper เป็น true ในภายหลัง เซิร์ฟเวอร์ API จะใช้ข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอเพื่อระบุนักพัฒนาซอฟต์แวร์ ดังนั้น นักพัฒนาแอปจึงจำกัดผลการค้นหาให้แสดงเฉพาะวิดีโอที่อัปโหลดผ่านแอปหรือเว็บไซต์ของนักพัฒนาแอปเองได้ แต่จะจำกัดวิดีโอที่อัปโหลดผ่านแอปหรือเว็บไซต์อื่นๆ ไม่ได้

      ฟีเจอร์ใหม่นี้มีฟังก์ชันการทำงานที่คล้ายกับฟังก์ชันการทำงานของแท็กสำหรับนักพัฒนาซอฟต์แวร์ที่ API เวอร์ชัน 2 รองรับ แม้ว่าจะไม่เหมือนกันก็ตาม

    • channelพร็อพเพอร์ตี้ใหม่ของทรัพยากรsnippet.countryช่วยให้เจ้าของช่องเชื่อมโยงช่องของตนกับประเทศใดประเทศหนึ่งได้

      หมายเหตุ: หากต้องการตั้งค่าพร็อพเพอร์ตี้ 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 v2 ไม่รองรับ แต่รองรับใน API v3 ซึ่งได้แก่

    • การดึงข้อมูลความคิดเห็นเกี่ยวกับช่อง
    • ดึงข้อมูลชุดความคิดเห็นทั้งหมดที่เกี่ยวข้องกับช่อง ซึ่งหมายความว่าการตอบกลับของ API อาจมีทั้งความคิดเห็นเกี่ยวกับช่องหรือวิดีโอใดๆ ของช่อง
    • การอัปเดตข้อความของความคิดเห็น
    • การทำเครื่องหมายความคิดเห็นว่าเป็นสแปม
    • การตั้งค่าสถานะการดูแลความคิดเห็น

  • เราได้อัปเดตคำแนะนำการสมัครรับการแจ้งเตือนแบบพุชเพื่อให้สอดคล้องกับข้อเท็จจริงที่ว่าระบบจะพุชการแจ้งเตือนไปยังฮับ 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 – ลบความคิดเห็น

    โปรดทราบว่าการเรียกใช้เมธอด comments.insert, comments.update, comments.markAsSpam, comments.setModerationStatus, comments.delete, commentThreads.insert และ commentThreads.update ต้องใช้https://www.googleapis.com/auth/youtube.force-sslขอบเขตใหม่ของ API ซึ่งอธิบายไว้ในประวัติการแก้ไขวันที่ 2 เมษายน 2015

  • คำแนะนำการสมัครรับการแจ้งเตือนแบบพุชฉบับใหม่จะอธิบายการรองรับการแจ้งเตือนแบบพุชใหม่ของ 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 เพียง 1 รายการเท่านั้น

    API รองรับวิธีการในการแสดง แทรก อัปเดต ดาวน์โหลด และลบแทร็กคำบรรยายแทนเสียง

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

  • 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 scope จะไม่จำเป็นต้องใช้การเชื่อมต่อ SSL แต่จริงๆ แล้วไม่มีวิธีอื่นในการส่งคำขอ API

    ต้องใช้ขอบเขตใหม่สำหรับการเรียกใช้วิธีการทั้งหมดของทรัพยากร caption

11 มีนาคม 2015

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

  • คำแนะนำในการย้ายข้อมูล YouTube Data API (v3) มีแท็บใหม่ชื่อฟีเจอร์ใหม่ใน v3 API ซึ่งแสดงรายการฟีเจอร์ที่ v3 API รองรับและ v2 API ไม่รองรับ ก่อนหน้านี้ฟีเจอร์เดียวกันนี้จะแสดงอยู่ในแท็บอื่นๆ ในคำแนะนำ และยังคงแสดงอยู่ ตัวอย่างเช่น ฟีเจอร์ใหม่ที่อธิบายวิธีอัปเดตข้อมูลแคมเปญโปรโมตในวิดีโอของช่องจะแสดงอยู่ในแท็บช่อง (โปรไฟล์) ด้วย

  • เราได้อัปเดตคู่มือการย้ายข้อมูล YouTube Data API (v3) เพื่อระบุว่า API v3 จะรองรับฟีเจอร์ API v2 ต่อไปนี้

  • เราได้อัปเดตคำแนะนำในการย้ายข้อมูล YouTube Data API (v3) เพื่อระบุว่า API เวอร์ชัน 3 จะไม่รองรับฟีเจอร์ API เวอร์ชัน 2 ต่อไปนี้

    • ดึงข้อมูลวิดีโอแนะนำ - API เวอร์ชัน 3 จะไม่ดึงข้อมูลรายการที่มีเฉพาะวิดีโอที่แนะนำสำหรับผู้ใช้ API ปัจจุบัน อย่างไรก็ตาม คุณสามารถใช้ API เวอร์ชัน 3 เพื่อค้นหาวิดีโอแนะนำได้โดยการเรียกใช้เมธอด activities.list และตั้งค่าพารามิเตอร์ home เป็น true

      ในคำตอบของ API แหล่งข้อมูลจะสอดคล้องกับวิดีโอที่แนะนำหากค่าของพร็อพเพอร์ตี้ snippet.type เป็น recommendation ในกรณีดังกล่าว พร็อพเพอร์ตี้ contentDetails.recommendation.reason และ contentDetails.recommendation.seedResourceId จะมีข้อมูลเกี่ยวกับเหตุผลที่ระบบแนะนำวิดีโอ โปรดทราบว่าเราไม่รับประกันว่าการตอบกลับจะมีวิดีโอแนะนำตามจำนวนที่เฉพาะเจาะจง

    • ดึงข้อมูลคำแนะนำช่อง

    • ดึงข้อมูลวิดีโอจากการติดตามใหม่ - API เวอร์ชัน 3 จะไม่ดึงข้อมูลรายการที่มีเฉพาะวิดีโอที่เพิ่งอัปโหลดไปยังช่องที่ผู้ใช้ API ติดตาม อย่างไรก็ตาม คุณสามารถใช้ v3 API เพื่อค้นหาวิดีโอที่ช่องที่คุณติดตามเพิ่งอัปโหลดได้โดยเรียกใช้เมธอด activities.list และตั้งค่าพารามิเตอร์ home เป็น true

      ในคำตอบของ API ทรัพยากรจะสอดคล้องกับวิดีโอการสมัครใช้บริการใหม่หากค่าของพร็อพเพอร์ตี้ snippet.type เป็น upload โปรดทราบว่าเราไม่รับประกันว่าการตอบกลับจะมีวิดีโอใหม่จากการติดตามจำนวนหนึ่งๆ

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

    • ข้อความ Push สำหรับการอัปเดตฟีด - API เวอร์ชัน 2 รองรับข้อความ Push โดยใช้ Simple Update Protocol (SUP) หรือ PubSubHubbub เพื่อตรวจสอบฟีดกิจกรรมของผู้ใช้สำหรับผู้ใช้ YouTube ระบบจะแจ้งเตือนเมื่อมีการติดตามช่องใหม่ รวมถึงเมื่อมีการให้คะแนน แชร์ ทำเครื่องหมายเป็นรายการโปรด แสดงความคิดเห็น หรืออัปโหลดวิดีโอ

      API เวอร์ชัน 3 จะรองรับข้อความพุชโดยใช้โปรโตคอล PubSubHubbub แต่การแจ้งเตือนจะครอบคลุมเฉพาะการอัปโหลดวิดีโอและการอัปเดตชื่อวิดีโอหรือคำอธิบายวิดีโอเท่านั้น

    • สถานที่ตั้งของช่อง - API v2 ใช้แท็ก <yt:location> เพื่อระบุสถานที่ตั้งของผู้ใช้ตามที่ป้อนในโปรไฟล์สาธารณะของช่องบน YouTube แม้ว่านักพัฒนาแอปบางรายจะใช้ช่องนี้เพื่อเชื่อมโยงช่องกับประเทศหนึ่งๆ แต่ข้อมูลในช่องก็ไม่สามารถใช้เพื่อวัตถุประสงค์ดังกล่าวได้อย่างสม่ำเสมอ

    • ตั้งค่าหรือดึงแท็กนักพัฒนาซอฟต์แวร์ - API v2 รองรับความสามารถในการเชื่อมโยงคีย์เวิร์ดหรือแท็กนักพัฒนาซอฟต์แวร์กับวิดีโอในขณะที่อัปโหลดวิดีโอ แท็กนักพัฒนาแอปจะไม่แสดงต่อผู้ใช้ YouTube แต่เจ้าของวิดีโอจะดึงวิดีโอที่ตรงกับแท็กนักพัฒนาแอปที่เฉพาะเจาะจงได้

      API เวอร์ชัน 3 จะมีฟีเจอร์ที่คล้ายกัน แต่ไม่เหมือนกัน กล่าวคือ นักพัฒนาแอปจะค้นหาวิดีโอที่แอปพลิเคชันของตนเองอัปโหลดได้ สำหรับฟีเจอร์นี้ ระบบจะติดแท็กหมายเลขโปรเจ็กต์ที่เชื่อมโยงกับแอปพลิเคชันของนักพัฒนาแอปใน Google Developers Console ให้กับวิดีโอแต่ละรายการที่อัปโหลดโดยอัตโนมัติ จากนั้นนักพัฒนาแอปจะใช้หมายเลขโปรเจ็กต์เดียวกันเพื่อค้นหาวิดีโอ

    • แสดงวิดีโอตามวันที่เผยแพร่ จำนวนการดู หรือการจัดประเภท - ใน API เวอร์ชัน 2 พารามิเตอร์ orderby จะช่วยให้คุณจัดเรียงวิดีโอในเพลย์ลิสต์ตามตำแหน่ง ระยะเวลา วันที่เผยแพร่ ชื่อ และค่าอื่นๆ อีกหลายค่าได้ ใน API เวอร์ชัน 3 โดยปกติแล้ว ระบบจะจัดเรียงรายการในเพลย์ลิสต์ตามตำแหน่งในลำดับจากน้อยไปมาก และไม่มีตัวเลือกการจัดเรียงอื่นๆ

      โดยมีข้อยกเว้นบางประการ ระบบจะเพิ่มวิดีโอที่อัปโหลดใหม่ วิดีโอโปรด วิดีโอที่ชอบ หรือวิดีโอที่ดูเมื่อเร็วๆ นี้เป็นรายการแรก (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 ของ API v3 รองรับพารามิเตอร์ 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) เพื่อระบุการเลิกใช้งานฟีดพิเศษและฟิลด์ข้อมูลเมตาที่ v2 API มีไว้สำหรับอธิบายภาพยนตร์ ตัวอย่างภาพยนตร์ รายการโทรทัศน์ ซีซันของรายการโทรทัศน์ และตอนของรายการโทรทัศน์

14 มกราคม 2015

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

  • เราได้อัปเดตคู่มือการย้ายข้อมูล YouTube Data API (v3) เพื่ออธิบายวิธีใช้ v3 API ในการอัปโหลดวิดีโอโดยใช้ JavaScript (ดูรายละเอียดได้ที่ส่วนอัปโหลดวิดีโอ) ฟังก์ชันนี้เทียบเท่ากับฟังก์ชันการอัปโหลดบนเบราว์เซอร์ที่ API v2 รองรับ โปรดทราบว่าการเปลี่ยนแปลงคำแนะนำในการย้ายข้อมูลนี้ไม่ได้แสดงถึงการเปลี่ยนแปลง API จริง แต่เป็นการแสดงความพร้อมใช้งานของโค้ดตัวอย่างใหม่สำหรับการอัปโหลดวิดีโอด้วย JavaScript ฝั่งไคลเอ็นต์

    เนื่องจากรองรับการอัปโหลดวิดีโอด้วยไลบรารีไคลเอ็นต์ JavaScript และ CORS คู่มือการย้ายข้อมูลจึงไม่ได้ระบุการอัปโหลดบนเบราว์เซอร์เป็นฟีเจอร์ที่อาจเลิกใช้งานใน API เวอร์ชัน 3 อีกต่อไป

  • เอกสารประกอบสำหรับเมธอด videos.insert ได้รับการอัปเดตให้มีตัวอย่างโค้ด JavaScript ใหม่ที่อธิบายไว้ข้างต้น นอกจากนี้ เรายังได้อัปเดตรายการตัวอย่างโค้ด JavaScript สำหรับ YouTube Data API (v3) ด้วย

11 พฤศจิกายน 2014

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

  • ค่าใช้จ่ายโควต้าสำหรับการเรียกใช้เมธอด search.list เปลี่ยนเป็น 100 หน่วยแล้ว

    สำคัญ: ในหลายกรณี คุณสามารถใช้วิธีการ API อื่นๆ เพื่อดึงข้อมูลโดยใช้โควต้าที่ต่ำกว่าได้ ตัวอย่างเช่น ลองพิจารณาวิธีค้นหาวิดีโอที่อัปโหลดไปยังช่อง GoogleDevelopers 2 วิธีต่อไปนี้

    • ค่าใช้จ่ายของโควต้า: 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 เวอร์ชัน 2 ไปยัง API เวอร์ชันล่าสุด

8 กรกฎาคม 2014

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

  • ตอนนี้เมธอด playlists.insert รองรับข้อผิดพลาดต่อไปนี้แล้ว

    ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
    badRequest maxPlaylistExceeded ข้อผิดพลาดนี้จะเกิดขึ้นหากสร้างเพลย์ลิสต์ไม่ได้เนื่องจากช่องมีเพลย์ลิสต์ถึงจำนวนสูงสุดที่อนุญาตแล้ว

18 มิถุนายน 2014

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

  • คำอธิบายของเมธอด API แต่ละรายการได้รับการอัปเดตให้รวมต้นทุนโควต้าที่เกิดจากการเรียกเมธอดนั้น ในทํานองเดียวกัน เราได้อัปเดตคําจํากัดความของpartพารามิเตอร์เพื่อระบุต้นทุนโควต้าของแต่ละส่วนที่เรียกข้อมูลได้ในการเรียก API เช่น การเรียกใช้เมธอด subscriptions.insert จะมีต้นทุนโควต้าประมาณ 50 หน่วย นอกจากนี้ ทรัพยากร subscription ยังมี 3 ส่วน (snippet, contentDetails และ subscriberSnippet) และแต่ละส่วนมีต้นทุน 2 หน่วย

    โปรดทราบว่าค่าใช้จ่ายของโควต้าอาจเปลี่ยนแปลงได้โดยไม่ต้องแจ้งให้ทราบ

  • ตอนนี้ทรัพยากร video รองรับระบบการจัดประเภทเนื้อหาใหม่ 43 ระบบ ซึ่งจะระบุการจัดประเภทที่วิดีโอได้รับจากหน่วยงานจัดประเภทระดับชาติต่างๆ ระบบการจัดประเภทที่รองรับใหม่มาจากอาร์เจนตินา ออสเตรีย เบลเยียม บัลแกเรีย ชิลี (โทรทัศน์) ชิลี (ภาพยนตร์) สาธารณรัฐเช็ก โคลอมเบีย เดนมาร์ก อียิปต์ เอสโตเนีย ฟินแลนด์ ฝรั่งเศส กรีซ ฮ่องกง ไอซ์แลนด์ อินโดนีเซีย ไอร์แลนด์ อิสราเอล อิตาลี เคนยา ลัตเวีย ลักเซมเบิร์ก มาเลเซีย มัลดีฟส์ มอลตา เนเธอร์แลนด์ ไนจีเรีย นอร์เวย์ เปรู ฟิลิปปินส์ โปรตุเกส โรมาเนีย สิงคโปร์ สโลวาเกีย แอฟริกาใต้ สวีเดน สวิตเซอร์แลนด์ ไต้หวัน ไทย และเวเนซุเอลา

28 พฤษภาคม 2014

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

  • ตอนนี้search.listเมธอดรองรับพารามิเตอร์ location และ locationRadius แล้ว ซึ่งจะช่วยให้คุณค้นหาวิดีโอที่เชื่อมโยงกับสถานที่ตั้งทางภูมิศาสตร์ได้ คำขอต้องระบุค่าสำหรับพารามิเตอร์ทั้ง 2 รายการเพื่อดึงผลลัพธ์ตามสถานที่ตั้ง และ API จะแสดงข้อผิดพลาดหากคำขอมีพารามิเตอร์เพียงรายการเดียวจาก 2 รายการ

    • พารามิเตอร์ location จะระบุพิกัดละติจูด/ลองจิจูดที่กึ่งกลางของพื้นที่ทางภูมิศาสตร์ที่เป็นวงกลม

    • พารามิเตอร์ locationRadius ระบุระยะทางสูงสุดที่สถานที่ตั้งซึ่งเชื่อมโยงกับวิดีโอสามารถอยู่ห่างจากศูนย์กลางของพื้นที่เพื่อให้วิดีโอยังคงรวมอยู่ในผลการค้นหา

13 พฤษภาคม 2014

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

  • เราได้อัปเดตพร็อพเพอร์ตี้ invideoPromotion.items[] ของchannelทรัพยากรเพื่อระบุว่าโดยปกติแล้วคุณจะตั้งค่ารายการที่โปรโมตสำหรับช่องได้เพียงรายการเดียว หากคุณพยายามแทรกสินค้าโปรโมตมากเกินไป API จะแสดงข้อผิดพลาด tooManyPromotedItems ซึ่งมีรหัสสถานะ HTTP 400

  • ตอนนี้channelSectionสามารถมีข้อมูลเกี่ยวกับเนื้อหาแนะนำประเภทใหม่ๆ ได้แล้ว ตอนนี้พร็อพเพอร์ตี้ 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 5,000 ไบต์
    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 method ต้องระบุออบเจ็กต์ 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 รายการหรือพารามิเตอร์ตัวกรอง 1 รายการได้

  • เราได้อัปเดตคําจํากัดความของพารามิเตอร์ของเมธอด 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 ซึ่งได้แก่ พารามิเตอร์ search.listeventType ของเมธอดและพร็อพเพอร์ตี้ 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 ปีขึ้นไป

  • channelพร็อพเพอร์ตี้ใหม่ของinvideoPromotion.items[].promotedByContentOwnerทรัพยากรจะระบุว่าชื่อของเจ้าของเนื้อหาจะแสดงเมื่อแสดงโปรโมชันหรือไม่ ตั้งค่าฟิลด์นี้ได้ก็ต่อเมื่อมีการส่งคำขอ 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

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

      • ย้ายออบเจ็กต์ 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

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

  • channels.list พารามิเตอร์ forUsername ใหม่ของเมธอดช่วยให้คุณดึงข้อมูลเกี่ยวกับช่องได้โดยการระบุชื่อผู้ใช้ 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 ต้องระบุพารามิเตอร์ใดพารามิเตอร์หนึ่งอย่างชัดเจน (ก่อนหน้านี้ พารามิเตอร์ 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 – พร็อพเพอร์ตี้ระบุชื่อของช่องที่ติดตาม

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

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

    หมายเหตุ: ฟังก์ชันนี้มีไว้เพื่อแทนที่พารามิเตอร์ 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 จะห่อหุ้มการจัดประเภทที่วิดีโอได้รับภายใต้รูปแบบการจัดประเภทต่างๆ รายการด้านล่างระบุระบบการจัดประเภทที่รองรับและมีลิงก์ไปยังที่พักที่เชื่อมโยงกับระบบการจัดประเภทแต่ละระบบ คำจำกัดความของพร็อพเพอร์ตี้จะระบุค่าการจัดประเภทที่รองรับสำหรับแต่ละระบบ

      ประเทศ ระบบการจัดประเภท พร็อพเพอร์ตี้
      United States สมาคมภาพยนตร์แห่งสหรัฐอเมริกา (Motion Picture Association of America หรือ MPAA) contentDetails.contentRating.mpaaRating
      United States TV Parental Guidelines contentDetails.contentRating.tvpgRating
      Australia คณะกรรมการการจัดประเภทของออสเตรเลีย (ACB) contentDetails.contentRating.acbRating
      Brazil Departamento de Justiça, Classificação, Qualificação e Títulos contentDetails.contentRating.djctqRating
      Canada ระบบการจัดประเภทวิดีโอในบ้านของแคนาดา (CHVRS) contentDetails.contentRating.chvrsRating
      France Centre national du cinéma et de l'image animée (กระทรวงวัฒนธรรมของฝรั่งเศส) contentDetails.contentRating.fmocRating
      Germany Freiwillige Selbstkontrolle der Filmwirtschaft (FSK) contentDetails.contentRating.fskRating
      Great Britain คณะกรรมการจัดประเภทภาพยนตร์ของอังกฤษ (BBFC) contentDetails.contentRating.bbfcRating
      India Central Board of Film Certification (CBFC) contentDetails.contentRating.cbfcRating
      Japan 映倫管理委員会 (EIRIN) contentDetails.contentRating.eirinRating
      Korea 영상물등급위원회 (KMRB) contentDetails.contentRating.kmrbRating
      Mexico General Directorate of Radio, Television and Cinematography (RTC) contentDetails.contentRating.rtcRating
      New Zealand Office of Film and Literature Classification contentDetails.contentRating.oflcRating
      Russia ทะเบียนภาพยนตร์แห่งชาติของสหพันธรัฐรัสเซีย contentDetails.contentRating.russiaRating
      Spain 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 ระบุรายละเอียดการบันทึกที่ไม่ถูกต้อง
    badRequest invalidVideoGameRating ข้อมูลเมตาของคำขอระบุการจัดประเภทวิดีโอเกมที่ไม่ถูกต้อง
    badRequest invalidVideoMetadata ข้อมูลเมตาของคำขอไม่ถูกต้อง
  • พารามิเตอร์ onBehalfOfContentOwner ถูกนำออกจากรายการพารามิเตอร์ที่รองรับสำหรับเมธอด videos.update และ videos.delete

12 มีนาคม 2013

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

  • เราได้เพิ่มพร็อพเพอร์ตี้ channelTitle ลงใน snippet สำหรับแหล่งข้อมูลต่อไปนี้แล้ว

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

  • เมธอด search.list รองรับพารามิเตอร์ใหม่ต่อไปนี้

    • พารามิเตอร์ channelType ช่วยให้คุณจำกัดการค้นหาช่องเพื่อดึงข้อมูลช่องทั้งหมดหรือดึงข้อมูลเฉพาะรายการ

    • พารามิเตอร์ videoType ช่วยให้คุณจำกัดการค้นหาวิดีโอเพื่อดึงวิดีโอทั้งหมด หรือดึงเฉพาะภาพยนตร์หรือเฉพาะตอนของรายการ

  • เราได้อัปเดตคำจำกัดความของvideoส่วนrecordingDetailsของทรัพยากรเพื่อระบุว่าระบบจะแสดงออบเจ็กต์สำหรับวิดีโอเท่านั้นหากมีการตั้งค่าข้อมูลตำแหน่งทางภูมิศาสตร์หรือเวลาที่บันทึกของวิดีโอ

  • ตอนนี้เมธอด playlistItems.update จะแสดงข้อผิดพลาด invalidSnippet ซึ่งจะแสดงหากคำขอ API ไม่ได้ระบุข้อมูลโค้ดที่ถูกต้อง

  • เมธอด API หลายรายการรองรับพารามิเตอร์ใหม่ที่มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ YouTube โดยเฉพาะ พาร์ทเนอร์เนื้อหาของ YouTube ได้แก่ สตูดิโอภาพยนตร์และโทรทัศน์ ค่ายเพลง และครีเอเตอร์เนื้อหารายอื่นๆ ที่เผยแพร่เนื้อหาของตนบน YouTube

    • พารามิเตอร์ onBehalfOfContentOwner ระบุว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุผู้ใช้ YouTube CMS ที่ดำเนินการในนามของเจ้าของเนื้อหาที่ระบุในค่าพารามิเตอร์ บัญชี CMS ที่ผู้ใช้ตรวจสอบสิทธิ์จะต้องลิงก์กับเจ้าของเนื้อหา YouTube ที่ระบุ

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

      เมธอด channels.list, search.list, videos.delete, videos.list และ videos.update รองรับพารามิเตอร์นี้ทั้งหมด

    • พารามิเตอร์ managedByMe ซึ่งเมธอด channels.list รองรับ จะสั่งให้ API แสดงช่องทั้งหมดที่เป็นของเจ้าของเนื้อหาที่พารามิเตอร์ onBehalfOfContentOwner ระบุ

    • พารามิเตอร์ forContentOwner ซึ่งเมธอด search.list รองรับ จะสั่งให้ API จำกัดผลการค้นหาให้รวมเฉพาะทรัพยากรที่เป็นของเจ้าของเนื้อหาที่พารามิเตอร์ onBehalfOfContentOwner ระบุ

25 กุมภาพันธ์ 2013

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

  • API รองรับชิ้นส่วนและพร็อพเพอร์ตี้ใหม่หลายรายการสำหรับทรัพยากร video ดังนี้

    • ส่วนใหม่ fileDetails, processingDetails และ suggestions จะให้ข้อมูลแก่เจ้าของวิดีโอเกี่ยวกับวิดีโอที่อัปโหลด ข้อมูลนี้มีประโยชน์อย่างยิ่งในแอปพลิเคชันที่เปิดใช้การอัปโหลดวิดีโอ และประกอบด้วยข้อมูลต่อไปนี้

      • สถานะและความคืบหน้าในการประมวลผล
      • ข้อผิดพลาดหรือปัญหาอื่นๆ ที่พบขณะประมวลผลวิดีโอ
      • ความพร้อมใช้งานของภาพขนาดย่อ
      • คำแนะนำในการปรับปรุงคุณภาพวิดีโอหรือข้อมูลเมตา
      • รายละเอียดเกี่ยวกับไฟล์ต้นฉบับที่อัปโหลดไปยัง YouTube

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

      • ออบเจ็กต์ fileDetails มีข้อมูลเกี่ยวกับไฟล์วิดีโอที่อัปโหลดไปยัง YouTube รวมถึงความละเอียด ระยะเวลา ตัวแปลงรหัสเสียงและวิดีโอ บิตเรตของสตรีม และอื่นๆ ของไฟล์

      • processingProgress ออบเจ็กต์มีข้อมูลเกี่ยวกับความคืบหน้าของ YouTube ในการประมวลผลไฟล์วิดีโอที่อัปโหลด พร็อพเพอร์ตี้ของออบเจ็กต์จะระบุสถานะการประมวลผลปัจจุบันและประมาณเวลาที่เหลือจนกว่า YouTube จะประมวลผลวิดีโอเสร็จ นอกจากนี้ ส่วนนี้ยังระบุว่ามีข้อมูลหรือเนื้อหาประเภทต่างๆ เช่น รายละเอียดไฟล์หรือภาพปก สำหรับวิดีโอหรือไม่

        ออบเจ็กต์นี้ออกแบบมาเพื่อใช้ในการสำรวจเพื่อให้ผู้อัปโหลดวิดีโอติดตามความคืบหน้าที่ YouTube ดำเนินการในการประมวลผลไฟล์วิดีโอที่อัปโหลดได้

      • ออบเจ็กต์ suggestions มีคำแนะนำที่ระบุโอกาสในการปรับปรุงคุณภาพวิดีโอหรือข้อมูลเมตาสำหรับวิดีโอที่อัปโหลด

    • ส่วน contentDetails มีพร็อพเพอร์ตี้ใหม่ 4 รายการ คุณสามารถดึงข้อมูลพร็อพเพอร์ตี้เหล่านี้ได้ด้วยคำขอที่ไม่ผ่านการตรวจสอบสิทธิ์

      • dimension – ระบุว่าวิดีโอพร้อมให้รับชมในรูปแบบ 2 มิติหรือ 3 มิติ
      • definition – ระบุว่าวิดีโอมีความละเอียดมาตรฐานหรือความละเอียดสูง
      • caption – ระบุว่าวิดีโอมีคำบรรยายแทนเสียงหรือไม่
      • licensedContent – ระบุว่าวิดีโอมีเนื้อหาที่พาร์ทเนอร์ด้านเนื้อหาของ YouTube อ้างสิทธิ์หรือไม่

    • ส่วน status มีพร็อพเพอร์ตี้ใหม่ 2 รายการ เจ้าของวิดีโอสามารถตั้งค่าสำหรับพร็อพเพอร์ตี้ทั้ง 2 รายการได้เมื่อแทรกหรืออัปเดตวิดีโอ นอกจากนี้ คุณยังเรียกข้อมูลพร็อพเพอร์ตี้เหล่านี้ได้ด้วยคำขอที่ไม่ผ่านการตรวจสอบสิทธิ์

      • embeddable – Indicates whether the video can be embedded on another website.
      • 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 ออบเจ็กต์ที่ระบุแหล่งข้อมูลที่เพิ่มลงในช่อง เช่นเดียวกับresourceIdพร็อพเพอร์ตี้อื่นๆ พร็อพเพอร์ตี้นี้มีkindพร็อพเพอร์ตี้ที่ระบุประเภททรัพยากร เช่น วิดีโอหรือเพลย์ลิสต์ นอกจากนี้ ยังมีพร็อพเพอร์ตี้หลายรายการ เช่น videoId, playlistId ฯลฯ ซึ่งระบุรหัสที่ระบุทรัพยากรนั้นๆ ได้อย่างไม่ซ้ำกัน
    channel status object ออบเจ็กต์นี้จะห่อหุ้มข้อมูลเกี่ยวกับสถานะความเป็นส่วนตัวของช่อง
    channel status.privacyStatus string สถานะความเป็นส่วนตัวของช่อง ค่าที่ใช้ได้คือ private และ public
    playlist contentDetails object ออบเจ็กต์นี้มีข้อมูลเมตาเกี่ยวกับเนื้อหาของเพลย์ลิสต์
    playlist contentDetails.itemCount unsigned integer จำนวนวิดีโอในเพลย์ลิสต์
    playlist player object ออบเจ็กต์นี้มีข้อมูลที่คุณจะใช้เพื่อเล่นเพลย์ลิสต์ในโปรแกรมเล่นแบบฝัง
    playlist player.embedHtml string แท็ก <iframe> ที่ฝังวิดีโอเพลเยอร์ซึ่งเล่นเพลย์ลิสต์
    video recordingDetails object ออบเจ็กต์นี้ห่อหุ้มข้อมูลที่ระบุหรืออธิบายสถานที่และเวลาที่บันทึกวิดีโอ
    video recordingDetails.location object ออบเจ็กต์นี้มีข้อมูลตำแหน่งทางภูมิศาสตร์ที่เชื่อมโยงกับวิดีโอ
    video recordingDetails.location.latitude double ละติจูดในหน่วยองศา
    video recordingDetails.location.longitude double ลองจิจูดเป็นองศา
    video recordingDetails.location.elevation double ระดับความสูงเหนือพื้นโลกในหน่วยเมตร
    video recordingDetails.locationDescription string คำอธิบายข้อความของสถานที่ที่มีการบันทึกวิดีโอ
    video recordingDetails.recordingDate datetime วันที่และเวลาที่บันทึกวิดีโอ ค่าจะระบุในรูปแบบ ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ)
  • ตอนนี้เอกสารประกอบสำหรับเมธอด API หลายรายการระบุพร็อพเพอร์ตี้ที่ต้องระบุในเนื้อหาคำขอหรือที่อัปเดตตามค่าในเนื้อหาคำขอ ตารางด้านล่างแสดงรายการเมธอดเหล่านั้น รวมถึงพร็อพเพอร์ตี้ที่ต้องระบุหรือแก้ไขได้

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

    วิธีการ พร็อพเพอร์ตี้
    activities.insert พร็อพเพอร์ตี้ที่จำเป็น:
    • snippet.description
    พร็อพเพอร์ตี้ที่แก้ไขได้
    • snippet.description
    • contentDetails.bulletin.resourceId
    playlists.update พร็อพเพอร์ตี้ที่จำเป็น:
    • id
    playlistItems.update พร็อพเพอร์ตี้ที่จำเป็น:
    • id
    videos.update พร็อพเพอร์ตี้ที่จำเป็น:
    • id
  • API จะไม่รายงานข้อผิดพลาด playlistAlreadyExists อีกต่อไปหากคุณพยายามสร้างหรืออัปเดตเพลย์ลิสต์ที่มีชื่อเดียวกันกับเพลย์ลิสต์ที่มีอยู่ในช่องเดียวกันอยู่แล้ว

  • เมธอด API หลายรายการรองรับข้อผิดพลาดประเภทใหม่ ตารางด้านล่างระบุวิธีการและข้อผิดพลาดที่รองรับใหม่

    วิธีการ ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
    guideCategories.list notFound notFound ไม่พบหมวดหมู่คำแนะนำที่ระบุโดยพารามิเตอร์ id ใช้วิธี guideCategories.list เพื่อดึงรายการค่าที่ถูกต้อง
    playlistItems.delete forbidden playlistItemsNotAccessible คำขอไม่ได้รับอนุญาตอย่างถูกต้องในการลบรายการเพลย์ลิสต์ที่ระบุ
    videoCategories.list notFound videoCategoryNotFound ไม่พบหมวดหมู่วิดีโอที่ระบุโดยพารามิเตอร์ id ใช้วิธี videoCategories.list เพื่อดึงข้อมูลรายการค่าที่ถูกต้อง