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

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

2 พฤศจิกายน 2569

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

หากคุณไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้ status.privacyStatus ในคำขอ videos.insert สถานะความเป็นส่วนตัวของวิดีโอที่อัปโหลดจะใช้ค่าเริ่มต้นเป็น public การอัปโหลดบางรายการอาจมีค่าเริ่มต้นเป็น private โดยอิงตามการตั้งค่าบัญชีของครีเอเตอร์ ตามที่อธิบายไว้ในศูนย์ช่วยเหลือของ YouTube

15 ตุลาคม 2569

เมธอด videos.list ได้รับการชี้แจงเพื่อระบุว่าพร็อพเพอร์ตี้ status.selfDeclaredMadeForKids และ status.madeForKids จะอัปเดตก็ต่อเมื่อมีการระบุไว้ในคำขอ และจะไม่ถูกลบล้างหากละเว้น

30 กันยายน 2026

คำจำกัดความของทรัพยากร comments ได้รับการอัปเดตให้รวมพร็อพเพอร์ตี้ snippet.imageUrl ใหม่ ซึ่งระบุ URL ของรูปภาพหรือ GIF ภาพเคลื่อนไหวที่แนบมากับความคิดเห็น

ฟีเจอร์นี้จะพร้อมใช้งานสำหรับผู้ใช้ทุกคนในเดือนพฤศจิกายน 2026

14 กันยายน 2569

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

  • เราได้อัปเดตคำอธิบายเมธอด thumbnails.set เพื่อระบุว่าขนาดไฟล์สูงสุดสำหรับภาพปกที่อัปโหลดเพิ่มขึ้นจาก 2 MB เป็น 50 MB
  • เราได้อัปเดตคำอธิบายเมธอด playlistImages.insert เพื่อระบุว่าขนาดไฟล์สูงสุดสำหรับรูปภาพที่อัปโหลดเพิ่มขึ้นจาก 2 MB เป็น 50 MB

11 กันยายน 2569

เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้ snippet.thumbnails.(key) ในเอกสารอ้างอิงสำหรับทรัพยากร activities, liveBroadcasts, playlistItems, playlists, search และ videos เพื่อระบุว่าตอนนี้วิดีโอบางรายการมีภาพปกที่มีความละเอียดสูงขึ้น ได้แก่ fhd (1080p), qhd (1440p) และ uhd (4K)

1 กันยายน 2569

ตอนนี้เมธอด videos.getRating ยอมรับขอบเขตการให้สิทธิ์ https://www.googleapis.com/auth/youtube.readonly แล้ว

27 สิงหาคม 2026

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

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

การเปลี่ยนแปลงนี้จะไม่ส่งผลต่อการมีสิทธิ์เข้าร่วมโปรแกรมพาร์ทเนอร์ YouTube นอกจากนี้ ข้อกำหนดในการเข้าร่วมโปรแกรมพาร์ทเนอร์ YouTube จะเปลี่ยนไปใช้ชื่อ "ยอดดู Shorts ที่เข้าเกณฑ์" และ "เวลาในการรับชมที่เข้าเกณฑ์" (ก่อนหน้านี้คือ "ยอดดู Shorts สาธารณะที่เข้าเกณฑ์" และ "เวลาในการรับชมวิดีโอสาธารณะที่เข้าเกณฑ์")

ดูข้อมูลเพิ่มเติมได้ที่ทำความเข้าใจประสิทธิภาพเนื้อหาของคุณบน YouTube

เมตริก สถานะ ทริกเกอร์ ใช้สำหรับ
ดู อัปเดตแล้ว วิดีโอเล่นจากเฟรมแรก (รวมถึงการเล่นอัตโนมัติ การวางเคอร์เซอร์เหนือวิดีโอ และการคลิก/แตะเพื่อเล่น) ยอดดูแบบสาธารณะมาตรฐาน
การดูอย่างมีส่วนร่วม ไม่มีการเปลี่ยนแปลง การเล่นดำเนินต่อไปหลังจากเฟรมแรก หรือผู้ใช้คลิก/แตะเพื่อเล่น การสร้างรายได้ผ่านโปรแกรมพาร์ทเนอร์ YouTube, ข้อมูลวิเคราะห์หลักส่วนใหญ่ (อัตราการคลิกผ่าน ระยะเวลาการดูเฉลี่ย) และการรายงานการมีส่วนร่วม
การแสดงผลภาพปก ไม่มีการเปลี่ยนแปลง ภาพขนาดย่อจะแสดงโดยไม่มีการโต้ตอบหรือการเล่นอัตโนมัติ วัดการแสดงผลและการจัดแพ็กเกจในระดับฟีด

การอัปเดตเอกสารประกอบเกี่ยวกับ API: อัปเดตคำอธิบายของช่อง viewCount ในเอกสารอ้างอิงช่องและวิดีโอ

6 สิงหาคม 2569

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

  • การอ้างอิงทั้งหมดไปยังช่อง contentDetails.like และ contentDetails.favorite ในส่วน activities.contentDetails ถูกนำออกจากเอกสารประกอบสาธารณะเนื่องจาก API ไม่แสดงผลช่องเหล่านี้

7 กรกฎาคม 2026

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

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

คุณสามารถระบุส่วน brandPartner ได้เมื่อเรียกใช้เมธอดต่อไปนี้

ออบเจ็กต์ brandPartner มีช่องต่อไปนี้

  • channelId: รหัสช่องทางภายนอกของพาร์ทเนอร์แบรนด์
  • channelHandle: แฮนเดิลของช่องพาร์ทเนอร์แบรนด์
ต้องตั้งค่า channelId หรือ channelHandle เมื่อสร้างลิงก์ แต่ระบบจะแสดงเฉพาะ channelId ในการตอบกลับ

23 มิถุนายน 2569

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

  • เราได้นำการอ้างอิงทั้งหมดถึงประเภททรัพยากร messageDeletedEvent และ messageRetractedEvent (รวมถึงออบเจ็กต์ messageDeletedDetails และ messageRetractedDetails ที่เกี่ยวข้อง) ใน liveChatMessages ออกแล้ว เนื่องจาก API ไม่แสดงเหตุการณ์เหล่านี้

3 มิถุนายน 2569

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

ตอนนี้ API รองรับเมธอดใหม่ videos.batchGetStats ซึ่งจะดึงข้อมูลรายการสถิติของวิดีโอที่ตรงกับพารามิเตอร์คำขอ API

การเรียกใช้เมธอดนี้มีค่าใช้จ่ายโควต้า 1 หน่วยในที่เก็บโควต้าแบบละเอียดของตัวเอง โควต้าเริ่มต้นของเมธอดคือ 10,000 หน่วยต่อวัน

1 มิถุนายน 2026

YouTube Data API กำลังเปลี่ยนไปใช้ระบบโควต้าแบบละเอียดซึ่งครอบคลุมชุดเมธอดที่เล็กลง โดยเริ่มจาก videos.insert และ search.list

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

ระบบจะเรียกเก็บเงินจากการเรียก API ไปยังเมธอด videos.insert และ search.list จากที่เก็บข้อมูลโควต้าที่เกี่ยวข้องของตนเอง การเรียก API ไปยังเมธอดอื่นๆ ทั้งหมดจะเรียกเก็บเงินจากที่เก็บโควต้าที่มีอยู่ นักพัฒนาแอปสามารถดูขีดจำกัดโควต้าได้ในคอนโซล Google Cloud และขอโควต้าเพิ่มเติมได้ผ่านแบบฟอร์มขยายโควต้า

4 ธันวาคม 2568

เราได้อัปเดตเอกสารประกอบของ YouTube Data API และเครื่องคำนวณโควต้าเพื่อให้สอดคล้องกับการเปลี่ยนแปลงต้นทุนโควต้าของการอัปโหลดวิดีโอจากประมาณ 1,600 หน่วยเป็นประมาณ 100 หน่วย

10 กรกฎาคม 2025

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

26 มีนาคม 2025

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

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

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

30 ตุลาคม 2024

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

ตัวอย่างเนื้อหาที่สร้างโดย AI ได้แก่วิดีโอที่มีลักษณะดังนี้

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

หากต้องการระบุว่าวิดีโอมีเนื้อหา 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

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

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

9 พฤศจิกายน 2023

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

12 กันยายน 2023

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

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

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

22 สิงหาคม 2023

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

18 สิงหาคม 2023

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

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

15 ธันวาคม 2021

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

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

18 พฤศจิกายน 2021

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

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

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

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

2 กรกฎาคม 2021

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

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

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

1 กรกฎาคม 2021

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

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

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

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

8 ตุลาคม 2020

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

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

9 กันยายน 2020

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

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

  • ทรัพยากร, เมธอด, พารามิเตอร์ และพร็อพเพอร์ตี้ทรัพยากรของ API ต่อไปนี้จะเลิกใช้งานทันทีและจะหยุดทำงานในหรือหลังจากวันที่ประกาศนี้
    • พร็อพเพอร์ตี้ทรัพยากร channel ต่อไปนี้
      • พร็อพเพอร์ตี้ statistics.commentCount
      • ออบเจ็กต์ brandingSettings.image และพร็อพเพอร์ตี้ย่อยทั้งหมด
      • brandingSettings.hintsรายการและพร็อพเพอร์ตี้ย่อยทั้งหมด
    • พารามิเตอร์ตัวกรอง categoryId ของเมธอด channels.list
    • ทรัพยากร guideCategories และเมธอด guideCategories.list
  • การตอบกลับจาก API สำหรับเมธอด channels.list จะไม่มีพร็อพเพอร์ตี้ prevPageToken อีกต่อไปหากคำขอ API ตั้งค่าพารามิเตอร์ managedByMe เป็น true การเปลี่ยนแปลงนี้ไม่ส่งผลต่อพร็อพเพอร์ตี้ prevPageToken สำหรับคำขอ channels.list อื่นๆ และไม่ส่งผลต่อพร็อพเพอร์ตี้ nextPageToken สำหรับคำขอใดๆ
  • เราได้ประกาศเลิกใช้งานทั้งพร็อพเพอร์ตี้ contentDetails.relatedPlaylists.watchLater และ contentDetails.relatedPlaylists.watchHistory ของทรัพยากร channel ไปเมื่อวันที่ 11 สิงหาคม 2016 นอกจากนี้ การรองรับเพลย์ลิสต์เหล่านี้ของเมธอด playlistItems.insert และเมธอด playlistItems.delete ก็เลิกใช้งานโดยสมบูรณ์แล้ว และเราได้นำพร็อพเพอร์ตี้ทั้ง 2 รายการออกจากเอกสารประกอบแล้ว
  • พารามิเตอร์ mySubscribers ของเมธอด channels.list ซึ่งประกาศว่าเลิกใช้งานแล้วเมื่อวันที่ 30 กรกฎาคม 2013 ได้ถูกนำออกจากเอกสารประกอบแล้ว ใช้เมธอด subscriptions.list และพารามิเตอร์ mySubscribers เพื่อดึงข้อมูลรายชื่อผู้ติดตามช่องของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว
  • ออบเจ็กต์ invideoPromotion ของทรัพยากร channel และพร็อพเพอร์ตี้ย่อยทั้งหมด ซึ่งประกาศว่าเลิกใช้งานแล้วเมื่อวันที่ 27 พฤศจิกายน 2017 ได้ถูกนำออกจากเอกสารประกอบแล้ว

29 กรกฎาคม 2020

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

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

เราขอแนะนำอย่างยิ่งให้นักพัฒนาแอปทุกคนทำการตรวจสอบการปฏิบัติตามข้อกำหนดสำหรับโปรเจ็กต์ของตนเพื่อให้เข้าถึงบริการ 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 TOS) ของบริการ API ของ YouTube ในส่วนที่เฉพาะเจาะจง

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

4 มิถุนายน 2020

หมายเหตุ: ข้อมูลนี้เป็นการอัปเดตประกาศการเลิกใช้งานก่อนหน้านี้

ตอนนี้เราได้เลิกใช้งานฟีเจอร์กระดานข่าวของช่องอย่างสมบูรณ์แล้ว การเปลี่ยนแปลงนี้ประกาศครั้งแรกเมื่อวันที่ 17 เมษายน 2020 และมีผลบังคับใช้แล้วในขณะนี้ ด้วยเหตุนี้ ระบบจึงไม่รองรับเมธอด activities.insert อีกต่อไป และเมธอด activities.list จะไม่แสดงผลกระดานข่าวของช่องอีกต่อไป ดูรายละเอียดเพิ่มเติมได้ที่ศูนย์ช่วยเหลือของ YouTube

17 เมษายน 2020

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

YouTube กำลังเลิกใช้งานฟีเจอร์กระดานข่าวของช่อง ด้วยเหตุนี้ เราจะเลิกใช้งานเมธอด activities.insert และเมธอด activities.list จะหยุดแสดงผลประกาศของช่อง การเปลี่ยนแปลงเหล่านี้จะมีผลใน API ตั้งแต่วันที่ 18 พฤษภาคม 2020 เป็นต้นไป ดูรายละเอียดเพิ่มเติมได้ที่ศูนย์ช่วยเหลือของ YouTube

31 มีนาคม 2020

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

  • แหล่งข้อมูลและวิธีการใหม่ๆ

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

      ทรัพยากรนี้จะแทนที่ทรัพยากร sponsor ซึ่งได้รับการบันทึกไว้เป็นส่วนหนึ่งของ YouTube Live Streaming API ตอนนี้เราเลิกใช้งานทรัพยากร sponsor แล้ว และไคลเอ็นต์ API ควรอัปเดตการเรียกใช้เมธอด sponsors.list เพื่อใช้เมธอด members.list แทน

    • ทรัพยากร membershipsLevel ใหม่จะระบุระดับราคาที่จัดการโดยครีเอเตอร์ที่ให้สิทธิ์คำขอ API เมธอด membershipsLevels.list จะดึงข้อมูลรายการระดับการเป็นสมาชิกทั้งหมดของครีเอเตอร์

10 มกราคม 2020

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

แหล่งข้อมูล channel และ video รองรับพร็อพเพอร์ตี้ใหม่ 2 รายการเพื่อช่วยให้คอนเทนต์ครีเอเตอร์และผู้ชมระบุเนื้อหาที่สร้างมาเพื่อเด็กได้ ดังนี้

  • พร็อพเพอร์ตี้ selfDeclaredMadeForKids ช่วยให้คอนเทนต์ครีเอเตอร์ระบุได้ว่าช่องหรือวิดีโอสร้างมาเพื่อเด็กหรือไม่

    สำหรับช่อง คุณจะตั้งค่าพร็อพเพอร์ตี้นี้ได้เมื่อเรียกใช้เมธอด channels.update สำหรับวิดีโอ คุณจะตั้งค่าพร็อพเพอร์ตี้นี้ได้เมื่อเรียกใช้เมธอด videos.insert หรือ videos.update

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

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

10 กันยายน 2019

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

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

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

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

4 เมษายน 2019

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

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

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

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

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

    ปัจจุบันตัวอย่างโค้ดรองรับ Java, JavaScript, PHP, Python และ curl

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

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

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

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

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

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

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

27 เมษายน 2017

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

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

30 มีนาคม 2017

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

  • พร็อพเพอร์ตี้ topicDetails.topicCategories[] ใหม่ของทรัพยากร channel มีรายการ URL ของ Wikipedia ที่อธิบายเนื้อหาของช่อง URL จะสอดคล้องกับรหัสหัวข้อที่แสดงผลในพร็อพเพอร์ตี้ topicDetails.topicIds[] ของทรัพยากร
  • พร็อพเพอร์ตี้ contentDetails.videoPublishedAt ใหม่ของทรัพยากร playlistItem จะระบุเวลาที่เผยแพร่วิดีโอไปยัง YouTube ทรัพยากรมีพร็อพเพอร์ตี้ snippet.publishedAt อยู่แล้ว ซึ่งจะระบุเวลาที่เพิ่มรายการลงในเพลย์ลิสต์
  • ตอนนี้ทรัพยากร 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 ออกแล้ว

    นอกจากนี้ โปรดทราบว่ามีหมวดหมู่หลักอยู่ 2-3 หมวดหมู่ (Entertainment, Gaming, Lifestyle, Music และ Sports) วิดีโอที่เชื่อมโยงกับหมวดหมู่ย่อย เช่น Tennis จะเชื่อมโยงกับหมวดหมู่หลัก (Sports) ด้วย

10 พฤศจิกายน 2016

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

  • ตามที่ประกาศครั้งแรกเมื่อวันที่ 11 สิงหาคม 2016 การเลิกใช้งาน Freebase และ Freebase API จำเป็นต้องมีการเปลี่ยนแปลงหลายอย่างที่เกี่ยวข้องกับรหัสหัวข้อ รหัสหัวข้อจะระบุหัวข้อที่เชื่อมโยงกับทรัพยากร channel และ video และคุณยังใช้พารามิเตอร์การค้นหา topicId เพื่อค้นหาช่องหรือวิดีโอที่เกี่ยวข้องกับหัวข้อหนึ่งๆ ได้ด้วย

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

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

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

    เรากำลังเลิกใช้งานพร็อพเพอร์ตี้ต่อไปนี้

    • พร็อพเพอร์ตี้ topicDetails.topicIds[] ของทรัพยากร channel พร็อพเพอร์ตี้นี้จะได้รับการสนับสนุนจนถึงวันที่ 10 พฤศจิกายน 2017
    • พร็อพเพอร์ตี้ topicDetails.relevantTopicIds[] ของทรัพยากร video พร็อพเพอร์ตี้นี้จะได้รับการสนับสนุนจนถึงวันที่ 10 พฤศจิกายน 2017
    • พร็อพเพอร์ตี้ topicDetails.topicIds[] ของทรัพยากร video พร็อพเพอร์ตี้นี้จะไม่มีค่าหลังจากวันที่ 10 กุมภาพันธ์ 2017 (หลังจากวันที่ดังกล่าว ค่าพร็อพเพอร์ตี้ topicDetails.relevantTopicIds[] จะระบุหัวข้อทั้งหมดที่เชื่อมโยงกับวิดีโอ)

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

    นอกจากนี้ เรายังนำตัวอย่างโค้ดหลายรายการที่เกี่ยวข้องกับรหัสหัวข้อออกจากเอกสารประกอบของเมธอด search.list ด้วย

2 พฤศจิกายน 2016

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

  • พร็อพเพอร์ตี้และพารามิเตอร์ใหม่

    • ทรัพยากร video มีพร็อพเพอร์ตี้ใหม่หลายรายการ ดังนี้

      • พร็อพเพอร์ตี้ player.embedHtml มีแท็ก <iframe> ที่คุณใช้ฝังเพลเยอร์ที่เล่นวิดีโอได้ พร็อพเพอร์ตี้ player.embedHeight และ player.embedWidth ใหม่จะระบุมิติข้อมูลของเพลเยอร์ที่ฝัง ระบบจะแสดงผลพร็อพเพอร์ตี้เหล่านี้ก็ต่อเมื่อคำขอ API ระบุค่าสำหรับพารามิเตอร์ maxHeight หรือ maxWidth อย่างน้อย 1 รายการ เราจะอธิบายพารามิเตอร์ใหม่ 2 รายการดังกล่าวในส่วนถัดไปของรายการประวัติการแก้ไขนี้

      • พร็อพเพอร์ตี้ hasCustomThumbnail ใหม่จะระบุว่าผู้อัปโหลดวิดีโอได้ระบุภาพปกวิดีโอที่ทำเองสำหรับวิดีโอหรือไม่ โปรดทราบว่ามีเพียงผู้อัปโหลดวิดีโอเท่านั้นที่จะเห็นพร็อพเพอร์ตี้นี้

      • fpbRatingReasons[] ใหม่จะระบุเหตุผลที่วิดีโอได้รับการจัดประเภทจาก FPB (แอฟริกาใต้)

      • mcstRating ใหม่จะระบุการจัดประเภทที่วิดีโอได้รับในเวียดนาม

    • เมธอด videos.list รองรับพารามิเตอร์ใหม่ 2 รายการ ได้แก่ maxHeight และ maxWidth คุณสามารถใช้พารามิเตอร์ใดพารามิเตอร์หนึ่งหรือทั้ง 2 พารามิเตอร์เมื่อดึงข้อมูลส่วน player ในทรัพยากร video

      โดยค่าเริ่มต้น ความสูงของ <iframe> ที่แสดงในพร็อพเพอร์ตี้ player.embedHtml คือ 360 พิกเซล ความกว้างจะปรับให้ตรงกับสัดส่วนภาพของวิดีโอ เพื่อให้มั่นใจว่าโปรแกรมเล่นวิดีโอที่ฝังไว้จะไม่มีแถบสีดำล้อมรอบวิดีโอ ตัวอย่างเช่น หากวิดีโอมีสัดส่วนภาพ 16:9 ความกว้างของเพลเยอร์จะเป็น 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 แล้ว การปรับปรุงครั้งนี้ยังมีเอกสารสนับสนุนหลายฉบับเพื่อช่วยอธิบายถึงนโยบายที่นักพัฒนาแอปต้องปฏิบัติตาม

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

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

    • ส่วน topicDetails ของทรัพยากร channel จะระบุหัวข้อที่เชื่อมโยงกับช่อง
    • ส่วน topicDetails ของทรัพยากร video จะระบุหัวข้อที่เชื่อมโยงกับวิดีโอ
    • พารามิเตอร์ topicId ของเมธอด search.list ช่วยให้คุณค้นหาวิดีโอหรือช่องที่เกี่ยวข้องกับหัวข้อที่เฉพาะเจาะจงได้

    การเปลี่ยนแปลงฟีเจอร์เหล่านี้มีดังนี้

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

    • คุณสามารถใช้รหัสหัวข้อ Freebase ที่ดึงข้อมูลมาแล้วเพื่อค้นหาเนื้อหาได้จนถึงวันที่ 10 กุมภาพันธ์ 2017 อย่างไรก็ตาม หลังจากนั้นคุณจะใช้ได้เฉพาะชุดหัวข้อที่เล็กลงซึ่งระบุไว้ในรายการก่อนหน้าเพื่อเรียกดูผลการค้นหาตามหัวข้อ

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

  • เราจะเลิกใช้งานช่องและพารามิเตอร์ API หลายรายการตั้งแต่วันที่ 12 กันยายน 2016 เป็นต้นไป

    • พารามิเตอร์ home ของเมธอด activities.list ช่วยให้ผู้ใช้ที่ได้รับอนุญาตสามารถดึงข้อมูลฟีดกิจกรรมที่จะแสดงในหน้าแรกของ YouTube สำหรับผู้ใช้รายนั้นได้ คำขอที่ใช้พารามิเตอร์นี้หลังจากวันที่ 12 กันยายน 2016 จะแสดงรายการที่ว่างเปล่า

    • พร็อพเพอร์ตี้ contentDetails.relatedPlaylists.watchHistory และ contentDetails.relatedPlaylists.watchLater ของทรัพยากร channel จะแสดงต่อผู้ใช้ที่ได้รับอนุญาตซึ่งดึงข้อมูลเกี่ยวกับช่องของผู้ใช้เองเท่านั้น หลังจากวันที่ 12 กันยายน 2016 contentDetails.relatedPlaylists.watchHistory จะแสดงผลค่าเป็น HL และพร็อพเพอร์ตี้ contentDetails.relatedPlaylists.watchLater จะแสดงผลค่าเป็น WL สำหรับทุกช่อง

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

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

13 มิถุนายน 2016

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

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

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

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

31 พฤษภาคม 2016

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

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

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

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

    • รูปภาพ standard มีความกว้าง 640 พิกเซลและสูง 480 พิกเซล
    • รูปภาพ maxres มีความกว้าง 1280 พิกเซลและสูง 720 พิกเซล

  • คำจำกัดความของพารามิเตอร์ part ของเมธอด channelSection.list ได้รับการอัปเดตเพื่อระบุว่าสามารถดึงข้อมูลส่วน targeting ได้โดยใช้โควต้า 2 หน่วย

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

17 พฤษภาคม 2016

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

เครื่องมือจะแสดงตัวอย่างโค้ดสําหรับ Use Case อย่างน้อย 1 รายการสําหรับแต่ละเมธอด ตัวอย่างเช่น มีข้อมูลโค้ด 5 รายการสำหรับเมธอด search.list ดังนี้

  • แสดงวิดีโอตามคีย์เวิร์ด
  • แสดงวิดีโอตามสถานที่ตั้ง
  • แสดงรายการกิจกรรมถ่ายทอดสด
  • ค้นหาวิดีโอของผู้ใช้ที่ตรวจสอบสิทธิ์แล้ว
  • แสดงวิดีโอที่เกี่ยวข้อง

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

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

28 เมษายน 2016

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

  • พร็อพเพอร์ตี้ contentDetails.projection ใหม่ของทรัพยากร video จะระบุรูปแบบการฉายภาพของวิดีโอ ค่าพร็อพเพอร์ตี้ที่ถูกต้องคือ 360 และ rectangular

  • พร็อพเพอร์ตี้ recordingDetails.location และ fileDetails.recordingLocation ของทรัพยากร video ได้รับการอัปเดตเพื่ออธิบายความแตกต่างระหว่างพร็อพเพอร์ตี้ทั้ง 2 รายการ ดังนี้

    • พร็อพเพอร์ตี้ recordingDetails.location จะระบุสถานที่ตั้งที่เจ้าของวิดีโอต้องการเชื่อมโยงกับวิดีโอ คุณสามารถแก้ไขสถานที่ตั้งนี้ ค้นหาได้ในวิดีโอสาธารณะ และอาจแสดงต่อผู้ใช้สำหรับวิดีโอสาธารณะ
    • ค่าพร็อพเพอร์ตี้ fileDetails.recordingLocation เปลี่ยนแปลงไม่ได้และแสดงถึงตำแหน่งที่เชื่อมโยงกับไฟล์วิดีโอต้นฉบับที่อัปโหลด ค่านี้จะแสดงต่อเจ้าของวิดีโอเท่านั้น

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

  • คำจำกัดความของข้อผิดพลาด ineligibleAccount ซึ่งอาจแสดงผลโดยเมธอด comments.insert, comments.update, commentThreads.insert หรือ commentThreads.update ได้รับการอัปเดตเพื่อแสดงให้เห็นว่าข้อผิดพลาดเกิดขึ้นเมื่อบัญชี YouTube ที่ใช้ในการให้สิทธิ์คำขอ API ไม่ได้รวมเข้ากับบัญชี Google ของผู้ใช้

20 เมษายน 2016

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

  • คำจำกัดความของพารามิเตอร์ part ของเมธอด channels.update ได้รับการอัปเดตเพื่อระบุว่า localizations เป็นค่าที่ถูกต้องสำหรับพารามิเตอร์นั้นด้วย

  • ส่วนการใช้โควต้าของคู่มือเริ่มต้นใช้งานได้รับการอัปเดตให้ลิงก์ไปยัง Google Developer's Console ซึ่งคุณจะดูโควต้าและการใช้โควต้าจริงได้

16 มีนาคม 2016

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

  • การอัปเดตทรัพยากรและเมธอดที่มีอยู่

    • เราได้อัปเดตเอกสารประกอบเกี่ยวกับทรัพยากร channelBanner เพื่อระบุว่าขนาดที่แนะนำสำหรับรูปภาพแบนเนอร์ของช่องที่อัปโหลดคือ 2560 x 1440 พิกเซล ขนาดขั้นต่ำ (2048 x 1152 พิกเซล) ไม่มีการเปลี่ยนแปลง

    • พร็อพเพอร์ตี้ snippet.customUrl ใหม่ของทรัพยากร channel จะระบุ URL ที่กำหนดเองซึ่งเชื่อมโยงกับช่อง (บางช่องอาจไม่มี URL ที่กำหนดเอง) ศูนย์ช่วยเหลือของ YouTube จะอธิบายข้อกำหนดของการได้รับสิทธิ์รับ URL ที่กำหนดเอง รวมถึงวิธีตั้งค่า URL

    • ออบเจ็กต์ brandingSettings.watch ของทรัพยากร channel และพร็อพเพอร์ตี้ย่อยทั้งหมดเลิกใช้งานแล้ว

    • ตอนนี้การตอบกลับจาก API ต่อคำขอ search.list จะมีพร็อพเพอร์ตี้ regionCode พร็อพเพอร์ตี้จะระบุรหัสภูมิภาคที่ใช้สำหรับคำค้นหา รหัสภูมิภาคจะสั่งให้ API แสดงผลการค้นหาสำหรับประเทศที่ระบุ

      ค่าพร็อพเพอร์ตี้คือรหัสประเทศ ISO แบบ 2 ตัวอักษรที่ระบุภูมิภาค เมธอด i18nRegions.list จะแสดงรายการภูมิภาคที่รองรับ ค่าเริ่มต้นคือ US หากระบุภูมิภาคที่ไม่รองรับ YouTube อาจยังคงเลือกภูมิภาคอื่นแทนค่าเริ่มต้นเพื่อจัดการคำค้นหา

    • คำจำกัดความของพร็อพเพอร์ตี้ snippet.label และ snippet.secondaryReasons[].label ของทรัพยากร videoAbuseReportReason ได้รับการอัปเดตเพื่อระบุว่าพร็อพเพอร์ตี้มีข้อความป้ายกำกับที่แปลแล้วสำหรับเหตุผลในการรายงานการละเมิด

      นอกจากนี้ เมธอด videoAbuseReportReasons.list ยังรองรับพารามิเตอร์ hl ซึ่งระบุภาษาที่ควรใช้สำหรับข้อความป้ายกำกับในการตอบกลับจาก API ค่าพารามิเตอร์เริ่มต้นคือ en_US

    • พร็อพเพอร์ตี้ contentDetails.contentRating.ecbmctRating ใหม่ของทรัพยากร video จะระบุการจัดประเภทของวิดีโอจากคณะกรรมการการประเมินและการจัดประเภทของกระทรวงวัฒนธรรมและการท่องเที่ยวของตุรกี

      นอกจากนี้ พร็อพเพอร์ตี้ API สำหรับระบบการจัดประเภทอื่นๆ ยังรองรับค่าพร็อพเพอร์ตี้ใหม่ต่อไปนี้ด้วย

      • contentDetails.contentRating.fpbRating (แอฟริกาใต้)
        การจัดประเภท: 10 ค่าพร็อพเพอร์ตี้: fpb10
      • contentDetails.contentRating.moctwRating (ไต้หวัน)
        การจัดประเภท: R-12 ค่าพร็อพเพอร์ตี้: moctwR12
      • contentDetails.contentRating.moctwRating (ไต้หวัน)
        การจัดประเภท: R-15 ค่าพร็อพเพอร์ตี้: moctwR15

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

    • พร็อพเพอร์ตี้ status.rejectionReason ของทรัพยากร video รองรับค่าพร็อพเพอร์ตี้ใหม่ legal

  • API รองรับข้อผิดพลาดใหม่ต่อไปนี้

    ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
    badRequest (400) notEditable เมธอด channelSections.insert, channelSections.update และ channelSections.delete จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าไม่สามารถสร้าง อัปเดต หรือลบส่วนของช่องที่ระบุได้
    badRequest (400) styleRequired เมธอด channelSections.insert และ channelSections.update จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าทรัพยากร channelSection ที่ส่งในคำขอ API ต้องระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.style
    badRequest (400) typeRequired เมธอด channelSections.insert และ channelSections.update จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าทรัพยากร channelSection ที่ส่งในคำขอ API ต้องระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.type
    badRequest (400) processingFailure เมธอด commentThreads.list จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าเซิร์ฟเวอร์ API ประมวลผลคำขอไม่สำเร็จ แม้ว่าข้อผิดพลาดนี้อาจเป็นข้อผิดพลาดชั่วคราว แต่โดยปกติแล้วจะบ่งชี้ว่าอินพุตของคำขอไม่ถูกต้อง ตรวจสอบโครงสร้างของทรัพยากร commentThread ในเนื้อหาคำขอเพื่อให้แน่ใจว่าถูกต้อง
    forbidden (403) commentsDisabled เมธอด commentThreads.list จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าวิดีโอที่ระบุโดยพารามิเตอร์ videoId ได้ปิดใช้ความคิดเห็น
    badRequest (400) commentTextTooLong เมธอด commentThreads.insert จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าทรัพยากร comment ที่กำลังแทรกมีอักขระมากเกินไปในพร็อพเพอร์ตี้ snippet.topLevelComment.snippet.textOriginal
    invalidValue (400) videoAlreadyInAnotherSeriesPlaylist เมธอด playlistItems.insert จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าวิดีโอที่คุณพยายามเพิ่มลงในเพลย์ลิสต์อยู่ในรายการซีรีส์อื่นแล้ว ดูข้อมูลเพิ่มเติมเกี่ยวกับรายการซีรีส์ได้ที่ศูนย์ช่วยเหลือของ YouTube
    badRequest (400) subscriptionForbidden เมธอด subscriptions.insert จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าคุณมีการติดตามถึงจำนวนสูงสุดแล้ว หรือคุณสร้างการติดตามล่าสุดมากเกินไป ในกรณีหลัง คุณสามารถลองส่งคำขออีกครั้งหลังจากผ่านไป 2-3 ชั่วโมง
    badRequest (400) invalidCategoryId เมธอด videos.update จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้ snippet.categoryId ในทรัพยากร video ที่อัปโหลดระบุรหัสหมวดหมู่ที่ไม่ถูกต้อง ใช้เมธอด videoCategories.list เพื่อดึงข้อมูลหมวดหมู่ที่รองรับ
    badRequest (400) invalidDescription เมธอด videos.update จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้ snippet.description ในทรัพยากร video ที่อัปโหลดระบุค่าที่ไม่ถูกต้อง
    badRequest (400) invalidPublishAt เมธอด videos.update จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้ status.publishAt ในทรัพยากร video ที่อัปโหลดระบุเวลาเผยแพร่ที่กำหนดเวลาไว้ไม่ถูกต้อง
    badRequest (400) invalidRecordingDetails เมธอด videos.update จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าออบเจ็กต์ recordingDetails ในทรัพยากร video ที่อัปโหลดระบุรายละเอียดการบันทึกที่ไม่ถูกต้อง
    badRequest (400) invalidTags เมธอด videos.update จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้ snippet.tags ในทรัพยากร video ที่อัปโหลดระบุค่าที่ไม่ถูกต้อง
    badRequest (400) invalidTitle เมธอด videos.update จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าพร็อพเพอร์ตี้ snippet.title ในทรัพยากร video ที่อัปโหลดระบุชื่อวิดีโอที่ไม่ถูกต้องหรือว่างเปล่า
    badRequest (400) invalidVideoMetadata เมธอด videos.update จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าข้อมูลเมตาของคำขอไม่ถูกต้อง ข้อผิดพลาดนี้จะเกิดขึ้นหากคำขออัปเดตส่วน snippet ของทรัพยากร video แต่ไม่ได้ตั้งค่าสำหรับทั้งพร็อพเพอร์ตี้ snippet.title และ snippet.categoryId

18 ธันวาคม 2015

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

19 พฤศจิกายน 2015

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

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

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

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

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

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

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

      {
  "kind": "youtube#video",
  ...
  "snippet": {
    "title": "Playing soccer",
    "description": "We play soccer in the park on Sundays.",
    "defaultLanguage": "en",
    ...
  },
  "localizations":
    "de": {
      "title": "Fußball spielen",
      "description": "Wir spielen Fußball im Park am Sonntag"
    },
    "es": {
      "title": "Jugar al fútbol",
      "description": "Nosotros jugamos fútbol en el parque los domingos",
    }
  }
}

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

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

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

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

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

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

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

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

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

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

  • ข้อผิดพลาดที่เกี่ยวข้องกับค่าข้อความที่แปลแล้ว

    นอกจากนี้ API ยังรองรับข้อผิดพลาดใหม่ต่อไปนี้สำหรับค่าข้อความที่แปลแล้ว

    ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
    badRequest (400) defaultLanguageNotSetError ข้อผิดพลาดนี้บ่งชี้ว่าคำขอที่พยายามแทรกหรืออัปเดตออบเจ็กต์ localizations สำหรับทรัพยากรไม่สำเร็จเนื่องจากไม่ได้ตั้งค่าพร็อพเพอร์ตี้ snippet.defaultLanguage สำหรับทรัพยากรนั้น เมธอด channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert และ videos.update รองรับข้อผิดพลาดนี้
    badRequest (400) localizationValidationError ข้อผิดพลาดนี้แสดงว่าค่าใดค่าหนึ่งในออบเจ็กต์ localizations ของทรัพยากรไม่ผ่านการตรวจสอบ ตัวอย่างเช่น ข้อผิดพลาดนี้อาจเกิดขึ้นหากออบเจ็กต์มีรหัสภาษาที่ไม่ถูกต้อง เมธอด channels.update, channelSections.insert, channelSections.update, playlists.insert และ playlists.update รองรับข้อผิดพลาดนี้

4 พฤศจิกายน 2015

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

  • การอัปเดตทรัพยากรและเมธอดที่มีอยู่

    • พารามิเตอร์ order ของเมธอด search.list ได้รับการอัปเดตเพื่อระบุว่าหากคุณจัดเรียงการถ่ายทอดสดตาม viewCount ผลลัพธ์ของ API จะจัดเรียงตามจำนวนผู้ชมที่ดูการถ่ายทอดสดพร้อมกันขณะที่การถ่ายทอดสดยังคงดำเนินอยู่

    • พารามิเตอร์ relatedToVideoId ของเมธอด search.list ได้รับการอัปเดตเพื่อระบุว่าหากมีการตั้งค่าพารามิเตอร์ พารามิเตอร์อื่นๆ ที่รองรับจะมีเพียง part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (ซึ่งต้องตั้งค่าเป็น video) และ fields การอัปเดตนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานของ API

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

      การเปลี่ยนแปลงนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานของ API

    • คำจำกัดความของพร็อพเพอร์ตี้ status.publishAt ของทรัพยากร video ได้รับการอัปเดตเพื่อระบุว่า

      • หากตั้งค่าของพร็อพเพอร์ตี้นี้เมื่อเรียกใช้เมธอด videos.update คุณต้องตั้งค่าพร็อพเพอร์ตี้ status.privacyStatus เป็น private ด้วย แม้ว่าวิดีโอจะเป็นแบบส่วนตัวอยู่แล้วก็ตาม
      • หากคำขอกำหนดเวลาให้เผยแพร่วิดีโอในอดีต ระบบจะเผยแพร่วิดีโอทันที ดังนั้น ผลของการตั้งค่าพร็อพเพอร์ตี้ status.publishAt เป็นวันที่และเวลาในอดีตจึงเหมือนกับการเปลี่ยน privacyStatus ของวิดีโอจาก private เป็น public

    • พร็อพเพอร์ตี้ contentDetails.contentRating.cncRating ของทรัพยากร video ระบุการจัดประเภทของวิดีโอจาก Commission de classification cinematographique ของฝรั่งเศส พร็อพเพอร์ตี้นี้จะแทนที่พร็อพเพอร์ตี้ contentDetails.contentRating.fmocRating ซึ่งเลิกใช้งานแล้ว

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

    • เอกสารประกอบสำหรับเมธอด thumbnails.set ได้รับการอัปเดตเพื่อให้แสดงอย่างถูกต้องว่าเนื้อความของคำขอมีภาพปกที่คุณกำลังอัปโหลดและเชื่อมโยงกับวิดีโอ เนื้อความของคำขอไม่มีทรัพยากร thumbnail ก่อนหน้านี้ เอกสารระบุว่าคุณไม่ควรระบุเนื้อหาคำขอเมื่อเรียกใช้เมธอดนี้ การอัปเดตนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานของ API

    • คำอธิบายของทรัพยากร activity ได้รับการอัปเดตเพื่อแสดงให้เห็นว่าเมธอด activities.list ไม่รวมทรัพยากรที่เกี่ยวข้องกับความคิดเห็นใหม่ในวิดีโอในขณะนี้ snippet.type และ contentDetails.comment ของทรัพยากรได้รับการอัปเดตแล้วเช่นกัน

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

    • ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว

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

28 สิงหาคม 2015

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

  • การอัปเดตทรัพยากรและเมธอดที่มีอยู่

    • เลิกใช้งานพร็อพเพอร์ตี้ statistics.favoriteCount ของทรัพยากร video แล้ว

      เพื่อให้เป็นไปตามนโยบายการเลิกใช้งาน พร็อพเพอร์ตี้นี้จะยังคงรวมอยู่ในทรัพยากร video เป็นเวลาอย่างน้อย 1 ปีหลังจากประกาศนี้ อย่างไรก็ตาม ตอนนี้ค่าพร็อพเพอร์ตี้จะตั้งค่าเป็น 0 เสมอ

7 สิงหาคม 2015

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

  • การอัปเดตทรัพยากรและเมธอดที่มีอยู่

    • คำจำกัดความของพร็อพเพอร์ตี้ snippet.tags[] ของทรัพยากร video ได้รับการอัปเดตเพื่อให้ข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่เซิร์ฟเวอร์ API คำนวณความยาวของค่าของพร็อพเพอร์ตี้ โปรดทราบว่าการอัปเดตนี้ไม่ได้แสดงถึงการเปลี่ยนแปลงลักษณะการทำงานของ API

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

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

18 มิถุนายน 2015

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

  • การอัปเดตทรัพยากรและเมธอดที่มีอยู่

    • พารามิเตอร์ order ใหม่ของเมธอด commentThreads.list จะระบุลำดับที่การตอบกลับจาก API ควรแสดงชุดความคิดเห็น คุณสามารถจัดเรียงชุดข้อความตามเวลาหรือความเกี่ยวข้องได้ ลักษณะการทำงานเริ่มต้นคือการจัดเรียงตามเวลา

    • พร็อพเพอร์ตี้ snippet.defaultAudioLanguage ใหม่ของทรัพยากร video จะระบุภาษาที่พูดในแทร็กเสียงเริ่มต้นของวิดีโอ

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

    • ตอนนี้เมธอด captions.delete, captions.download, captions.insert, captions.list และ captions.update รองรับพารามิเตอร์ onBehalfOfContentOwner ซึ่งรองรับเมธอดอื่นๆ อีกหลายเมธอดอยู่แล้ว คำขอที่ใช้วิธีการดังกล่าวต้องได้รับสิทธิ์ด้วยโทเค็นที่ให้สิทธิ์เข้าถึงขอบเขต https://www.googleapis.com/auth/youtubepartner ด้วย

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

    • ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว

      รายละเอียดข้อผิดพลาด
      videos.rate
      โค้ดตอบกลับ HTTPbadRequest (400)
      เหตุผลemailNotVerified
      คำอธิบายผู้ใช้ต้องยืนยันอีเมลก่อนให้คะแนนวิดีโอ
      videos.rate
      โค้ดตอบกลับ HTTPbadRequest (400)
      เหตุผลvideoPurchaseRequired
      คำอธิบายมีเพียงผู้ใช้ที่เช่าวิดีโอเท่านั้นที่จะให้คะแนนวิดีโอที่เช่าได้

    • เมธอด subscriptions.delete และ subscriptions.insert ไม่รองรับข้อผิดพลาด accountClosed และ accountSuspended อีกต่อไป

27 เมษายน 2015

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

  • แหล่งข้อมูลและวิธีการใหม่ๆ

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

    • เมธอด videos.reportAbuse ใหม่ช่วยให้คุณแจ้งว่าวิดีโอมีเนื้อหาที่เป็นการละเมิดได้จริงๆ ส่วนเนื้อหาของคำขอจะมีออบเจ็กต์ JSON ที่ระบุวิดีโอที่ถูกแจ้งว่าไม่เหมาะสม รวมถึงเหตุผลที่วิดีโอดังกล่าวถือว่ามีเนื้อหาที่เป็นการละเมิด คุณสามารถดูเหตุผลที่ถูกต้องได้จากเมธอด videoAbuseReportReason.list ที่อธิบายไว้ข้างต้น

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

  • การอัปเดตทรัพยากรและเมธอดที่มีอยู่

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

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

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

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

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

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

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

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

    • คำจำกัดความของพร็อพเพอร์ตี้ 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

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

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

    นอกจากนี้ คู่มือยังระบุถึงฟีเจอร์การแสดงความคิดเห็นหลายรายการที่ v2 API ไม่รองรับ แต่รองรับใน v3 API ซึ่งได้แก่

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

  • เราได้อัปเดตคู่มือการสมัครรับข้อความ Push เพื่อให้สอดคล้องกับข้อเท็จจริงที่ว่าระบบจะส่งข้อความ Push ไปยังฮับ Google PubSubHubBub เท่านั้น และจะไม่ส่งไปยังฮับ Superfeedr ตามที่ระบุไว้ก่อนหน้านี้

9 เมษายน 2015

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

  • ทรัพยากร commentThread และ comment ใหม่ของ API ช่วยให้คุณเรียกข้อมูล แทรก อัปเดต ลบ และดูแลความคิดเห็นได้

    • ทรัพยากร commentThread มีข้อมูลเกี่ยวกับชุดความคิดเห็นของ YouTube ซึ่งประกอบด้วยความคิดเห็นระดับบนสุดและการตอบกลับความคิดเห็นนั้น (หากมี) ทรัพยากร commentThread สามารถแสดงความคิดเห็นเกี่ยวกับวิดีโอหรือช่องก็ได้

      ความคิดเห็นระดับบนสุดและการตอบกลับเป็นทรัพยากร comment ที่ซ้อนอยู่ภายในทรัพยากร commentThread โปรดทราบว่าทรัพยากร commentThread ไม่จำเป็นต้องมีการตอบกลับทั้งหมดสำหรับความคิดเห็น และคุณต้องใช้เมธอด comments.list หากต้องการดึงข้อมูลการตอบกลับทั้งหมดสำหรับความคิดเห็นหนึ่งๆ นอกจากนี้ ความคิดเห็นบางรายการอาจไม่มีการตอบกลับ

      API รองรับเมธอดต่อไปนี้สำหรับทรัพยากร commentThread

      • commentThreads.list – ดึงข้อมูลรายการชุดความคิดเห็น ใช้วิธีนี้เพื่อดึงข้อมูลความคิดเห็นที่เชื่อมโยงกับวิดีโอหรือช่องที่เฉพาะเจาะจง
      • commentThreads.insert – สร้างความคิดเห็นระดับบนสุดใหม่ (ใช้วิธี comments.insert เพื่อตอบกลับความคิดเห็นที่มีอยู่)
      • commentThreads.update – แก้ไขความคิดเห็นระดับบนสุด

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

      API รองรับเมธอดต่อไปนี้สำหรับทรัพยากร comment

      • comments.list – ดึงข้อมูลรายการความคิดเห็น ใช้วิธีนี้เพื่อดึงข้อมูลการตอบกลับทั้งหมดของความคิดเห็นหนึ่งๆ
      • comments.insert – สร้างการตอบกลับความคิดเห็นที่มีอยู่
      • comments.update – แก้ไขความคิดเห็น
      • comments.markAsSpam – แจ้งว่าความคิดเห็นอย่างน้อย 1 รายการเป็นสแปม
      • comments.setModerationStatus – ตั้งค่าสถานะการดูแลความคิดเห็นอย่างน้อย 1 รายการ เช่น ล้างความคิดเห็นเพื่อแสดงต่อสาธารณะ หรือปฏิเสธความคิดเห็นเนื่องจากไม่เหมาะที่จะแสดง คำขอ API ต้องได้รับสิทธิ์จากเจ้าของช่องหรือวิดีโอที่เชื่อมโยงกับความคิดเห็น
      • comments.delete – ลบความคิดเห็น

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

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

    • อัปโหลดวิดีโอ
    • อัปเดตชื่อวิดีโอ
    • อัปเดตคำอธิบายของวิดีโอ

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

  • ตอนนี้ขอบเขต https://www.googleapis.com/auth/youtube.force-ssl ใหม่ของ API เป็นขอบเขตที่ถูกต้องสำหรับเมธอด API ใดๆ ที่ก่อนหน้านี้รองรับขอบเขต https://www.googleapis.com/auth/youtube

  • ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว

    ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
    badRequest (400) invalidRating เมธอด videos.rate จะแสดงข้อผิดพลาดนี้หากคำขอมีค่าที่ไม่คาดคิดสำหรับพารามิเตอร์ rating

  • เมธอด subscriptions.insert ไม่รองรับข้อผิดพลาด subscriptionLimitExceeded อีกต่อไป ซึ่งก่อนหน้านี้ระบุว่าผู้สมัครใช้บริการที่ระบุในคำขอได้ใช้เกินขีดจำกัดอัตราการสมัครใช้บริการแล้ว

2 เมษายน 2015

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

  • ทรัพยากร captions ใหม่แสดงถึงแทร็กคำบรรยายแทนเสียงของ YouTube แทร็กคำบรรยายแทนเสียงจะเชื่อมโยงกับวิดีโอ YouTube เพียงรายการเดียวเท่านั้น

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

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

  • ขอบเขต https://www.googleapis.com/auth/youtube.force-ssl ใหม่ของ API กำหนดให้การสื่อสารกับเซิร์ฟเวอร์ API ต้องเกิดขึ้นผ่านการเชื่อมต่อ SSL

    ขอบเขตใหม่นี้ให้สิทธิ์เข้าถึงเหมือนกับขอบเขต https://www.googleapis.com/auth/youtube และที่จริงแล้ว ขอบเขตทั้ง 2 นี้มีฟังก์ชันการทำงานเหมือนกันเนื่องจากเซิร์ฟเวอร์ API ของ YouTube พร้อมใช้งานผ่านปลายทาง HTTPS เท่านั้น ด้วยเหตุนี้ แม้ว่าขอบเขต https://www.googleapis.com/auth/youtube จะไม่จำเป็นต้องใช้การเชื่อมต่อ SSL แต่ก็ไม่มีวิธีอื่นในการส่งคำขอ API

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

11 มีนาคม 2015

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

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

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

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

    • ดึงข้อมูลวิดีโอแนะนำ – 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 จะรองรับข้อความ Push โดยใช้โปรโตคอล PubSubHubbub แต่การแจ้งเตือนจะครอบคลุมเฉพาะการอัปโหลดวิดีโอและการอัปเดตชื่อหรือคำอธิบายวิดีโอเท่านั้น

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

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

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

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

      โดยมีข้อยกเว้นบางประการ ระบบจะเพิ่มวิดีโอที่อัปโหลดใหม่ วิดีโอโปรด วิดีโอที่ชอบ หรือวิดีโอที่ดูล่าสุดเป็นรายการแรก (snippet.position=0) โดยอัตโนมัติสำหรับเพลย์ลิสต์ประเภทต่อไปนี้ ดังนั้น รายการเหล่านี้แต่ละรายการจะจัดเรียงตามลำดับจากรายการใหม่ที่สุดไปเก่าที่สุดตามเวลาที่เพิ่มรายการลงในรายการอย่างมีประสิทธิภาพ

      • การอัปโหลดของผู้ใช้
      • วิดีโอโปรด
      • วิดีโอที่ชอบ
      • ประวัติการดู

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

    • การประมวลผลแบบกลุ่ม - API เวอร์ชัน 3 รองรับ Use Case การประมวลผลแบบกลุ่มรายการหนึ่งที่ API เวอร์ชัน 2 รองรับ เมธอด 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) เพื่อระบุการเลิกใช้งานฟีดพิเศษและช่องข้อมูลเมตาที่ API เวอร์ชัน 2 มีให้สำหรับการอธิบายภาพยนตร์ ตัวอย่างภาพยนตร์ รายการทีวี ซีซันของรายการทีวี และตอนของรายการทีวี

14 มกราคม 2015

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

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

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

  • เอกสารประกอบสำหรับเมธอด 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 ซึ่งระบุการจัดประเภทของวิดีโอจากสำนักงานการจัดประเภทภาพยนตร์และวรรณกรรมของนิวซีแลนด์ (Office of Film and Literature Classification) รองรับการจัดประเภทใหม่ 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 คู่มือนี้มีจุดประสงค์เพื่อช่วยคุณย้ายข้อมูลแอปพลิเคชันที่ยังคงใช้ v2 API ไปยัง API เวอร์ชันล่าสุด

8 กรกฎาคม 2014

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

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

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

18 มิถุนายน 2014

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

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

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

  • ตอนนี้ทรัพยากร video รองรับระบบการจัดประเภทเนื้อหาใหม่ 43 ระบบ ซึ่งจะระบุการจัดประเภทที่วิดีโอได้รับจากหน่วยงานจัดประเภทระดับประเทศต่างๆ Glossary received. I will use these as hints for our translations.

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 จะระบุการจัดประเภทที่วิดีโอได้รับจาก Irish Film Classification Office

  • คำจำกัดความของพร็อพเพอร์ตี้ position.cornerPosition ของทรัพยากร watermark ได้รับการอัปเดตเพื่อระบุว่าลายน้ำจะปรากฏที่มุมขวาบนของเพลเยอร์เสมอ

  • คำจำกัดความของพารามิเตอร์ q สำหรับเมธอด search.list ได้รับการอัปเดตเพื่อระบุว่าคำค้นหาสามารถใช้โอเปอเรเตอร์ NOT (-) แบบบูลีนเพื่อยกเว้นวิดีโอที่เชื่อมโยงกับข้อความค้นหาหนึ่งๆ ได้ นอกจากนี้ ค่าดังกล่าวยังใช้โอเปอเรเตอร์บูลีน OR (|) เพื่อค้นหาวิดีโอที่เชื่อมโยงกับข้อความค้นหาอย่างน้อย 1 รายการได้ด้วย

  • คำจำกัดความของพร็อพเพอร์ตี้ 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 ต้องระบุออบเจ็กต์ 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 ซึ่งได้แก่ พารามิเตอร์ eventType ของเมธอด search.list และพร็อพเพอร์ตี้ snippet.liveBroadcastContent ของผลการค้นหา

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

  • รายการพร็อพเพอร์ตี้ที่แก้ไขได้เมื่อเรียกใช้เมธอด channels.update ได้รับการอัปเดตให้รวมพร็อพเพอร์ตี้ invideoPromotion.items[].customMessage และ invideoPromotion.items[].websiteUrl นอกจากนี้ เรายังแก้ไขรายการเพื่อระบุพร็อพเพอร์ตี้ brandingSettings ที่แก้ไขได้ พร็อพเพอร์ตี้ brandingSettings เหล่านี้แก้ไขได้อยู่แล้ว ดังนั้นการเปลี่ยนแปลงเอกสารประกอบจึงไม่ได้แสดงถึงการเปลี่ยนแปลงฟังก์ชันการทำงานที่มีอยู่ของ API

  • ตอนนี้เมธอด playlists.insert, playlists.update และ playlists.delete รองรับพารามิเตอร์ onBehalfOfContentOwner ซึ่งรองรับเมธอดอื่นๆ อีกหลายรายการอยู่แล้ว

  • ตอนนี้เมธอด playlists.insert รองรับพารามิเตอร์ onBehalfOfContentOwnerChannel แล้ว ซึ่งเมธอดอื่นๆ อีกหลายรายการรองรับอยู่แล้ว

  • ตอนนี้พร็อพเพอร์ตี้ contentDetails.contentRating.tvpgRating ของทรัพยากร video รองรับค่า pg14 ซึ่งสอดคล้องกับการจัดประเภท TV-14 แล้ว

  • คำจำกัดความของพร็อพเพอร์ตี้ snippet.liveBroadcastContent ซึ่งเป็นส่วนหนึ่งของผลการค้นหาได้รับการแก้ไขเพื่อให้สอดคล้องกับข้อเท็จจริงที่ว่า live เป็นค่าพร็อพเพอร์ตี้ที่ถูกต้อง แต่ active ไม่ใช่ค่าพร็อพเพอร์ตี้ที่ถูกต้อง

  • ตอนนี้พร็อพเพอร์ตี้ contentDetails.contentRating.mibacRating ของทรัพยากร video รองรับการจัดประเภทเพิ่มเติม 2 รายการ ได้แก่

    • mibacVap (VAP) – เด็กควรมีผู้ใหญ่รับชมด้วย
    • mibacVm6 (V.M.6) – จำกัดเฉพาะผู้ชมอายุตั้งแต่ 6 ปีขึ้นไป
    • mibacVm12 (V.M.12) – จำกัดเฉพาะผู้ชมอายุตั้งแต่ 12 ปีขึ้นไป

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

1 ตุลาคม 2013

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

  • ออบเจ็กต์ auditDetails ใหม่ของทรัพยากร channel มีข้อมูลช่องที่เครือข่ายแบบหลายช่อง (MCN) จะประเมินขณะพิจารณาว่าจะยอมรับหรือปฏิเสธช่องหนึ่งๆ โปรดทราบว่าคำขอ API ที่ดึงข้อมูลส่วนทรัพยากรนี้ต้องระบุโทเค็นการให้สิทธิ์ที่มีขอบเขต https://www.googleapis.com/auth/youtubepartner-channel-audit นอกจากนี้ โทเค็นที่ใช้ขอบเขตดังกล่าวต้องถูกเพิกถอนเมื่อ MCN ตัดสินใจยอมรับหรือปฏิเสธช่อง หรือภายใน 2 สัปดาห์นับจากวันที่ออกโทเค็น

  • ตอนนี้พร็อพเพอร์ตี้ invideoPromotion.items[].id.type ของทรัพยากร channel รองรับค่า recentUpload ซึ่งบ่งชี้ว่ารายการที่โปรโมตเป็นวิดีโอที่อัปโหลดล่าสุดจากช่องที่ระบุ

    โดยค่าเริ่มต้น ช่องจะเป็นช่องเดียวกับที่มีการตั้งค่าข้อมูลโปรโมชันในวิดีโอ อย่างไรก็ตาม คุณสามารถโปรโมตวิดีโอที่อัปโหลดล่าสุดจากช่องอื่นได้โดยตั้งค่าพร็อพเพอร์ตี้ invideoPromotion.items[].id.recentlyUploadedBy ใหม่เป็นรหัสช่องของช่องนั้น

  • ทรัพยากร channel มีพร็อพเพอร์ตี้ใหม่ 3 รายการ ได้แก่ brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl, brandingSettings.image.bannerTvHighImageUrl ซึ่งระบุ URL สำหรับรูปภาพแบนเนอร์ที่แสดงในหน้าช่องในแอปพลิเคชันโทรทัศน์

  • พร็อพเพอร์ตี้ snippet.liveBroadcastContent ใหม่ในผลการค้นหาจะระบุว่าแหล่งข้อมูลวิดีโอหรือช่องมีเนื้อหาการถ่ายทอดสดหรือไม่ ค่าพร็อพเพอร์ตี้ที่ถูกต้องคือ upcoming, active และ none

    • สำหรับทรัพยากร video ค่า upcoming บ่งชี้ว่าวิดีโอเป็นการถ่ายทอดสดที่ยังไม่เริ่ม ในขณะที่ค่า active บ่งชี้ว่าวิดีโอเป็นการถ่ายทอดสดที่กำลังดำเนินอยู่
    • สำหรับทรัพยากร channel ค่า upcoming บ่งชี้ว่าช่องมีการถ่ายทอดสดที่กำหนดเวลาไว้ซึ่งยังไม่เริ่ม ขณะที่ค่า acive บ่งชี้ว่าช่องมีการถ่ายทอดสดที่กำลังดำเนินอยู่

  • ในทรัพยากร watermark พร็อพเพอร์ตี้ targetChannelId เปลี่ยนจากออบเจ็กต์เป็นสตริง พร็อพเพอร์ตี้ targetChannelId จะระบุค่าดังกล่าวเอง แทนที่จะมีพร็อพเพอร์ตี้ย่อยที่ระบุรหัสช่อง YouTube ของช่องที่ลิงก์กับรูปภาพลายน้ำ ด้วยเหตุนี้ ระบบจึงนำพร็อพเพอร์ตี้ targetChannelId.value ของทรัพยากรออก

  • ตอนนี้เมธอด thumbnails.set รองรับพารามิเตอร์ onBehalfOfContentOwner แล้ว ซึ่งเมธอดอื่นๆ อีกหลายรายการรองรับอยู่แล้ว

  • ตอนนี้เมธอด search.list รองรับพารามิเตอร์ eventType ซึ่งจำกัดการค้นหาให้แสดงเฉพาะกิจกรรมการออกอากาศที่กำลังดำเนินอยู่ กำลังจะเกิดขึ้น หรือเสร็จสมบูรณ์แล้ว

  • พร็อพเพอร์ตี้ contentDetails.contentRating.mibacRating ใหม่จะระบุการจัดประเภทที่วิดีโอได้รับจาก Ministero dei Beni e delle Attivita Culturali e del Turismo ของอิตาลี

  • ตอนนี้ API รองรับข้อผิดพลาดต่อไปนี้แล้ว

    ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
    badRequest invalidImage เมธอด thumbnails.set จะแสดงข้อผิดพลาดนี้หากเนื้อหารูปภาพที่ระบุไม่ถูกต้อง
    forbidden videoRatingDisabled เมธอด videos.rate จะแสดงข้อผิดพลาดนี้หากเจ้าของวิดีโอที่ได้รับการให้คะแนนปิดใช้การให้คะแนนสำหรับวิดีโอดังกล่าว

27 สิงหาคม 2013

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

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

    เมธอด watermarks.set จะอัปโหลดและตั้งค่ารูปภาพลายน้ำของช่อง เมธอด watermarks.unset จะลบรูปภาพลายน้ำของช่อง

    เอกสารประกอบเกี่ยวกับข้อผิดพลาดจะอธิบายข้อความแสดงข้อผิดพลาดที่ API รองรับสำหรับเมธอด watermarks.set และ watermarks.unset โดยเฉพาะ

  • พร็อพเพอร์ตี้ statistics.hiddenSubscriberCount ใหม่ของทรัพยากร channel มีค่าบูลีนที่ระบุว่าจำนวนผู้ติดตามของช่องถูกซ่อนอยู่หรือไม่ ดังนั้น ค่าของพร็อพเพอร์ตี้จะเป็น false หากจำนวนผู้ติดตามของช่องปรากฏต่อสาธารณะ

  • ตอนนี้เมธอด playlists.list รองรับพารามิเตอร์ onBehalfOfContentOwner และ onBehalfOfContentOwnerChannel แล้ว ทั้ง 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 จะระบุสีที่โดดเด่นซึ่งช่วยเสริมเนื้อหาของช่อง ค่าพร็อพเพอร์ตี้คือเครื่องหมายแฮช (#) ตามด้วยสตริงเลขฐาน 16 จำนวน 6 อักขระ เช่น #2793e6

  • ตอนนี้ API รองรับความสามารถในการระบุว่าการติดตามมีไว้สำหรับกิจกรรมทั้งหมดของช่องหรือเฉพาะการอัปโหลดใหม่ พร็อพเพอร์ตี้ contentDetails.activityType ใหม่ของทรัพยากร subscription จะระบุประเภทกิจกรรมที่ผู้ติดตามจะได้รับการแจ้งเตือน ค่าพร็อพเพอร์ตี้ที่ถูกต้องคือ all และ uploads

  • เมธอด videos.list รองรับพารามิเตอร์ใหม่สำหรับการดึงข้อมูลอันดับวิดีโอที่ได้รับความนิยมมากที่สุดบน YouTube ดังนี้

    • พารามิเตอร์ chart จะระบุแผนภูมิที่คุณต้องการเรียกข้อมูล ปัจจุบันค่าที่รองรับมีเพียง mostPopular เท่านั้น โปรดทราบว่าพารามิเตอร์ chart เป็นพารามิเตอร์ตัวกรอง ซึ่งหมายความว่าไม่สามารถใช้ในคำขอเดียวกันกับพารามิเตอร์ตัวกรองอื่นๆ (id และ myRating)
    • พารามิเตอร์ videoCategoryId จะระบุหมวดหมู่วิดีโอที่ควรดึงข้อมูลอันดับ พารามิเตอร์นี้ใช้ร่วมกับพารามิเตอร์ chart ได้เท่านั้น โดยค่าเริ่มต้น แผนภูมิจะไม่จำกัดเฉพาะหมวดหมู่ใดหมวดหมู่หนึ่ง

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

  • พร็อพเพอร์ตี้ recordingDetails.location.elevation ของทรัพยากร video ได้รับการเปลี่ยนชื่อเป็น recordingDetails.location.altitude และพร็อพเพอร์ตี้ fileDetails.recordingLocation.location.elevation ได้รับการเปลี่ยนชื่อเป็น fileDetails.recordingLocation.location.altitude

  • ออบเจ็กต์ contentDetails.contentRating ของทรัพยากร video จะระบุการจัดประเภทที่วิดีโอได้รับภายใต้รูปแบบการจัดประเภทต่างๆ ซึ่งรวมถึงการจัดประเภท MPAA, การจัดประเภท TVPG และอื่นๆ ตอนนี้ API รองรับค่าการจัดประเภทที่ระบุว่าวิดีโอยังไม่ได้รับการจัดประเภทสำหรับระบบการจัดประเภทแต่ละระบบ โปรดทราบว่าสำหรับการจัดประเภทของ MPAA การจัดประเภท "ไม่มีการจัดประเภท" มักใช้เพื่อระบุภาพยนตร์เวอร์ชันที่ไม่มีการตัดต่อซึ่งภาพยนตร์เวอร์ชันที่ตัดต่อแล้วได้รับการจัดประเภทอย่างเป็นทางการ

  • พร็อพเพอร์ตี้ contentDetails.contentRating.ytRating ใหม่ของทรัพยากร video จะระบุเนื้อหาที่จำกัดอายุผู้ชม ค่าพร็อพเพอร์ตี้จะเป็น ytAgeRestricted หาก YouTube ระบุว่าวิดีโอมีเนื้อหาที่ไม่เหมาะสมสำหรับผู้ใช้ที่มีอายุต่ำกว่า 18 ปี หากไม่มีพร็อพเพอร์ตี้หรือค่าพร็อพเพอร์ตี้ว่างเปล่า แสดงว่าเนื้อหาไม่ได้ระบุว่ามีการจำกัดอายุผู้ชม

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

  • ตอนนี้เมธอด channelBanners.insert, channels.update, videos.getRating และ videos.rate รองรับพารามิเตอร์ onBehalfOfContentOwner ทั้งหมดแล้ว พารามิเตอร์ดังกล่าวระบุว่าผู้ใช้ที่ตรวจสอบสิทธิ์แล้วกำลังดำเนินการในนามของเจ้าของเนื้อหาที่ระบุไว้ในค่าพารามิเตอร์

  • เอกสารประกอบของเมธอด channels.update ได้รับการอัปเดตเพื่อแสดงให้เห็นว่าเมธอดดังกล่าวสามารถใช้เพื่ออัปเดตออบเจ็กต์ brandingSettings ของทรัพยากร channel และพร็อพเพอร์ตี้ย่อยได้ นอกจากนี้ เอกสารประกอบยังแสดงรายการพร็อพเพอร์ตี้ที่อัปเดตแล้วซึ่งคุณตั้งค่าสำหรับออบเจ็กต์ invideoPromotion ของทรัพยากร channel ได้

  • error documentation อธิบายข้อผิดพลาดใหม่ต่อไปนี้

    ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
    forbidden accountDelegationForbidden ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ซึ่งหมายความว่าผู้ใช้ที่ตรวจสอบสิทธิ์ไม่ได้รับอนุญาตให้ดำเนินการในนามของบัญชี Google ที่ระบุ
    forbidden authenticatedUserAccountClosed ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ซึ่งบ่งบอกว่าบัญชี YouTube ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วถูกปิด หากผู้ใช้ดำเนินการในนามของบัญชี Google อื่น ข้อผิดพลาดนี้จะระบุว่าบัญชีอื่นนั้นปิดอยู่
    forbidden authenticatedUserAccountSuspended ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ซึ่งบ่งบอกว่าบัญชี YouTube ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วถูกระงับ หากผู้ใช้ดำเนินการในนามของบัญชี Google อื่น ข้อผิดพลาดนี้จะระบุว่าบัญชีอื่นถูกระงับ
    forbidden authenticatedUserNotChannel ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ซึ่งหมายความว่าเซิร์ฟเวอร์ API ไม่สามารถระบุช่องที่เชื่อมโยงกับคำขอ API ได้ หากคำขอได้รับสิทธิ์และใช้พารามิเตอร์ onBehalfOfContentOwner คุณควรตั้งค่าพารามิเตอร์ onBehalfOfContentOwnerChannel ด้วย
    forbidden cmsUserAccountNotFound ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ผู้ใช้ CMS ไม่ได้รับอนุญาตให้ดำเนินการในนามของเจ้าของเนื้อหาที่ระบุ
    notFound contentOwnerAccountNotFound ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ไม่พบบัญชีเจ้าของเนื้อหาที่ระบุ
    badRequest invalidPart ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง พารามิเตอร์ part ของคำขอระบุส่วนที่ไม่สามารถเขียนพร้อมกันได้
    badRequest videoChartNotFound เมธอด videos.list จะแสดงข้อผิดพลาดนี้เมื่อคำขอระบุแผนภูมิวิดีโอที่ไม่รองรับหรือไม่พร้อมใช้งาน
    notFound videoNotFound เมธอด videos.update จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าไม่พบวิดีโอที่คุณพยายามอัปเดต ตรวจสอบค่าของพร็อพเพอร์ตี้ id ในเนื้อหาคำขอเพื่อให้แน่ใจว่าถูกต้อง

10 มิถุนายน 2013

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

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

  • ตอนนี้เมธอด activities.list รองรับพารามิเตอร์ regionCode ซึ่งจะสั่งให้ API แสดงผลลัพธ์ที่เกี่ยวข้องกับประเทศที่ระบุ YouTube จะใช้ค่านี้เมื่อกิจกรรมก่อนหน้าของผู้ใช้ที่ได้รับอนุญาตใน YouTube มีข้อมูลไม่เพียงพอที่จะสร้างฟีดกิจกรรม

  • ตอนนี้ทรัพยากรเพลย์ลิสต์มีพร็อพเพอร์ตี้ snippet.tags แล้ว ระบบจะแสดงพร็อพเพอร์ตี้นี้แก่ผู้ใช้ที่ได้รับอนุญาตซึ่งกำลังดึงข้อมูลเกี่ยวกับเพลย์ลิสต์ของตนเองเท่านั้น ผู้ใช้ที่ได้รับอนุญาตยังสามารถตั้งค่าแท็กเพลย์ลิสต์เมื่อเรียกใช้เมธอด playlists.insert หรือ playlists.update ได้ด้วย

  • ตอนนี้พารามิเตอร์ onBehalfOfContentOwner ซึ่งก่อนหน้านี้รองรับเมธอด channels.list และ search.list จะรองรับเมธอด videos.insert, videos.update และ videos.delete ด้วย โปรดทราบว่าเมื่อใช้พารามิเตอร์นี้ในการเรียกใช้เมธอด videos.insert คำขอจะต้องระบุค่าสำหรับพารามิเตอร์ onBehalfOfContentOwnerChannel ใหม่ด้วย ซึ่งจะระบุช่องที่จะเพิ่มวิดีโอ ช่องต้องลิงก์กับเจ้าของเนื้อหาที่พารามิเตอร์ onBehalfOfContentOwner ระบุ

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

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

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

  • error documentation อธิบายข้อผิดพลาดใหม่ต่อไปนี้

    ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
    forbidden insufficientCapabilities ข้อผิดพลาดนี้ไม่ได้เจาะจงเฉพาะเมธอด API ใดเมธอดหนึ่ง ซึ่งบ่งบอกว่าผู้ใช้ CMS ที่เรียกใช้ API ไม่มีสิทธิ์เพียงพอที่จะดำเนินการตามที่ขอ ข้อผิดพลาดนี้เกี่ยวข้องกับการใช้พารามิเตอร์ onBehalfOfContentOwner ซึ่งรองรับเมธอด API หลายรายการ
    unauthorized authorizationRequired เมธอด activities.list จะแสดงข้อผิดพลาดนี้เมื่อคำขอใช้พารามิเตอร์ home แต่ไม่ได้รับสิทธิ์อย่างถูกต้อง

  • ในทรัพยากร channels ระบบได้นำพร็อพเพอร์ตี้ invideoPromotion.channelId ออกแล้วเนื่องจากมีการระบุรหัสช่องโดยใช้พร็อพเพอร์ตี้ id ของทรัพยากรแล้ว

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

22 พฤษภาคม 2013

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

  • เมธอด channelBanners.insert ใหม่ช่วยให้คุณอัปโหลดรูปภาพแบนเนอร์ที่สามารถตั้งค่าเป็นรูปภาพแบนเนอร์สำหรับช่องได้ในภายหลังโดยใช้พร็อพเพอร์ตี้ brandingSettings.image.bannerExternalUrl ใหม่ของทรัพยากร channel

  • เอกสารประกอบสำหรับเมธอด channels.update ได้รับการอัปเดตเพื่อแสดงรายการพร็อพเพอร์ตี้ที่แก้ไขได้เมื่อเรียกใช้เมธอด

  • เอกสารประกอบของทรัพยากร video จะไม่แสดง unspecified เป็นค่าพร็อพเพอร์ตี้ที่ถูกต้องสำหรับพร็อพเพอร์ตี้ suggestions.processingErrors[], suggestions.processingHints[], suggestions.processingWarnings[] และ suggestions.editorSuggestions[] อีกต่อไป

  • ตอนนี้พารามิเตอร์ maxResults ของเมธอด videos.list มีค่าเริ่มต้นเป็น 5

  • ตอนนี้ error documentation จะแสดงข้อผิดพลาดสำหรับเมธอด channelBanners.insert และ subscriptions.list นอกจากนี้ ยังแสดงข้อผิดพลาดใหม่ๆ หลายรายการสำหรับเมธอด channels.update ด้วย

14 พฤษภาคม 2013

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

  • ตอนนี้หน้าแบบสแตนด์อโลนจะแสดงตัวอย่างโค้ดสำหรับ Java, .NET, PHP และ Ruby

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

10 พฤษภาคม 2013

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

8 พฤษภาคม 2013

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

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

    คุณสามารถดึงข้อมูลนี้ได้โดยใส่ invideoPromotion ไว้ในค่าพารามิเตอร์ part ในคำขอ channels.list

  • คุณสามารถใช้เมธอด channels.update ใหม่เพื่ออัปเดตข้อมูลแคมเปญโปรโมตในวิดีโอของช่องได้ โปรดทราบว่าเมธอดนี้รองรับเฉพาะการอัปเดตส่วน invideoPromotion ของทรัพยากร channel และยังไม่รองรับการอัปเดตส่วนอื่นๆ ของทรัพยากรนั้น

2 พฤษภาคม 2013

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

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

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

  • ตอนนี้ API รองรับเมธอด videos.getRating ซึ่งจะดึงข้อมูลคะแนนที่ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วให้ไว้กับรายการวิดีโออย่างน้อย 1 รายการ

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

    ตอนนี้ทั้งพารามิเตอร์ myRating และพารามิเตอร์ id ถือเป็นพารามิเตอร์ตัวกรอง ซึ่งหมายความว่าคำขอ API ต้องระบุพารามิเตอร์เพียงรายการเดียวเท่านั้น (ก่อนหน้านี้ พารามิเตอร์ id เป็นพารามิเตอร์ที่จำเป็นสำหรับเมธอดนี้)

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

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

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

    • ตอนนี้ทรัพยากร youtube#videoListResponse ซึ่งแสดงผลเพื่อตอบสนองต่อคำขอ videos.list มีออบเจ็กต์ pageInfo ซึ่งมีรายละเอียดต่างๆ เช่น จำนวนผลลัพธ์ทั้งหมดและจำนวนผลลัพธ์ที่รวมอยู่ในชุดผลลัพธ์ปัจจุบัน นอกจากนี้ ทรัพยากร youtube#videoListResponse ยังรวมพร็อพเพอร์ตี้ nextPageToken และ prevPageToken ซึ่งแต่ละรายการจะให้โทเค็นที่ใช้ดึงข้อมูลหน้าเว็บที่เฉพาะเจาะจงในชุดผลลัพธ์ได้

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

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

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

    • playlistItem – พร็อพเพอร์ตี้ระบุชื่อช่องที่เพิ่มรายการเพลย์ลิสต์
    • playlist – พร็อพเพอร์ตี้ระบุชื่อช่องที่สร้างเพลย์ลิสต์
    • subscription – พร็อพเพอร์ตี้ระบุชื่อช่องที่มีการติดตาม

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

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

    หมายเหตุ: ฟังก์ชันนี้มีไว้เพื่อแทนที่พารามิเตอร์ mySubscribers ที่รองรับสำหรับเมธอด channels.list ในปัจจุบัน เราจะเลิกใช้งานพารามิเตอร์ดังกล่าว

  • ในทรัพยากร video ค่าพร็อพเพอร์ตี้ unspecified ไม่ใช่ค่าที่เป็นไปได้สำหรับพร็อพเพอร์ตี้ต่อไปนี้อีกต่อไป

  • ตอนนี้คำขอ API ที่มีพารามิเตอร์ที่ไม่คาดคิดจะแสดงข้อผิดพลาด badRequest และสาเหตุของข้อผิดพลาดที่รายงานคือ unexpectedParameter

  • เราได้อัปเดตข้อผิดพลาดที่เมธอด playlistItems.insert แสดงผลเมื่อเพลย์ลิสต์มีรายการครบจำนวนสูงสุดที่อนุญาตแล้ว ตอนนี้ระบบจะรายงานข้อผิดพลาดเป็นข้อผิดพลาด forbidden และสาเหตุของข้อผิดพลาดคือ playlistContainsMaximumNumberOfVideos

19 เมษายน 2013

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

  • เมธอด videos.rate ใหม่ช่วยให้ผู้ใช้ตั้งค่าการให้คะแนน like หรือ dislike ในวิดีโอหรือนำการให้คะแนนออกจากวิดีโอได้

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

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

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

    โปรดทราบว่าการเปลี่ยนแปลงนี้ไม่ได้ส่งผลต่อทรัพยากรที่มีอยู่ซึ่งแสดงภาพขนาดย่อ ระบบจะแสดงภาพขนาดย่อในแหล่งข้อมูลเหล่านั้นในลักษณะเดียวกับที่เคยแสดงก่อนหน้านี้ แม้ว่าตอนนี้เอกสารจะแสดงชื่อของภาพขนาดย่อขนาดต่างๆ ที่ API อาจแสดงผลก็ตาม

  • ส่วน brandingSettings ใหม่ของทรัพยากร channel จะระบุการตั้งค่า ข้อความ และรูปภาพสำหรับหน้าช่องและหน้าดูวิดีโอของช่อง

  • ทรัพยากร playlistItem มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้

    • ออบเจ็กต์ status ใหม่จะรวมข้อมูลสถานะเกี่ยวกับรายการเพลย์ลิสต์ และพร็อพเพอร์ตี้ status.privacyStatus จะระบุสถานะความเป็นส่วนตัวของรายการเพลย์ลิสต์

  • ทรัพยากร video มีพร็อพเพอร์ตี้ใหม่ต่อไปนี้

    • พร็อพเพอร์ตี้ status.publicStatsViewable จะระบุว่าสถิติแบบขยายของวิดีโอในหน้าดูวิดีโอเป็นแบบสาธารณะหรือไม่ โดยค่าเริ่มต้น สถิติเหล่านั้นจะดูได้ และสถิติต่างๆ เช่น ยอดดูและการให้คะแนนของวิดีโอจะยังคงปรากฏต่อสาธารณะแม้ว่าจะตั้งค่าของพร็อพเพอร์ตี้นี้เป็น false ก็ตาม คุณสามารถตั้งค่าของพร็อพเพอร์ตี้นี้เมื่อเรียกใช้เมธอด videos.insert หรือ videos.update

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

      ประเทศ ระบบการจัดประเภท พร็อพเพอร์ตี้
      United States สมาคมภาพยนตร์แห่งสหรัฐอเมริกา (MPAA) contentDetails.contentRating.mpaaRating
      United States TV Parental Guidelines contentDetails.contentRating.tvpgRating
      Australia Australian Classification Board (ACB) contentDetails.contentRating.acbRating
      Brazil Departamento de Justiça, Classificação, Qualificação e Títulos contentDetails.contentRating.djctqRating
      Canada Canadian Home Video Rating System (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 British Board of Film Classification (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 ช่วยให้คุณจำกัดการค้นหาวิดีโอเพื่อดึงข้อมูลวิดีโอทั้งหมด หรือดึงข้อมูลเฉพาะภาพยนตร์หรือเฉพาะตอนของรายการทีวี

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

      • embeddable – ระบุว่าฝังวิดีโอในเว็บไซต์อื่นได้หรือไม่
      • license – ระบุใบอนุญาตของวิดีโอ ค่าที่ถูกต้องคือ creativeCommon และ youtube

  • เราได้อัปเดตคำจำกัดความของพารามิเตอร์ part สำหรับเมธอด videos.list, videos.insert และ videos.update เพื่อแสดงรายการส่วนที่เพิ่มเข้ามาใหม่ตามที่อธิบายไว้ข้างต้น รวมถึงส่วน recordingDetails ซึ่งถูกละเว้นโดยไม่ตั้งใจ

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

  • ตอนนี้ออบเจ็กต์รูปภาพขนาดย่อแต่ละรายการจะระบุความกว้างและความสูงของรูปภาพ ปัจจุบันระบบจะแสดงภาพขนาดย่อในทรัพยากร activity, channel, playlist, playlistItem, search result, subscription และ video

  • ตอนนี้ playlistItems.list รองรับพารามิเตอร์ videoId ซึ่งใช้ร่วมกับพารามิเตอร์ playlistId เพื่อดึงข้อมูลเฉพาะรายการเพลย์ลิสต์ที่แสดงวิดีโอที่ระบุได้

    API จะแสดงข้อผิดพลาด notFound หากไม่พบวิดีโอที่พารามิเตอร์ระบุในเพลย์ลิสต์

  • เอกสารประกอบเกี่ยวกับข้อผิดพลาดอธิบายข้อผิดพลาด forbidden ใหม่ ซึ่งบ่งชี้ว่าคำขอไม่ได้รับสิทธิ์อย่างถูกต้องสำหรับการดำเนินการที่ขอ

  • นำพร็อพเพอร์ตี้ snippet.channelId ของทรัพยากร channel ออกแล้ว พร็อพเพอร์ตี้ id ของทรัพยากรจะให้ค่าเดียวกัน

30 มกราคม 2013

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

  • หน้าข้อผิดพลาดใหม่จะแสดงข้อผิดพลาดที่ API อาจแสดงผล หน้านี้ประกอบด้วยข้อผิดพลาดทั่วไป ซึ่งอาจเกิดขึ้นกับเมธอด API ที่แตกต่างกันหลายรายการ รวมถึงข้อผิดพลาดเฉพาะเมธอด

16 มกราคม 2013

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

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

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