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

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

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 กันยายน 2026

ตอนนี้เมธอด 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 สิงหาคม 2026

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

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

7 กรกฎาคม 2026

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

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

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

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

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

23 มิถุนายน 2026

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

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

3 มิถุนายน 2026

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

ตอนนี้ 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 ในอดีต YouTube จะนับยอดดู Shorts เมื่อเล่นถึงระยะเวลาที่กำหนดเป็นวินาที ตอนนี้ระบบจะนับยอดดูเป็นจำนวนครั้งที่ Shorts เริ่มเล่นหรือเล่นซ้ำ โดยไม่มีข้อกำหนดเวลาในการรับชมขั้นต่ำ ดูข้อมูลเพิ่มเติม

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

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

30 ตุลาคม 2024

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

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

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

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

30 เมษายน 2024

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

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

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

13 มีนาคม 2024

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

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

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

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

12 มีนาคม 2024

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

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

7 มีนาคม 2024

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

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

31 มกราคม 2024

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

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

9 พฤศจิกายน 2023

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

12 กันยายน 2023

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

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

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

22 สิงหาคม 2023

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

18 สิงหาคม 2023

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

7 สิงหาคม 2023

ตามที่ประกาศเมื่อวันที่ 12 มิถุนายน 2023 พารามิเตอร์ relatedToVideoId ของเมธอด search.list ได้รับการเลิกใช้งานแล้ว ระบบไม่รองรับพารามิเตอร์ดังกล่าวอีกต่อไป และได้นำการอ้างอิงถึงพารามิเตอร์ออกจากเอกสารประกอบ API แล้ว

28 มิถุนายน 2023

ตอนนี้เมธอด thumbnails.set รองรับข้อผิดพลาด uploadRateLimitExceeded แล้ว ซึ่งบ่งชี้ว่าช่องอัปโหลดภาพปกมากเกินไป ในช่วง 24 ชั่วโมงที่ผ่านมา และควรลองอีกครั้งในภายหลัง

12 มิถุนายน 2023

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

เลิกใช้งานพารามิเตอร์ relatedToVideoId ของเมธอด search.list แล้ว YouTube จะหยุดรองรับพารามิเตอร์ ตั้งแต่วันที่ 7 สิงหาคม 2023

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

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

22 สิงหาคม 2022

แก้ไขคำอธิบายประกอบประเภทสำหรับฟิลด์ video.statistics เป็นสตริงจาก unsigned long

5 สิงหาคม 2022

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

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

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

12 กรกฎาคม 2022

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

27 เมษายน 2022

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

8 เมษายน 2022

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

15 ธันวาคม 2021

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

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

18 พฤศจิกายน 2021

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

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

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

    ในทุกกรณี ข้อผิดพลาดนี้จะแสดง400รหัสการตอบกลับ HTTP (คำขอไม่ถูกต้อง)

  • ระบบได้นำข้อผิดพลาด watchHistoryNotAccessible และ watchLaterNotAccessible ของเมธอด playlistItems.list ออกจากเอกสารประกอบแล้ว แม้ว่าประวัติการดูและรายการดูภายหลังของผู้ใช้จะเข้าถึงผ่าน API ไม่ได้ แต่ API จะไม่แสดงข้อผิดพลาดเหล่านี้

15 ตุลาคม 2020

เราได้เพิ่ม 2 ส่วนใหม่ลงในนโยบายสำหรับนักพัฒนาแอป ดังนี้

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

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

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

8 ตุลาคม 2020

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

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

9 กันยายน 2020

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

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

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

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

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

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

4 เมษายน 2019

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

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

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

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

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

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

  • นอกจากนี้ เรายังได้อัปเดตเครื่องมือตัวอย่างโค้ดด้วย UI ใหม่ที่มีฟีเจอร์ทั้งหมดเหมือนกับที่อธิบายไว้ข้างต้น เครื่องมือดังกล่าวช่วยให้คุณสำรวจกรณีการใช้งานสำหรับเมธอดต่างๆ โหลดค่าลงใน API Explorer และเปิด API Explorer แบบเต็มหน้าจอเพื่อดูตัวอย่างโค้ดใน Java, JavaScript, PHP และ Python ได้

    การเปลี่ยนแปลงนี้ส่งผลให้ระบบนำหน้าเว็บที่แสดงตัวอย่างโค้ดที่พร้อมใช้งานสำหรับ Java, JavaScript, PHP และ Python ออก

  • เราได้อัปเดตคู่มือเริ่มใช้งานฉบับย่อสำหรับ Java, JavaScript, PHP และ Python แล้ว คำแนะนำที่แก้ไขแล้วจะอธิบายวิธีเรียกใช้ตัวอย่างหนึ่งด้วยคีย์ API และอีกตัวอย่างหนึ่งด้วยรหัสไคลเอ็นต์ OAuth 2.0 โดยใช้โค้ดตัวอย่างจากโปรแกรมสำรวจ API

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

9 กรกฎาคม 2018

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

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

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

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

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

22 มิถุนายน 2018

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

27 พฤศจิกายน 2017

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

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

    YouTube จะหยุดรองรับฟีเจอร์วิดีโอแนะนำและเว็บไซต์แนะนำ ซึ่งรองรับใน API ผ่านออบเจ็กต์ invideoPromotion ของทรัพยากร channel ด้วยเหตุนี้ เราจึงจะเลิกใช้งานออบเจ็กต์ดังกล่าว รวมถึงพร็อพเพอร์ตี้ย่อยทั้งหมด

    คุณยังคงดึงและตั้งค่าข้อมูล invideoPromotion ได้จนถึงวันที่ 14 ธันวาคม 2017 สิ่งที่จะเกิดขึ้นหลังจากวันที่ดังกล่าว

    • การพยายามดึงส่วน invideoPromotion เมื่อเรียกใช้ channels.list จะแสดงผล invideoPromotion ที่ว่างเปล่า หรือไม่แสดงผลข้อมูล invideoPromotion เลย
    • การพยายามอัปเดตข้อมูล invideoPromotion เมื่อเรียกใช้ channels.update จะแสดงการตอบกลับที่สำเร็จจนถึงวันที่ 27 พฤษภาคม 2018 เป็นอย่างน้อย แต่ระบบจะถือว่าเป็นการดำเนินการที่ไม่มีผล ซึ่งหมายความว่าจะไม่มีการอัปเดตจริง

    หลังจากวันที่ 27 พฤษภาคม 2018 เป็นไปได้ว่าคำขอเหล่านี้อาจแสดงข้อความแสดงข้อผิดพลาดเพื่อระบุ เช่น invalidPromotion เป็นส่วนที่ไม่ถูกต้อง

16 พฤศจิกายน 2017

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

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

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

    • ฟังก์ชัน removeEmptyParameters จะใช้รายการคู่คีย์-ค่าที่สอดคล้องกับพารามิเตอร์คำขอ API และนำพารามิเตอร์ที่ไม่มีค่าออก
    • ฟังก์ชัน createResource จะใช้รายการคู่คีย์-ค่าที่สอดคล้องกับพร็อพเพอร์ตี้ในทรัพยากร API จากนั้นจะแปลงพร็อพเพอร์ตี้เป็นออบเจ็กต์ JSON ที่ใช้ในการดำเนินการ insert และ update ได้ ตัวอย่างด้านล่างแสดงชุดชื่อและค่าพร็อพเพอร์ตี้ รวมถึงออบเจ็กต์ JSON ที่โค้ดจะสร้างขึ้นสำหรับพร็อพเพอร์ตี้เหล่านั้น 
      # Key-value pairs:
{'id': 'ABC123',
 'snippet.title': 'Resource title',
 'snippet.description': 'Resource description',
 'status.privacyStatus': 'private'}

# JSON object:
{
 'id': 'ABC123',
 'snippet': {
   'title': 'Resource title',
   'description': 'Resource description',
 },
 'status': {
   'privacyStatus': 'private'
 }
}

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

25 ตุลาคม 2017

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

  • เราได้อัปเดตตัวอย่างโค้ด Python ในเครื่องมือข้อมูลโค้ดแบบอินเทอร์แอกทีฟให้ใช้ไลบรารี google-auth และ google-auth-oauthlib แทนไลบรารี oauth2client ซึ่งตอนนี้เลิกใช้งานแล้ว

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

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

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

29 สิงหาคม 2017

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

  • เราได้อัปเดตคำจำกัดความของพารามิเตอร์ forContentOwner ของเมธอด search.list เพื่อระบุว่าหากตั้งค่าพารามิเตอร์ดังกล่าวเป็น true คุณต้องตั้งค่าพารามิเตอร์ type เป็น video
  • คำจำกัดความของพารามิเตอร์ regionCode ของเมธอด search.list ได้รับการอัปเดตเพื่อชี้แจงว่าพารามิเตอร์จะจำกัดผลการค้นหาให้แสดงเฉพาะวิดีโอที่ดูได้ในภูมิภาคที่ระบุ
  • YouTube ได้อัปเดตโลโก้และไอคอนการสร้างแบรนด์แล้ว คุณดาวน์โหลดโลโก้ใหม่ "พัฒนาด้วย YouTube" ได้จากหน้าหลักเกณฑ์การใช้แบรนด์ นอกจากนี้ ยังมีโลโก้และไอคอนใหม่ๆ อื่นๆ ของ YouTube แสดงอยู่ในหน้านั้นด้วย และคุณสามารถดาวน์โหลดได้จากเว็บไซต์แบรนด์ของ YouTube

24 กรกฎาคม 2017

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

  • คู่มือเริ่มต้นใช้งาน YouTube Data API ฉบับใหม่พร้อมให้บริการสำหรับ iOS แล้ว คู่มือนี้อธิบายวิธีใช้ YouTube Data API ในแอปพลิเคชัน iOS อย่างง่ายที่เขียนด้วย Objective-C หรือ Swift
  • ตอนนี้เครื่องมือข้อมูลโค้ดแบบอินเทอร์แอกทีฟสำหรับ YouTube Data API มีเอกสารประกอบที่อธิบายฟีเจอร์บางอย่างของเครื่องมือแล้ว ดังนี้
    • การดำเนินการคำขอ API
    • การสลับระหว่างข้อมูลโค้ดกับตัวอย่างโค้ดแบบเต็ม
    • การใช้ฟังก์ชันมาตรฐาน
    • การโหลดทรัพยากรที่มีอยู่ (สำหรับวิธีการอัปเดต)

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

1 มิถุนายน 2017

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

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

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

17 พฤษภาคม 2017

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

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

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

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

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

    • สลับระหว่างโค้ดที่ตัดตอนมากับตัวอย่างแบบเต็ม ข้อมูลโค้ดจะแสดงส่วนของโค้ดที่เรียกใช้เมธอด API ตัวอย่างแบบเต็มจะมีทั้งข้อมูลโค้ดดังกล่าวและโค้ด 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
    • พร็อพเพอร์ตี้ topicDetails.relevantTopicIds[] ของแหล่งข้อมูล video
    • พารามิเตอร์ topicId ของเมธอด search.list

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

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

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

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

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

2 พฤศจิกายน 2016

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

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

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

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

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

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

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

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

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

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

      เช่น สมมติว่าวิดีโอมีสัดส่วนภาพ 16:9 ดังนั้น แท็ก player.embedHtml จะมีเพลเยอร์ขนาด 640x360 หากไม่ได้ตั้งค่าพารามิเตอร์ maxHeight หรือ maxWidth

      • หากตั้งค่าพารามิเตอร์ maxHeight เป็น 720 และไม่ได้ตั้งค่าพารามิเตอร์ maxWidth API จะแสดงเพลเยอร์ขนาด 1280x720
      • หากตั้งค่าพารามิเตอร์ maxWidth เป็น 960 และไม่ได้ตั้งค่าพารามิเตอร์ maxHeight ไว้ API จะแสดงผลเพลเยอร์ขนาด 960x540
      • หากตั้งค่าพารามิเตอร์ maxWidth เป็น 960 และตั้งค่าพารามิเตอร์ maxHeight เป็น 450 API จะแสดงผลเพลเยอร์ขนาด 800x450

      พร็อพเพอร์ตี้ player.embedHeight และ player.embedWidth ใหม่ซึ่งอธิบายไว้ข้างต้นจะระบุขนาดของเพลเยอร์

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

    • channelSectionคำอธิบายทรัพยากรได้รับการอัปเดตเพื่อระบุว่าช่องสามารถสร้างชั้นวางได้สูงสุด 10 รายการโดยไม่ต้องตั้งค่าข้อมูลการกำหนดเป้าหมาย และสร้างชั้นวางได้สูงสุด 100 รายการโดยใช้ข้อมูลการกำหนดเป้าหมาย

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

    • การกำหนดพร็อพเพอร์ตี้ snippet.name ของทรัพยากร i18nLanguage ได้รับการแก้ไขเพื่อให้สอดคล้องกับค่าที่แสดงชื่อของภาษาตามที่เขียนในภาษาที่ระบุโดยพารามิเตอร์ hl ของเมธอด i18nLanguage.list

    • พร็อพเพอร์ตี้ contentDetails.note ของทรัพยากร playlistItem ได้รับการอัปเดตเพื่อระบุว่าค่าพร็อพเพอร์ตี้มีความยาวสูงสุด 280 อักขระ

    • เลิกใช้งานพร็อพเพอร์ตี้ contentDetails.startAt และ contentDetails.endAt ของทรัพยากร playlistItem แล้ว ระบบจะไม่สนใจฟิลด์เหล่านี้หากมีการตั้งค่าในคำขอ playlistItems.insert หรือ playlistItems.update

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

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

    • พร็อพเพอร์ตี้ contentDetails.contentRating.grfilmRating ของvideoทรัพยากรรองรับค่าเพิ่มเติม 3 ค่า ได้แก่ grfilmK12, grfilmK15 และ grfilmK18

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

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

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

      ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
      forbidden (403) homeParameterDeprecated เมธอด activities.list จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าข้อมูลกิจกรรมในหน้าแรกของผู้ใช้ไม่พร้อมใช้งานผ่าน API นี้ ข้อผิดพลาดนี้อาจเกิดขึ้นหากคุณตั้งค่าพารามิเตอร์ home เป็น true ในคำขอที่ไม่ได้รับอนุญาต
      invalidValue (400) invalidContentDetails เมธอด playlistItems.insert จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าออบเจ็กต์ contentDetails ในคำขอไม่ถูกต้อง สาเหตุหนึ่งที่ทำให้เกิดข้อผิดพลาดนี้คือฟิลด์ contentDetails.note มีความยาวมากกว่า 280 อักขระ
      forbidden (403) watchHistoryNotAccessible เมธอด playlistItems.list จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าคำขอพยายามดึงข้อมูลรายการในเพลย์ลิสต์ "ประวัติการดู" แต่ไม่สามารถดึงข้อมูลดังกล่าวโดยใช้ API ได้
      forbidden (403) watchLaterNotAccessible เมธอด playlistItems.list จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าคำขอพยายามดึงข้อมูลรายการในเพลย์ลิสต์ "ดูภายหลัง" แต่ดึงข้อมูลเหล่านั้นโดยใช้ API ไม่ได้
      badRequest (400) uploadLimitExceeded videos.insert เมธอดจะแสดงข้อผิดพลาดนี้เพื่อระบุว่าช่องอัปโหลดวิดีโอเกินจำนวนที่อนุญาต
      forbidden (403) forbiddenEmbedSetting เมธอด videos.update จะแสดงข้อผิดพลาดนี้เพื่อระบุว่าคำขอ API พยายามตั้งค่าการฝังที่ไม่ถูกต้องสำหรับวิดีโอ โปรดทราบว่าบางช่องอาจไม่มีสิทธิ์เสนอเพลเยอร์ที่ฝังสำหรับไลฟ์สด ดูข้อมูลเพิ่มเติมได้ที่ศูนย์ช่วยเหลือของ YouTube

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

  • การอัปเดตอื่นๆ

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

15 กันยายน 2016

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

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

  • การเปลี่ยนแปลงต่อไปนี้จะมีผลแล้ว เราได้แจ้งให้ทราบถึงการเปลี่ยนแปลงเหล่านี้ในการอัปเดตประวัติการแก้ไขเมื่อวันที่ 11 สิงหาคม 2016 ดังนี้

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

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

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

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

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

  • ระบบจะไม่แสดงออบเจ็กต์ fileDetails.recordingLocation ของทรัพยากร video และพร็อพเพอร์ตี้ย่อยอีกต่อไป ก่อนหน้านี้ เจ้าของวิดีโอเท่านั้นที่จะดึงข้อมูลนี้ (เช่น ออบเจ็กต์ fileDetails หลัก) ได้

11 สิงหาคม 2016

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

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

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

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

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

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

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

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

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

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

    • พารามิเตอร์ 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) ได้รับการอัปเดตสำหรับทรัพยากร activity, playlistItem, playlist, search result, thumbnail และ video เพื่อให้ทราบว่าวิดีโอบางรายการมีภาพขนาดย่อเพิ่มเติม

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

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

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

17 พฤษภาคม 2016

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

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

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

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

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

28 เมษายน 2016

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

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

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

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

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

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

20 เมษายน 2016

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

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

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

16 มีนาคม 2016

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

18 ธันวาคม 2015

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

19 พฤศจิกายน 2015

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

4 พฤศจิกายน 2015

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

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

    • search.list พารามิเตอร์ order ของเมธอดได้รับการอัปเดตเพื่อระบุว่าหากคุณจัดเรียงการออกอากาศสดตาม 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วิธีการที่อธิบายไว้ข้างต้น

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

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

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

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

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

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

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

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

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

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

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

    • เราได้แก้ไขเอกสารประกอบสำหรับเมธอด channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete และ videos.delete เพื่อให้แสดงว่าเมื่อดำเนินการสำเร็จ เมธอดเหล่านั้นจะแสดงโค้ดตอบกลับ HTTP 204 (No Content)

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

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

      ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
      badRequest (400) targetInvalidCountry เมธอด channelSections.insert และ channelSections.update จะแสดงข้อผิดพลาดนี้หากทรัพยากร channelSection ที่แทรกมีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้ targeting.countries[]
      badRequest (400) targetInvalidLanguage เมธอด channelSections.insert และ channelSections.update จะแสดงข้อผิดพลาดนี้หากทรัพยากร channelSection ที่แทรกมีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้ targeting.languages[]
      badRequest (400) targetInvalidRegion เมธอด channelSections.insert และ channelSections.update จะแสดงข้อผิดพลาดนี้หากทรัพยากร channelSection ที่แทรกมีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้ targeting.regions[]
      badRequest (400) operationNotSupported เมธอด comments.insert จะแสดงข้อผิดพลาดนี้หากผู้ใช้ API ไม่สามารถแทรกความคิดเห็นเพื่อตอบความคิดเห็นระดับบนสุดที่ระบุโดยพร็อพเพอร์ตี้ snippet.parentId ในcommentThreadทรัพยากร พร็อพเพอร์ตี้ snippet.canReply จะระบุว่าผู้ชมปัจจุบันตอบกลับชุดข้อความได้หรือไม่
      badRequest (400) invalidChannelId เมธอด search.list จะแสดงข้อผิดพลาดนี้หากพารามิเตอร์ channelId ในคำขอระบุรหัสช่องที่ไม่ถูกต้อง
      badRequest (400) subscriptionForbidden เมธอด subscriptions.insert จะแสดงข้อผิดพลาดนี้หากผู้ใช้ API พยายามติดตามช่องของตนเอง

    • วิธี captions.update ไม่รองรับข้อผิดพลาด invalidMetadata และ videoNotFound อีกต่อไป

16 เมษายน 2015

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

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

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

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

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

9 เมษายน 2015

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2 เมษายน 2015

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

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

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

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

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

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

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

11 มีนาคม 2015

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

11 พฤศจิกายน 2014

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

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

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

    • ต้นทุนโควต้า: 100 หน่วย

      เรียกใช้เมธอด search.list แล้วค้นหา GoogleDevelopers

    • ต้นทุนโควต้า: 6 หน่วย

      เรียกใช้เมธอด channels.list เพื่อค้นหารหัสช่องที่ถูกต้อง ตั้งค่าพารามิเตอร์ forUsername เป็น GoogleDevelopers และพารามิเตอร์ part เป็น contentDetails ในคำตอบของ API พร็อพเพอร์ตี้ contentDetails.relatedPlaylists.uploads จะระบุรหัสเพลย์ลิสต์สำหรับวิดีโอที่อัปโหลดของช่อง

      จากนั้นเรียกใช้เมธอด playlistItems.list และตั้งค่าพารามิเตอร์ playlistId เป็นรหัสที่บันทึกไว้ และตั้งค่าพารามิเตอร์ part เป็น snippet

8 ตุลาคม 2014

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

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

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

      • allowed - ช่องจะอัปโหลดวิดีโอที่มีความยาวมากกว่า 15 นาทีได้
      • eligible – ช่องมีสิทธิ์อัปโหลดวิดีโอที่มีความยาวเกิน 15 นาที แต่ต้องเปิดใช้ฟีเจอร์นี้ก่อน
      • disallowed – ช่องไม่สามารถหรือไม่มีสิทธิ์อัปโหลดวิดีโอที่มีความยาวเกิน 15 นาที

      ดูข้อมูลเพิ่มเติมเกี่ยวกับค่าเหล่านี้ได้ในคําจํากัดความของพร็อพเพอร์ตี้ ศูนย์ช่วยเหลือของ YouTube ยังมีข้อมูลโดยละเอียดเพิ่มเติมเกี่ยวกับฟีเจอร์นี้ด้วย

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

  • เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้ snippet.title และ snippet.categoryId ของทรัพยากร video เพื่อชี้แจงวิธีที่ API จัดการการเรียกเมธอด videos.update หากเรียกใช้เมธอดดังกล่าวเพื่ออัปเดตส่วน snippet ของทรัพยากร video คุณต้องตั้งค่าสำหรับพร็อพเพอร์ตี้ทั้ง 2 รายการ

    หากคุณพยายามอัปเดตส่วน snippet ของทรัพยากร video และไม่ได้ตั้งค่าสำหรับพร็อพเพอร์ตี้ทั้ง 2 รายการ API จะแสดงข้อผิดพลาด invalidRequest นอกจากนี้ เรายังได้อัปเดตคำอธิบายของข้อผิดพลาดดังกล่าวด้วย

  • ตอนนี้พร็อพเพอร์ตี้ contentDetails.contentRating.oflcRating ของvideoทรัพยากร ซึ่งระบุการจัดประเภทวิดีโอจากสำนักงานการจัดประเภทภาพยนตร์และวรรณกรรมของนิวซีแลนด์ รองรับการจัดประเภทใหม่ 2 รายการ ได้แก่ oflcRp13 และ oflcRp16 โดยจะสอดคล้องกับคะแนน RP13 และ RP16 ตามลำดับ

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

    ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
    badRequest bannerAlbumFull อัลบั้มหน้าปกช่อง YouTube ของเจ้าของช่องมีรูปภาพมากเกินไป เจ้าของช่องควรไปที่ http://photos.google.com ไปที่หน้าอัลบั้ม แล้วนำรูปภาพบางส่วนออกจากอัลบั้มนั้น

12 กันยายน 2014

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

  • ต้นทุนโควต้าสำหรับการเรียกใช้เมธอด search.list เปลี่ยนจาก 1 หน่วยเป็น 2 หน่วย นอกเหนือจากต้นทุนของชิ้นส่วนทรัพยากรที่ระบุ

13 สิงหาคม 2014

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

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

    ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
    badRequest subscriptionLimitExceeded ผู้ติดตามที่ระบุในคำขอมีจำนวนการติดตามเกินขีดจำกัดอัตราการติดตามแล้ว คุณลองสมัครใช้บริการอีกครั้งได้ในอีก 2-3 ชั่วโมง

12 สิงหาคม 2014

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

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

8 กรกฎาคม 2014

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

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

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

18 มิถุนายน 2014

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

28 พฤษภาคม 2014

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

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

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

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

13 พฤษภาคม 2014

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

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

  • ตอนนี้channelSectionแหล่งข้อมูลสามารถมีข้อมูลเกี่ยวกับเนื้อหาที่โดดเด่นประเภทใหม่ๆ ได้แล้ว พร็อพเพอร์ตี้ snippet.type ของchannelSectionทรัพยากรตอนนี้รองรับค่าต่อไปนี้

    • postedPlaylists - เพลย์ลิสต์ที่เจ้าของช่องโพสต์ลงในฟีดกิจกรรมของช่อง
    • postedVideos - วิดีโอที่เจ้าของช่องโพสต์ลงในฟีดกิจกรรมของช่อง
    • subscriptions - ช่องที่เจ้าของช่องติดตาม

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

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

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

  • เราได้อัปเดตคำจำกัดความของพร็อพเพอร์ตี้ pageInfo.totalResults ที่แสดงผลในการตอบกลับ API สำหรับการเรียก search.list เพื่อระบุว่าค่าดังกล่าวเป็นค่าประมาณและอาจไม่ใช่ค่าที่แน่นอน นอกจากนี้ ค่าสูงสุดคือ 1,000,000 คุณไม่ควรใช้ค่านี้เพื่อสร้างลิงก์การแบ่งหน้า ให้ใช้ค่าพร็อพเพอร์ตี้ nextPageToken และ prevPageToken แทนเพื่อพิจารณาว่าจะแสดงลิงก์การแบ่งหน้าหรือไม่

  • เราได้อัปเดตเมธอด watermarks.set และ watermarks.unset เพื่อให้ API แสดงโค้ดตอบกลับ HTTP 204 สำหรับคำขอที่สำเร็จไปยังเมธอดเหล่านั้น

2 พฤษภาคม 2014

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

  • แหล่งข้อมูล i18nLanguage ใหม่จะระบุภาษาของแอปพลิเคชันที่เว็บไซต์ YouTube รองรับ ภาษาของแอปพลิเคชันเรียกอีกอย่างว่าภาษา UI ได้ด้วย สำหรับเว็บไซต์ YouTube ระบบอาจเลือกภาษาของแอปพลิเคชันโดยอัตโนมัติตามการตั้งค่าบัญชี Google, ภาษาของเบราว์เซอร์ หรือตำแหน่ง IP และผู้ใช้ยังเลือกภาษา UI ที่ต้องการได้ด้วยตนเองจากส่วนท้ายของเว็บไซต์ YouTube

    API รองรับวิธีการแสดงภาษาของแอปพลิเคชันที่รองรับ คุณใช้ภาษาที่รองรับเป็นค่าของพารามิเตอร์ hl ได้เมื่อเรียกใช้เมธอด API เช่น videoCategories.list และ guideCategories.list

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

    API รองรับเมธอดในการแสดงภูมิภาคเนื้อหาที่รองรับ รหัสภูมิภาคที่รองรับสามารถใช้เป็นค่าของพารามิเตอร์ regionCode เมื่อเรียกใช้เมธอด API เช่น search.list, videos.list, activities.list และ videoCategories.list

7 เมษายน 2014

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

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

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

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

  • เราได้อัปเดตคำจำกัดความของออบเจ็กต์ fileDetails ของทรัพยากร video เพื่ออธิบายว่าระบบจะแสดงผลออบเจ็กต์ดังกล่าวก็ต่อเมื่อพร็อพเพอร์ตี้ processingDetails.fileDetailsAvailability ของวิดีโอมีค่าเป็น available เท่านั้น

    ในทำนองเดียวกัน เราได้อัปเดตคำจำกัดความของออบเจ็กต์ suggestions ของทรัพยากร video เพื่ออธิบายว่าระบบจะแสดงออบเจ็กต์ดังกล่าวก็ต่อเมื่อพร็อพเพอร์ตี้ processingDetails.tagSuggestionsAvailability ของวิดีโอหรือพร็อพเพอร์ตี้ processingDetails.editorSuggestionsAvailability มีค่าเป็น available

  • เราได้อัปเดตเอกสารประกอบสำหรับเมธอด videos.insert และ videos.update เพื่อให้สอดคล้องกับการตั้งค่าพร็อพเพอร์ตี้ status.publishAt เมื่อเรียกใช้เมธอดเหล่านั้น

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

  • เราได้อัปเดตรายการพารามิเตอร์สำหรับเมธอด videos.rate เพื่อให้เห็นว่าเมธอดดังกล่าวไม่รองรับพารามิเตอร์ onBehalfOfContentOwner จริงๆ นี่เป็นข้อผิดพลาดในเอกสารประกอบ เนื่องจากvideos.rateคำขอที่ตั้งค่าพารามิเตอร์นี้จะแสดงข้อผิดพลาด 500

31 มีนาคม 2014

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

13 มีนาคม 2014

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

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

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

    ทรัพยากร พร็อพเพอร์ตี้ ความยาวสูงสุด
    channel invideoPromotion.items[].customMessage 40 อักขระ
    video snippet.title 100 อักขระ
    video snippet.description 5,000 ไบต์
    video snippet.tags 500 อักขระ โปรดทราบว่าค่าพร็อพเพอร์ตี้เป็นรายการ และคอมมาระหว่างรายการในรายการจะนับรวมในขีดจำกัด

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

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

  • ตอนนี้เอกสารประกอบเกี่ยวกับข้อผิดพลาดระบุโค้ดการตอบกลับ HTTP สำหรับข้อผิดพลาดแต่ละประเภทแล้ว

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

    ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
    badRequest (400) invalidCriteria เมธอด channels.list จะแสดงข้อผิดพลาดนี้หากคำขอระบุพารามิเตอร์ตัวกรองที่ใช้ร่วมกันไม่ได้
    badRequest (400) channelTitleUpdateForbidden เมธอด channels.update จะแสดงข้อผิดพลาดนี้หากคุณพยายามอัปเดตส่วน brandingSettings ของช่องและเปลี่ยนค่าของพร็อพเพอร์ตี้ brandingSettings.channel.title (โปรดทราบว่า API จะไม่แสดงข้อผิดพลาดหากคุณละเว้นพร็อพเพอร์ตี้)
    badRequest (400) invalidRecentlyUploadedBy เมธอด channels.update จะแสดงข้อผิดพลาดนี้หากพร็อพเพอร์ตี้ invideoPromotion.items[].id.recentlyUploadedBy ระบุรหัสช่องที่ไม่ถูกต้อง
    badRequest (400) invalidTimingOffset เมธอด channels.update จะแสดงข้อผิดพลาดนี้หากส่วน invideoPromotion ระบุออฟเซ็ตเวลาที่ไม่ถูกต้อง
    badRequest (400) tooManyPromotedItems เมธอด channels.update จะแสดงข้อผิดพลาดนี้หากส่วน invideoPromotion ระบุสินค้าโปรโมตมากกว่าจำนวนที่อนุญาต
    forbidden (403) promotedVideoNotAllowed เมธอด channels.update จะแสดงข้อผิดพลาดนี้หากพร็อพเพอร์ตี้ invideoPromotion.items[].id.videoId ระบุรหัสวิดีโอที่ไม่พบหรือใช้เป็นรายการที่โปรโมตไม่ได้
    forbidden (403) websiteLinkNotAllowed เมธอด channels.update จะแสดงข้อผิดพลาดนี้หากพร็อพเพอร์ตี้ invideoPromotion.items[].id.websiteUrl ระบุ URL ที่ไม่อนุญาต
    required (400) requiredTimingType เมธอด channels.update จะแสดงข้อผิดพลาดนี้หากคำขอไม่ได้ระบุการตั้งค่าเวลาเริ่มต้นสำหรับเวลาที่ YouTube ควรแสดงรายการที่โปรโมต
    required (400) requiredTiming เมธอด channels.update ต้องระบุออบเจ็กต์ 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

  • เราได้ลดขนาดขั้นต่ำของรูปภาพแบนเนอร์ของช่องที่อัปโหลดเป็น 2048x1152 พิกเซล (ก่อนหน้านี้ ขนาดขั้นต่ำคือ 2120x1192 พิกเซล) นอกจากนี้ โปรดทราบว่าเอกสารประกอบเกี่ยวกับทรัพยากร channel ระบุขนาดสูงสุดของรูปภาพแบนเนอร์ทั้งหมดที่แสดงจาก API เช่น ขนาดสูงสุดของรูปภาพ brandingSettings.image.bannerTvImageUrl สำหรับแอปพลิเคชันโทรทัศน์คือ 2120x1192 พิกเซล แต่รูปภาพจริงอาจมีขนาด 2048x1152 พิกเซล ศูนย์ช่วยเหลือของ 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 ในภาษาฝรั่งเศส ซึ่งใช้ในควิเบกตามลำดับ

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

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

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 ปีขึ้นไป

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

1 ตุลาคม 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

27 สิงหาคม 2013

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

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

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

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

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

  • ตอนนี้เมธอด playlists.list รองรับพารามิเตอร์ onBehalfOfContentOwner และ onBehalfOfContentOwnerChannel แล้ว ทั้ง 2 พารามิเตอร์รองรับเมธอดอื่นๆ อีกหลายรายการอยู่แล้ว

  • ตอนนี้เมธอด videos.list รองรับพารามิเตอร์ regionCode ซึ่งระบุภูมิภาคของเนื้อหาที่ควรดึงแผนภูมิ พารามิเตอร์นี้ใช้ได้ร่วมกับพารามิเตอร์ chart เท่านั้น ค่าพารามิเตอร์คือรหัสประเทศ ISO 3166-1 alpha-2

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

    ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
    forbidden insufficientPermissions ขอบเขตที่เชื่อมโยงกับโทเค็น OAuth 2.0 ที่ระบุสำหรับคำขอไม่เพียงพอสำหรับการเข้าถึงข้อมูลที่ขอ

15 สิงหาคม 2013

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

  • ออบเจ็กต์ invideoPromotion ของทรัพยากร channel มีพร็อพเพอร์ตี้ใหม่และที่อัปเดตต่อไปนี้

    • ตอนนี้ API รองรับความสามารถในการระบุเว็บไซต์เป็นสินค้าที่โปรโมตแล้ว โดยตั้งค่าพร็อพเพอร์ตี้ invideoPromotion.items[].id.type เป็น website และใช้พร็อพเพอร์ตี้ invideoPromotion.items[].id.websiteUrl ใหม่เพื่อระบุ URL นอกจากนี้ ให้ใช้พร็อพเพอร์ตี้ invideoPromotion.items[].customMessage ใหม่เพื่อกำหนดข้อความที่กำหนดเองที่จะแสดงสำหรับการโปรโมต

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

      การเพิ่มลิงก์โปรโมตหมายความว่าคุณยอมรับว่าจะไม่ใช้ลิงก์เหล่านั้นเพื่อเปลี่ยนเส้นทางการเข้าชมไปยังเว็บไซต์ที่ไม่ได้รับอนุญาต และลิงก์เหล่านั้นจะเป็นไปตามนโยบาย AdWords, นโยบายโฆษณาของ YouTube, หลักเกณฑ์ของชุมชน YouTube และข้อกำหนดในการให้บริการของ YouTube

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

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

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

      • พร็อพเพอร์ตี้ invideoPromotion.items[].timing.durationMs ใหม่ระบุระยะเวลาเป็นมิลลิวินาทีที่โปรโมชันควรแสดง ออบเจ็กต์ invideoPromotion.defaultTiming ยังมีฟิลด์ durationMs ที่ระบุระยะเวลาเริ่มต้นที่รายการที่โปรโมตจะแสดงด้วย

    • ทั้งพร็อพเพอร์ตี้ invideoPromotion.items[].type และ invideoPromotion.items[].videoId ได้ย้ายไปอยู่ในออบเจ็กต์ invideoPromotion.items[].id แล้ว

  • ตอนนี้เมธอด subscriptions.list รองรับพารามิเตอร์ onBehalfOfContentOwner และ onBehalfOfContentOwnerChannel แล้ว ทั้ง 2 พารามิเตอร์รองรับเมธอดอื่นๆ อีกหลายรายการอยู่แล้ว

  • ในคำตอบของ API สำหรับคำขอ thumbnails.set ค่าพร็อพเพอร์ตี้ kind เปลี่ยนจาก youtube#thumbnailListResponse เป็น youtube#thumbnailSetResponse

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

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

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

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

8 สิงหาคม 2013

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

30 กรกฎาคม 2013

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

  • ในทรัพยากร channelBanner ค่าของพร็อพเพอร์ตี้ kind เปลี่ยนจาก youtube#channelBannerInsertResponse เป็น youtube#channelBannerResource ระบบจะแสดงทรัพยากรนี้ในการตอบกลับคำขอ channelBanners.insert

  • พร็อพเพอร์ตี้ brandingSettings.channel.profileColor ใหม่ของทรัพยากร channel จะระบุสีเด่นที่ช่วยเสริมคอนเทนต์ของช่อง ค่าพร็อพเพอร์ตี้คือเครื่องหมายปอนด์ (#) ตามด้วยสตริงเลขฐานสิบหก 6 อักขระ เช่น #2793e6

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

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

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

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

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

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

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

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

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

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

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

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

10 มิถุนายน 2013

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

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

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

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

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

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

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

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

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

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

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

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

22 พฤษภาคม 2013

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

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

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

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

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

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

14 พฤษภาคม 2013

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

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

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

10 พฤษภาคม 2013

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

8 พฤษภาคม 2013

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

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

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

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

2 พฤษภาคม 2013

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

19 เมษายน 2013

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

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

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

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

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

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

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

  • ทรัพยากร 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 ระบบการจัดประเภทวิดีโอในบ้านของแคนาดา (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 เพื่อดึงรายการค่าที่ถูกต้อง