หมายเหตุ: การปฏิบัติตามนโยบายสำหรับนักพัฒนาแอป YouTube มีคำแนะนำและตัวอย่างเพื่อช่วยให้คุณมั่นใจได้ว่าไคลเอ็นต์ API จะปฏิบัติตามข้อกำหนดและนโยบายของบริการ API ของ YouTube (API TOS) ที่เฉพาะเจาะจง คู่มือนี้ให้ข้อมูลเชิงลึกเกี่ยวกับวิธีที่ YouTube บังคับใช้ข้อกำหนดในการให้บริการของ API ในบางแง่มุม แต่ไม่ได้แทนที่เอกสารที่มีอยู่
เอกสารนี้ระบุข้อกำหนดด้านฟังก์ชันการทำงานขั้นต่ำสำหรับไคลเอ็นต์ API ที่ใช้หรือให้สิทธิ์เข้าถึงฟีเจอร์เฉพาะของบริการ YouTube API ("ไคลเอ็นต์ API")
ข้อกำหนดและหลักเกณฑ์เหล่านี้ช่วยให้มั่นใจว่าไคลเอ็นต์ API จะมอบประสบการณ์ของผู้ใช้ที่สอดคล้องกัน ซึ่งปกป้องผลประโยชน์ของผู้ใช้ เจ้าของเนื้อหา และผู้ลงโฆษณา YouTube กฎเหล่านี้เป็นส่วนหนึ่งของข้อกำหนดในการให้บริการ YouTube API และต้องปฏิบัติตามในการพัฒนาและนำไคลเอ็นต์ API ไปใช้
คุณควรมีการเปลี่ยนแปลงข้อกำหนดในเอกสารฉบับนี้ เพื่อให้เรามั่นใจได้ว่าผู้ใช้จะได้รับประสบการณ์ที่ดีขึ้นในการใช้งานฟีเจอร์ที่มีอยู่ของ YouTube โดยจะมีการเปลี่ยนแปลงเพื่อตอบสนองต่อฟีเจอร์ใหม่ๆ ของ YouTube ที่ได้รับการอัปเดตด้วย บางครั้ง การเปลี่ยนแปลงดังกล่าวอาจกำหนดให้คุณต้องอัปเดตไคลเอ็นต์ API เพื่อให้เป็นไปตามข้อกำหนดใหม่ ประวัติการแก้ไขข้อกำหนดในการให้บริการจะบันทึกการเปลี่ยนแปลงทั้งหมด ดังนั้นโปรดตรวจสอบเอกสารนั้นบ่อยๆ หรือสมัครรับฟีด RSS เพื่อให้แน่ใจว่าคุณจะดูการเปลี่ยนแปลงที่อาจส่งผลต่อไคลเอ็นต์ API ได้อย่างรวดเร็ว
นอกเหนือจากข้อกำหนดในเอกสารนี้แล้ว ขอแนะนำอย่างยิ่งให้คุณทำตามแนวทางปฏิบัติแนะนำที่อธิบายไว้ในนโยบายบริการ API ของ YouTube และได้อธิบายไว้ในเอกสารของบริการ API ของ YouTube ที่อื่น แนวทางปฏิบัติเหล่านี้จะช่วยให้ไคลเอ็นต์ API กู้คืนจากข้อผิดพลาดได้เร็วขึ้นและเพิ่มประสิทธิภาพการใช้โควต้าได้หากใช้บริการ API ของ YouTube ที่จัดสรรโควต้า แม้จะไม่ได้กำหนดให้ต้องทำอย่างเคร่งครัดก็ตาม ในขณะเดียวกัน แนวทางปฏิบัติเหล่านี้ช่วยให้ระบบนิเวศของ YouTube มีสถานะที่ดี และที่สำคัญที่สุดคือ มอบประสบการณ์ที่ดีที่สุดแก่ผู้ใช้ไคลเอ็นต์ API และแอปพลิเคชัน YouTube ของคุณ
โปรแกรมเล่นและการเล่นวิดีโอแบบฝังของ YouTube
ข้อกำหนดในส่วนนี้เกี่ยวข้องกับโปรแกรมเล่นแบบฝังของ YouTube โดยเฉพาะ นอกจากนี้ นโยบายบริการ API ของ YouTube ยังมีนโยบายต่างๆ ที่เกี่ยวข้องกับไคลเอ็นต์ API ที่เล่นเนื้อหาภาพและเสียงของ YouTube
ขนาดโปรแกรมเล่นวิดีโอ YouTube แบบฝัง
โปรแกรมเล่นที่ฝังจะต้องมีวิวพอร์ตขนาดอย่างน้อย 200 x 200 พิกเซล หากโปรแกรมเล่นแสดงตัวควบคุม ตัวควบคุมนั้นต้องมีขนาดใหญ่พอที่จะแสดงตัวควบคุมทั้งหมดได้โดยไม่มีการย่อวิวพอร์ตให้ต่ำกว่าขนาดขั้นต่ำ โดยโปรแกรมเล่นวิดีโอ 16:9 ควรมีความกว้างอย่างน้อย 480 พิกเซลและสูง 270 พิกเซล
การเล่นอัตโนมัติและการเล่นตามสคริปต์
ส่วนนี้จะครอบคลุมการเล่นอัตโนมัติ โดยจะมีผลกับโปรแกรมเล่นแบบฝังของ YouTube ที่ใช้พารามิเตอร์โปรแกรมเล่น autoplay
หรือเริ่มการเล่นอัตโนมัติแบบเป็นโปรแกรมโดยใช้บริการ YouTube IFrame Player API, บริการ YouTube Android Player API หรือบริการ YouTube API อื่นๆ
-
โปรแกรมเล่นแบบฝังที่เล่นวิดีโอโดยอัตโนมัติควรเริ่มเล่นทันทีเมื่อหน้าโหลดขึ้นมาหรือทันทีที่โปรแกรมเล่นแบบฝังปรากฏขึ้นทั้งหมด อย่างไรก็ตาม ไคลเอ็นต์ API ต้องไม่เริ่มเล่นโดยอัตโนมัติจนกว่าจะแสดงโปรแกรมเล่นและเห็นโปรแกรมเล่นมากกว่าครึ่งหนึ่งในหน้าเว็บหรือหน้าจอ
-
หน้าหรือหน้าจอต้องมีโปรแกรมเล่น YouTube ไม่เกิน 1 รายการที่เล่นเนื้อหาพร้อมกันโดยอัตโนมัติ
-
ภาพขนาดย่อของ YouTube ที่เริ่มเล่นต้องมีความกว้างอย่างน้อย 120 พิกเซลและสูง 70 พิกเซลเป็นอย่างน้อย
แอตทริบิวต์ของโปรแกรมเล่น YouTube
แอตทริบิวต์และพารามิเตอร์ของโปรแกรมเล่นวิดีโอ YouTube เช่น ลักษณะการแสดงแบรนด์ YouTube ในโปรแกรมเล่นจะอยู่ในเอกสารประกอบและข้อกำหนดของ YouTube API (https://developers.google.com/youtube) คุณต้องไม่ทำการเปลี่ยนแปลงในโปรแกรมเล่นวิดีโอ YouTube ที่ไม่ได้อธิบายไว้อย่างชัดเจนในเอกสารประกอบของ API
การวางซ้อนและเฟรม
คุณต้องไม่แสดงการวางซ้อน เฟรม หรือองค์ประกอบภาพอื่นๆ ด้านหน้าส่วนใดส่วนหนึ่งของโปรแกรมเล่นแบบฝังของ YouTube รวมถึงตัวควบคุมวิดีโอเพลเยอร์ ในทำนองเดียวกัน คุณต้องไม่ใช้การวางซ้อน เฟรม หรือองค์ประกอบภาพอื่นๆ เพื่อบดบังส่วนใดๆ ของโปรแกรมเล่นแบบฝัง รวมถึงตัวควบคุมโปรแกรมเล่น
เมาส์โอเวอร์
คุณต้องไม่ใช้เมาส์โอเวอร์หรือการแตะที่โปรแกรมเล่นบน YouTube เพื่อเริ่มการดำเนินการใดๆ ในนามของผู้ใช้ เช่น การเปิดหน้าต่างหรือการติดตามช่อง
การอัปโหลดวิดีโอ
หากไคลเอ็นต์ API อนุญาตให้ผู้ใช้อัปโหลดเนื้อหาไปยังหลายแพลตฟอร์ม ผู้ใช้ควรสามารถเลือกและยกเลิกการเลือกแพลตฟอร์มที่ต้องการอัปโหลดวิดีโอได้
ข้อกำหนดด้านข้อมูล
ไคลเอ็นต์ API ที่ช่วยให้ผู้ใช้อัปโหลดวิดีโอไปยัง YouTube ได้จะต้องเปิดให้ผู้ใช้ตั้งค่าในรายการต่อไปนี้ พร็อพเพอร์ตี้ที่ไม่อยู่ในรายการเป็นตัวเลือกที่ไม่บังคับ
ชื่อ | คำอธิบาย | |
---|---|---|
พร็อพเพอร์ตี้ของทรัพยากร | ||
snippet.title |
ต้องระบุ ชื่อของวิดีโอ YouTube จะแสดงข้อผิดพลาดหากค่ามีอักขระเกิน 100 ตัว YouTube รองรับอักขระ UTF-8 ที่ถูกต้องทั้งหมด ยกเว้น < และ >
| |
snippet.description |
ต้องระบุ คำอธิบายวิดีโอ YouTube จะส่งกลับข้อผิดพลาดหากค่าเกิน 5000 ไบต์ YouTube รองรับอักขระ UTF-8 ที่ถูกต้องทั้งหมด ยกเว้น < และ > |
|
status.privacyStatus |
ต้องระบุ การตั้งค่าความเป็นส่วนตัวของวิดีโอ ผู้ใช้ต้องเลือกได้ว่าจะให้วิดีโอที่อัปโหลดเป็นแบบสาธารณะ ส่วนตัว หรือไม่เป็นสาธารณะ | |
พารามิเตอร์คำขอ | ||
onBehalfOfContentOwnerChannel |
ต้องมีเงื่อนไข หากข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุเจ้าของเนื้อหาและมีการตั้งค่าพารามิเตอร์ onBehalfOfContentOwner ไว้ ผู้ใช้ API จะต้องระบุช่อง YouTube ที่จะอัปโหลดวิดีโอได้ด้วย |
กำลังแสดงความคิดเห็น
ชื่อ | คำอธิบาย | |
---|---|---|
พร็อพเพอร์ตี้ของทรัพยากร | ||
snippet.textDisplay |
ต้องระบุ ข้อความของความคิดเห็น ไคลเอ็นต์ API ต้อง (ก) แสดงข้อความแบบเต็มของความคิดเห็นหรือการตอบกลับความคิดเห็น หรือ (ข) ตัดข้อความและให้วิธีที่ผู้ดูเข้าถึงข้อความทั้งหมดจากเวอร์ชันที่ตัดให้สั้นลงได้อย่างง่ายดาย ข้อกำหนดนี้ใช้กับความคิดเห็นและการตอบกลับความคิดเห็นทั้งหมด โดยไม่คำนึงว่าความคิดเห็นนั้นเชื่อมโยงกับทรัพยากรประเภทใด (วิดีโอ ช่อง ฯลฯ) โปรดทราบว่าค่าพร็อพเพอร์ตี้ snippet.topLevelComment ของทรัพยากร commentThread คือทรัพยากร comment ของทรัพยากร replies.comments[] และพร็อพเพอร์ตี้ replies.comments[] comment ข้อกําหนดนี้จึงมีผลกับพร็อพเพอร์ตี้ snippet.topLevelComment.snippet.textDisplay และ replies.comments[].snippet.textDisplay ด้วย |
|
snippet.title ( channel ) |
ต้องระบุ (คำแนะนำ) ชื่อของช่อง
|
|
snippet.title ( video ) |
ต้องระบุ (คำแนะนำ) ชื่อของวิดีโอ คุณต้องระบุค่านี้หากความคิดเห็นเกี่ยวข้องกับวิดีโอ | |
snippet.moderationStatus |
ต้องมีเงื่อนไข หากค่าพารามิเตอร์ moderationStatus ในคำขอ API คือ heldForReview หรือ likelySpam จอแสดงผลต้องระบุสถานะนั้นอย่างชัดเจนโดยใช้ค่าพร็อพเพอร์ตี้ ภาษาที่คล้ายกัน (เช่น "ความคิดเห็นนี้ถูกระงับเพื่อรอการตรวจสอบ") ส่วนหัว (เช่น "ระงับเพื่อรอตรวจสอบ") หรือภาษาอื่นๆ ที่ไม่กำกวม เมธอด commentThreads.list รองรับความสามารถในการเรียกความคิดเห็นตามสถานะการดูแล |
การเพิ่มความคิดเห็น
ชื่อ | คำอธิบาย | |
---|---|---|
พร็อพเพอร์ตี้ของทรัพยากร | ||
snippet.title ( channel ) |
ต้องระบุ ชื่อของช่อง
|
|
snippet.title ( video ) |
ต้องระบุ หากผู้ใช้เพิ่มความคิดเห็นเกี่ยวกับวิดีโอ ไคลเอ็นต์ API จะต้องแสดงชื่อวิดีโอ | |
ข้อกำหนดอื่นๆ | ||
Comment author's channel name |
ต้องระบุ ไคลเอ็นต์ API จะต้องระบุบัญชีผู้ใช้ YouTube ที่เป็นแหล่งที่มาของความคิดเห็นอย่างชัดเจน หากข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุเจ้าของเนื้อหาและมีการตั้งค่าพารามิเตอร์ onBehalfOfContentOwner ไว้ ผู้ใช้ API จะต้องสามารถระบุช่อง YouTube ที่จะระบุแหล่งที่มาของความคิดเห็นได้ด้วย |
การเพิ่มการตอบกลับความคิดเห็น
ชื่อ | คำอธิบาย | |
---|---|---|
พร็อพเพอร์ตี้ของทรัพยากร | ||
snippet.textDisplay |
ต้องระบุ ข้อความของความคิดเห็น ไคลเอ็นต์ API จะต้องแสดงข้อความของความคิดเห็นที่ผู้ใช้กำลังตอบกลับตามกฎที่กำหนดไว้ในส่วนการแสดงความคิดเห็นของเอกสารนี้ | |
snippet.title ( channel ) |
ต้องระบุ ชื่อของช่อง
|
|
snippet.title ( video ) |
ต้องระบุ หากผู้ใช้ตอบกลับความคิดเห็นเกี่ยวกับวิดีโอ ไคลเอ็นต์ API จะต้องแสดงชื่อวิดีโอ | |
ข้อกำหนดอื่นๆ | ||
Comment author's channel name |
ต้องระบุ ไคลเอ็นต์ API จะต้องระบุบัญชีผู้ใช้ YouTube ที่เป็นแหล่งที่มาของการตอบกลับความคิดเห็นอย่างชัดเจน หากข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุเจ้าของเนื้อหาและมีการตั้งค่าพารามิเตอร์ onBehalfOfContentOwner ไว้ ผู้ใช้ API จะต้องสามารถระบุช่อง YouTube ที่จะใช้เป็นแหล่งที่มาของการตอบกลับความคิดเห็น |
การแก้ไขหรือลบการตอบกลับความคิดเห็น
ชื่อ | คำอธิบาย | |
---|---|---|
พร็อพเพอร์ตี้ของทรัพยากร | ||
snippet.textDisplay |
ต้องระบุ ข้อความของความคิดเห็น ไคลเอ็นต์ API ต้องแสดงข้อความของความคิดเห็นที่ผู้ใช้กำลังแก้ไขหรือลบตามกฎที่กำหนดไว้ในส่วนการแสดงความคิดเห็นของเอกสารนี้ | |
snippet.title ( channel ) |
ต้องระบุ ชื่อของช่อง
|
|
snippet.title ( video ) |
ต้องระบุ หากผู้ใช้กำลังแก้ไขหรือลบความคิดเห็นเกี่ยวกับวิดีโอ ไคลเอ็นต์ API จะต้องแสดงชื่อวิดีโอ | |
ข้อกำหนดอื่นๆ | ||
Comment author's channel name |
ต้องระบุ ไคลเอ็นต์ API จะต้องระบุบัญชีผู้ใช้ YouTube ที่เป็นแหล่งที่มาของความคิดเห็นอย่างชัดเจน |
แบนผู้ใช้จากแชทสด (หรือการแบน)
ชื่อ | คำอธิบาย | |
---|---|---|
พร็อพเพอร์ตี้ของทรัพยากร | ||
snippet.title ( channel ) |
ต้องระบุ ชื่อช่อง YouTube ที่ถูกแบนหรือเลิกแบน นอกจากนี้ ชื่อต้องลิงก์ไปยังช่องหรือ URL ของช่องจะต้องแสดง | |
ข้อกำหนดอื่นๆ | ||
ชื่อช่องของผู้เขียนความคิดเห็น | ต้องระบุ ไคลเอ็นต์ API จะต้องระบุบัญชีผู้ใช้ YouTube ที่ใช้เพื่อเพิ่มหรือนำการแบนอย่างชัดเจน |