บริการ YouTube API - ฟังก์ชันขั้นต่ําที่จําเป็น

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

เอกสารนี้จะระบุข้อกําหนดฟังก์ชันขั้นต่ําสําหรับไคลเอ็นต์ API ที่ใช้งานหรือให้สิทธิ์เข้าถึงฟีเจอร์ที่เฉพาะเจาะจงของบริการ YouTube API ("ไคลเอ็นต์ API")

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

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

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

โปรแกรมเล่นวิดีโอ YouTube และการฝังวิดีโอ YouTube

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

ขนาดโปรแกรมเล่น YouTube แบบฝัง

โปรแกรมเล่นแบบฝังต้องมีวิวพอร์ตที่มีขนาดอย่างน้อย 200 x 200 พิกเซล หากโปรแกรมเล่นแสดงตัวควบคุม ตัวควบคุมต้องมีขนาดใหญ่พอที่จะแสดงตัวควบคุมได้อย่างเต็มรูปแบบโดยไม่ต้องย่อวิวพอร์ตลงต่ํากว่าขนาดขั้นต่ํา เราขอแนะนําให้ใช้โปรแกรมเล่น 16:9 ที่กว้างอย่างน้อย 480 พิกเซลและสูง 270 พิกเซล

การเล่นอัตโนมัติและการเล่นสคริปต์

ส่วนนี้จะครอบคลุมการเล่นอัตโนมัติ ซึ่งมีผลกับโปรแกรมเล่นแบบฝังของ YouTube ที่ใช้พารามิเตอร์โปรแกรมเล่นของ autoplay หรือเริ่มเล่นอัตโนมัติโดยใช้บริการ API ของโปรแกรมเล่น YouTube IFrame, บริการ YouTube Android Player API หรือบริการ API อื่นๆ ของ YouTube

• โปรแกรมเล่นวิดีโอที่ฝังที่เล่นวิดีโอโดยอัตโนมัติควรเริ่มเล่นทันทีเมื่อหน้าเว็บโหลด หรือทันทีที่โปรแกรมเล่นแบบฝังแสดงให้เห็นทั้งหมด อย่างไรก็ตาม ไคลเอ็นต์ 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	Required ชื่อของวิดีโอ YouTube จะแสดงข้อผิดพลาดหากค่ายาวเกิน 100 อักขระ YouTube รองรับอักขระ UTF-8 ที่ถูกต้องทั้งหมด ยกเว้น < และ >
	snippet.description	Required คําอธิบายวิดีโอ YouTube จะแสดงข้อผิดพลาดหากค่าเกิน 5,000 ไบต์ YouTube รองรับอักขระ UTF-8 ที่ถูกต้องทั้งหมด ยกเว้น < และ >
	status.privacyStatus	Required การตั้งค่าความเป็นส่วนตัวของวิดีโอ ผู้ใช้ต้องเลือกได้ว่าจะให้วิดีโอที่อัปโหลดเป็นแบบสาธารณะ ส่วนตัว หรือไม่เป็นสาธารณะ
พารามิเตอร์คําขอ
	onBehalfOfContentOwnerChannel	ต้องระบุตามเงื่อนไข หากข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคําขอระบุเจ้าของเนื้อหาและมีการตั้งค่าพารามิเตอร์ onBehalfOfContentOwner ผู้ใช้ API จะต้องระบุช่อง YouTube ที่อัปโหลดวิดีโอได้ด้วย

การแสดงความคิดเห็น

	ชื่อ	คำอธิบาย
พร็อพเพอร์ตี้ทรัพยากร
	snippet.textDisplay	Required ข้อความความคิดเห็น ไคลเอ็นต์ API ต้อง (ก) แสดงข้อความเต็มของความคิดเห็นหรือการตอบกลับความคิดเห็น หรือ (ข) ตัดข้อความและให้ผู้ชมเข้าถึงข้อความแบบเต็มจากเวอร์ชันที่มีการตัดข้อความได้อย่างง่ายดาย ข้อกําหนดนี้มีผลกับความคิดเห็นและการตอบกลับความคิดเห็นทั้งหมด ไม่ว่าความคิดเห็นจะเชื่อมโยงกับทรัพยากรประเภทใด (วิดีโอ ช่อง ฯลฯ) โปรดทราบว่าค่าพร็อพเพอร์ตี้ snippet.topLevelComment ของทรัพยากร commentThread เป็นทรัพยากร comment และทรัพยากร replies.comments[] เป็น comment ทรัพยากร replies.comments[] ด้วยเหตุนี้ ข้อกําหนดนี้จึงมีผลกับพร็อพเพอร์ตี้ snippet.topLevelComment.snippet.textDisplay และ replies.comments[].snippet.textDisplay ด้วย
	snippet.title (channel)	ต้องระบุ (แนะนํา) ชื่อช่อง หากความคิดเห็นเกี่ยวข้องกับแชแนล ไคลเอ็นต์ API จะต้องแสดงชื่อช่อง หากความคิดเห็นนั้นเกี่ยวข้องกับวิดีโอ ไคลเอ็นต์ API ต้องแสดงชื่อช่องที่อัปโหลดวิดีโอ
	snippet.title (video)	ต้องระบุตามเงื่อนไข (คําแนะนํา) ชื่อของวิดีโอ ค่านี้จะต้องแสดงหากความคิดเห็นเกี่ยวข้องกับวิดีโอ
	snippet.moderationStatus	ต้องระบุตามเงื่อนไข หากค่าพารามิเตอร์ moderationStatus ในคําขอ API คือ heldForReview หรือ likelySpam จอแสดงผลจะต้องระบุสถานะดังกล่าวอย่างชัดเจนโดยใช้ค่าพร็อพเพอร์ตี้ ภาษาที่คล้ายกัน (เช่น "ความคิดเห็นนี้ถูกระงับเพื่อรอตรวจสอบ") ส่วนหัว (เช่น "ระงับเพื่อรอตรวจสอบ") หรือภาษาที่ไม่ชัดเจนอื่นๆ เมธอด commentThreads.list รองรับความสามารถในการเรียกดูความคิดเห็นตามสถานะการดูแล

การเพิ่มความคิดเห็น

	ชื่อ	คำอธิบาย
พร็อพเพอร์ตี้ทรัพยากร
	snippet.title (channel)	Required ชื่อช่อง หากผู้ใช้เพิ่มความคิดเห็นเกี่ยวกับแชแนล ไคลเอ็นต์ API จะต้องแสดงชื่อช่อง หากผู้ใช้เพิ่มความคิดเห็นเกี่ยวกับวิดีโอ ไคลเอ็นต์ API ต้องแสดงชื่อช่องที่อัปโหลดวิดีโอ
	snippet.title (video)	Required หากผู้ใช้เพิ่มความคิดเห็นเกี่ยวกับวิดีโอ ไคลเอ็นต์ API จะต้องแสดงชื่อวิดีโอ
ข้อกําหนดอื่นๆ
	Comment author's channel name	Required ไคลเอ็นต์ API ต้องระบุบัญชีผู้ใช้ YouTube ที่ระบุแหล่งที่มาของความคิดเห็นอย่างชัดเจน หากข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคําขอระบุเจ้าของเนื้อหาและมีการตั้งค่าพารามิเตอร์ onBehalfOfContentOwner ผู้ใช้ API จะต้องระบุช่อง YouTube ที่จะระบุแหล่งที่มาของความคิดเห็นได้ด้วย

กําลังเพิ่มการตอบกลับความคิดเห็น

	ชื่อ	คำอธิบาย
พร็อพเพอร์ตี้ทรัพยากร
	snippet.textDisplay	Required ข้อความความคิดเห็น ไคลเอ็นต์ API ต้องแสดงข้อความของความคิดเห็นที่ผู้ใช้ตอบกลับตามกฎที่ระบุไว้ในส่วนการแสดงความคิดเห็นของเอกสารนี้
	snippet.title (channel)	Required ชื่อช่อง หากผู้ใช้ตอบกลับความคิดเห็นเกี่ยวกับแชแนล ไคลเอ็นต์ API จะต้องแสดงชื่อช่อง หากผู้ใช้ตอบกลับความคิดเห็นเกี่ยวกับวิดีโอ ไคลเอ็นต์ API ต้องแสดงชื่อช่องที่อัปโหลดวิดีโอ
	snippet.title (video)	Required หากผู้ใช้ตอบกลับความคิดเห็นเกี่ยวกับวิดีโอ ไคลเอ็นต์ API จะต้องแสดงชื่อวิดีโอ
ข้อกําหนดอื่นๆ
	Comment author's channel name	Required ไคลเอ็นต์ API ต้องระบุบัญชีผู้ใช้ YouTube ที่ชัดเจนซึ่งเป็นแหล่งที่มาของการตอบกลับความคิดเห็น หากข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคําขอระบุเจ้าของเนื้อหาและมีการตั้งค่าพารามิเตอร์ onBehalfOfContentOwner ผู้ใช้ API จะต้องระบุช่อง YouTube ที่จะระบุแหล่งที่มาของการตอบกลับความคิดเห็นได้ด้วย

การแก้ไขหรือลบการตอบกลับความคิดเห็น

	ชื่อ	คำอธิบาย
พร็อพเพอร์ตี้ทรัพยากร
	snippet.textDisplay	Required ข้อความความคิดเห็น ไคลเอ็นต์ API ต้องแสดงข้อความของความคิดเห็นที่ผู้ใช้กําลังแก้ไขหรือลบตามกฎที่ระบุไว้ในส่วนการแสดงความคิดเห็นของเอกสารนี้
	snippet.title (channel)	Required ชื่อช่อง หากผู้ใช้แก้ไขหรือลบความคิดเห็นเกี่ยวกับแชแนล ไคลเอ็นต์ API จะต้องแสดงชื่อช่อง หากผู้ใช้แก้ไขหรือลบความคิดเห็นเกี่ยวกับวิดีโอ ไคลเอ็นต์ API ต้องแสดงชื่อช่องที่อัปโหลดวิดีโอ
	snippet.title (video)	Required หากผู้ใช้แก้ไขหรือลบความคิดเห็นเกี่ยวกับวิดีโอ ไคลเอ็นต์ API จะต้องแสดงชื่อวิดีโอ
ข้อกําหนดอื่นๆ
	Comment author's channel name	Required ไคลเอ็นต์ API ต้องระบุบัญชีผู้ใช้ YouTube แหล่งที่มาของความคิดเห็นอย่างชัดเจน

การแบนผู้ใช้จากแชทสด (หรือการแบน)

	ชื่อ	คำอธิบาย
พร็อพเพอร์ตี้ทรัพยากร
	snippet.title (channel)	Required ชื่อช่อง YouTube ที่ถูกแบนหรือแบน นอกจากนี้ ชื่อต้องลิงก์ไปยังช่องหรือ URL ของช่องต้องแสดงด้วย
ข้อกําหนดอื่นๆ
	ชื่อช่องของผู้เขียนความคิดเห็น	Required ไคลเอ็นต์ API ต้องระบุบัญชีผู้ใช้ YouTube ที่ใช้ในการเพิ่มหรือนําการแบนออกอย่างชัดเจน