YouTube Data API - Errors

เอกสารนี้ระบุข้อผิดพลาดประเภทต่างๆ ที่การดำเนินการ YouTube Data API อาจแสดง นอกจากนี้ คุณยังดูรายการข้อผิดพลาดของเมธอดแต่ละรายการได้ในเอกสารอ้างอิงสำหรับเมธอดนั้น

ข้อผิดพลาดทั่วไป

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

Core API errors

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
forbidden (403)	forbidden	ห้ามเข้าถึง คำขออาจไม่ได้รับอนุญาตอย่างเหมาะสม
quotaExceeded (403)	quotaExceeded	ไม่สามารถดำเนินการตามคำขอได้เนื่องจากคุณใช้โควต้าเกิน

Common request errors

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	incompatibleParameters	คำขอระบุพารามิเตอร์อย่างน้อย 2 รายการที่ใช้ในคำขอเดียวกันไม่ได้
badRequest (400)	invalidFilters	คำขอระบุพารามิเตอร์ตัวกรองที่ไม่ถูกต้อง
badRequest (400)	invalidPageToken	คำขอระบุโทเค็นหน้าเว็บไม่ถูกต้อง
badRequest (400)	missingRequiredParameter	คำขอไม่มีพารามิเตอร์ที่จำเป็น
badRequest (400)	unexpectedParameter	คำขอระบุพารามิเตอร์ที่ไม่คาดคิด
forbidden (403)	accountDelegationForbidden	ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วไม่สามารถดำเนินการในนามของบัญชี Google ที่ระบุ
forbidden (403)	authenticatedUserAccountClosed	บัญชี YouTube ของผู้ใช้ที่ตรวจสอบสิทธิ์ถูกปิด ในกรณีที่ผู้ใช้ที่ตรวจสอบสิทธิ์ดำเนินการในนามของบัญชี Google อื่น ข้อผิดพลาดนี้หมายถึงบัญชีหลัง
forbidden (403)	authenticatedUserAccountSuspended	บัญชี YouTube ของผู้ใช้ที่ตรวจสอบสิทธิ์แล้วถูกระงับ ในกรณีที่ผู้ใช้ที่ตรวจสอบสิทธิ์ดำเนินการในนามของบัญชี Google อื่น ข้อผิดพลาดนี้หมายถึงบัญชีหลัง
forbidden (403)	authenticatedUserNotChannel	สําหรับคําขอนี้ ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วต้องแก้ไขเป็นช่อง แต่ไม่ได้ดำเนินการ หากคําขอได้รับการตรวจสอบสิทธิ์และใช้พารามิเตอร์การมอบสิทธิ์ onBehalfOfContentOwner คุณควรตั้งค่าพารามิเตอร์ onBehalfOfContentOwnerChannel ด้วย
forbidden (403)	channelClosed	ช่องที่ระบุในคำขอถูกปิดแล้ว
forbidden (403)	channelNotFound	ไม่พบช่องที่ระบุในคำขอ
forbidden (403)	channelSuspended	ช่องที่ระบุในคำขอถูกระงับแล้ว
forbidden (403)	cmsUserAccountNotFound	ผู้ใช้ CMS ไม่ได้รับอนุญาตให้ดำเนินการในนามของเจ้าของเนื้อหาที่ระบุ
forbidden (403)	insufficientCapabilities	ผู้ใช้ CMS มีความสามารถไม่เพียงพอ
forbidden (403)	insufficientPermissions	โทเค็น OAuth 2.0 ที่ระบุสำหรับคำขอระบุขอบเขตที่ไม่เพียงพอสำหรับการเข้าถึงข้อมูลที่ขอ
notFound (404)	contentOwnerAccountNotFound	ไม่พบบัญชีเจ้าของเนื้อหาที่ระบุ

Request context errors

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	invalidLanguage	ค่าพารามิเตอร์ hl ไม่ได้ระบุรหัสภาษาที่ถูกต้อง
badRequest (400)	invalidMine	ระบบไม่รองรับการใช้พารามิเตอร์ mine ของคำขอ
badRequest (400)	invalidMine	คุณใช้พารามิเตอร์ mine ในคำขอที่ผู้ใช้ที่ตรวจสอบสิทธิ์แล้วเป็นพาร์ทเนอร์ YouTube ไม่ได้ คุณควรนําพารามิเตอร์ mine ออก ตรวจสอบสิทธิ์ในฐานะผู้ใช้ YouTube โดยการนําพารามิเตอร์ onBehalfOfContentOwner ออก หรือทําตัวเป็นช่องของพาร์ทเนอร์โดยระบุพารามิเตอร์ onBehalfOfContentOwnerChannel หากมีสําหรับเมธอดที่เรียกใช้
badRequest (400)	invalidPart	พารามิเตอร์ part ของคําขอระบุบางส่วนที่เขียนพร้อมกันไม่ได้
badRequest (400)	invalidRegionCode	พารามิเตอร์ regionCode ระบุรหัสภูมิภาคที่ไม่ถูกต้อง
badRequest (400)	unexpectedPart	พารามิเตอร์ part ของคําขอระบุค่าที่ไม่คาดคิด
badRequest (400)	unknownPart	พารามิเตอร์ part ของคําขอระบุค่าที่ไม่รู้จัก
badRequest (400)	unsupportedLanguageCode	ค่าพารามิเตอร์ hl ไม่ได้ระบุรหัสภาษาที่รองรับ
badRequest (400)	unsupportedRegionCode	พารามิเตอร์ regionCode ระบุรหัสภูมิภาคที่ไม่รองรับ
unauthorized (401)	authorizationRequired	คำขอใช้พารามิเตอร์ mine แต่ไม่ได้รับอนุญาตอย่างถูกต้อง
unauthorized (401)	youtubeSignupRequired	ข้อผิดพลาดนี้บ่งบอกว่าผู้ใช้มีบัญชี Google ที่ยกเลิกการลิงก์แล้ว ซึ่งหมายความว่าผู้ใช้มีบัญชี Google แต่ไม่มีช่อง YouTube ผู้ใช้ดังกล่าวจะเข้าถึงฟีเจอร์ต่างๆ ที่ขึ้นอยู่กับการให้สิทธิ์ของผู้ใช้ได้ เช่น การให้คะแนนวิดีโอหรือการเพิ่มวิดีโอลงในเพลย์ลิสต์ watch_later อย่างไรก็ตาม ผู้ใช้จะต้องมีช่อง YouTube จึงจะอัปโหลดวิดีโอได้ ผู้ใช้ที่มีบัญชี Gmail หรืออุปกรณ์ Android ต้องมีบัญชี Google อย่างแน่นอน แต่อาจยังไม่ได้ลิงก์บัญชี Google นั้นกับช่อง YouTube ข้อผิดพลาดนี้มักเกิดขึ้นเมื่อคุณพยายามใช้ขั้นตอนบัญชีบริการ OAuth 2.0 YouTube ไม่รองรับบัญชีบริการ และคุณจะพบข้อผิดพลาดนี้หากพยายามตรวจสอบสิทธิ์โดยใช้บัญชีบริการ บล็อกโพสต์ YouTube API ที่แนะนำการรองรับบัญชี Google จะกล่าวถึงข้อผิดพลาด youtubeSignupRequired โดยละเอียดด้วย แม้ว่าบล็อกโพสต์จะอธิบายข้อผิดพลาดสำหรับ API เวอร์ชัน 2.1 แต่ความหมายของข้อผิดพลาดก็ยังคงใช้ได้

กิจกรรม

YouTube ได้เลิกใช้งานฟีเจอร์กระดานข่าวสารของช่องแล้ว ระบบไม่รองรับวิธีการ activities.insert อีกต่อไป

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

activities.list

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
forbidden (403)	homeParameterDeprecated	ข้อมูลกิจกรรมในหน้าแรกของผู้ใช้ไม่พร้อมใช้งานผ่าน API นี้ ข้อผิดพลาดนี้อาจเกิดขึ้นหากคุณตั้งค่าพารามิเตอร์ home เป็น true ในคําขอที่ไม่ได้รับอนุญาต
forbidden (403)	forbidden	คำขอไม่ได้รับอนุญาตอย่างถูกต้อง
notFound (404)	channelNotFound	ไม่พบรหัสช่องที่ระบุโดยพารามิเตอร์ channelId ของคําขอ
notFound (404)	homeChannelNotFound	ไม่พบฟีดหน้าแรกของ YouTube สำหรับผู้ใช้ที่ตรวจสอบสิทธิ์อยู่ในขณะนี้
unauthorized (401)	authorizationRequired	คำขอใช้พารามิเตอร์ home แต่ไม่ได้รับอนุญาตอย่างถูกต้อง

คำบรรยายวิดีโอ

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

captions.delete

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
forbidden (403)	forbidden	สิทธิ์ที่เชื่อมโยงกับคำขอไม่เพียงพอที่จะลบแทร็กคำบรรยายแทนเสียง คำขออาจไม่ได้รับอนุญาตอย่างเหมาะสม
notFound (404)	captionNotFound	ไม่พบแทร็กคำบรรยาย ตรวจสอบค่าของพารามิเตอร์ id ของคำขอเพื่อให้แน่ใจว่าถูกต้อง

captions.download

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
forbidden (403)	forbidden	สิทธิ์ที่เชื่อมโยงกับคำขอไม่เพียงพอที่จะดาวน์โหลดแทร็กคำบรรยายแทนเสียง คำขออาจไม่ได้รับอนุญาตอย่างเหมาะสม
invalidValue (400)	couldNotConvert	แปลงข้อมูลแทร็กคำบรรยายเป็นภาษาและ/หรือรูปแบบที่ขอไม่ได้ ตรวจสอบว่าค่า tfmt และ tlang ที่ขอนั้นถูกต้อง และ snippet.status ของแทร็กคำบรรยายแทนเสียงที่ขอนั้นไม่ใช่ failed
notFound (404)	captionNotFound	ไม่พบแทร็กคำบรรยาย ตรวจสอบค่าของพารามิเตอร์ id ของคำขอเพื่อให้แน่ใจว่าถูกต้อง

captions.insert

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	contentRequired	คำขอไม่มีเนื้อหาแทร็กคำบรรยายแทนเสียง
conflict (409)	captionExists	วิดีโอที่ระบุมีแทร็กคำบรรยายแทนเสียงที่มี snippet.language และ snippet.name ดังกล่าวอยู่แล้ว วิดีโออาจมีหลายแทร็กสำหรับภาษาเดียวกัน แต่แต่ละแทร็กต้องมีชื่อต่างกัน การแก้ไขข้อผิดพลาดนี้ทำได้หลายวิธี คุณสามารถลบแทร็กที่มีอยู่แล้วแทรกแทร็กใหม่ หรือเปลี่ยนชื่อแทร็กใหม่ก่อนที่จะแทรกก็ได้
forbidden (403)	forbidden	สิทธิ์ที่เชื่อมโยงกับคำขอไม่เพียงพอที่จะอัปโหลดแทร็กคำบรรยายแทนเสียง คำขออาจไม่ได้รับอนุญาตอย่างเหมาะสม
invalidValue (400)	invalidMetadata	คำขอมีค่าข้อมูลเมตาที่ไม่ถูกต้อง ซึ่งทำให้ระบบสร้างแทร็กไม่ได้ ยืนยันว่าคำขอระบุค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้ snippet.language, snippet.name และ snippet.videoId คุณรวมพร็อพเพอร์ตี้ snippet.isDraft ได้ด้วย แต่ไม่จําเป็น
notFound (404)	videoNotFound	ไม่พบวิดีโอที่ระบุโดยพารามิเตอร์ videoId
invalidValue (400)	nameTooLong	snippet.name ที่ระบุในคำขอยาวเกินไป ความยาวสูงสุดที่รองรับคือ 150 อักขระ

captions.list

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
forbidden (403)	forbidden	ดึงข้อมูลแทร็กคำบรรยายแทนเสียงอย่างน้อย 1 รายการไม่ได้เนื่องจากสิทธิ์ที่เชื่อมโยงกับคำขอไม่เพียงพอที่จะดึงข้อมูลทรัพยากรที่ขอ คำขออาจไม่ได้รับอนุญาตอย่างเหมาะสม
notFound (404)	captionNotFound	ไม่พบแทร็กคำบรรยายแทนเสียงที่ระบุอย่างน้อย 1 รายการ ข้อผิดพลาดนี้เกิดขึ้นหากพารามิเตอร์ videoId ระบุวิดีโอจริง แต่พารามิเตอร์ id ระบุรหัสแทร็กคำบรรยายที่ไม่มีอยู่หรือรหัสแทร็กที่เกี่ยวข้องกับวิดีโออื่น ตรวจสอบค่าของพารามิเตอร์ id และ videoId ของคําขอเพื่อให้แน่ใจว่าถูกต้อง
notFound (404)	videoNotFound	ไม่พบวิดีโอที่ระบุโดยพารามิเตอร์ videoId

captions.update

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	contentRequired	คำขอไม่ได้อัปโหลดไฟล์คำบรรยายที่อัปเดตแล้ว ต้องมีเนื้อหาแทร็กจริงหากตั้งค่าพารามิเตอร์ sync เป็น true
forbidden (403)	forbidden	สิทธิ์ที่เชื่อมโยงกับคำขอไม่เพียงพอที่จะอัปเดตแทร็กคำบรรยายแทนเสียง คำขออาจไม่ได้รับอนุญาตอย่างเหมาะสม
notFound (404)	captionNotFound	ไม่พบแทร็กคำบรรยายที่ระบุ ตรวจสอบค่าของพารามิเตอร์ id ของคำขอเพื่อให้แน่ใจว่าถูกต้อง

channelBanners

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

channelBanners.insert

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

channelSections

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

channelSections.delete

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	notEditable	ลบส่วนช่องนี้ไม่ได้
forbidden (403)	channelSectionForbidden	คำขอไม่ได้รับการตรวจสอบสิทธิ์อย่างถูกต้องหรือไม่รองรับสำหรับช่องนี้
invalidValue (400)	idInvalid	พร็อพเพอร์ตี้ id ระบุรหัสส่วนช่องที่ไม่ถูกต้อง
invalidValue (400)	idRequired	พร็อพเพอร์ตี้ id ต้องระบุค่าที่ระบุส่วนในช่องที่จะลบ
notFound (404)	channelNotFound	ไม่พบช่อง
notFound (404)	channelSectionNotFound	ไม่พบส่วนช่องที่คุณพยายามอัปเดต

channelSections.insert

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	defaultLanguageNotSetError	ต้องตั้งค่าพร็อพเพอร์ตี้ snippet.defaultLanguage ของแหล่งข้อมูล channelSection เพื่อแทรกหรืออัปเดตออบเจ็กต์ localizations ของแหล่งข้อมูลนั้นให้สําเร็จ
badRequest (400)	invalidLanguage	คีย์ภาษารายการใดรายการหนึ่งของออบเจ็กต์ localizations ตรวจสอบไม่สำเร็จ ใช้เมธอด channelSections.list เพื่อดึงค่าที่ถูกต้องและอัปเดตค่าตามหลักเกณฑ์ในเอกสารประกอบของทรัพยากร a href="/youtube/v3/docs/channelSections#resource">channelSections
badRequest (400)	notEditable	สร้างส่วนช่องนี้ไม่ได้
badRequest (400)	styleRequired	ทรัพยากร channelSection ต้องระบุค่าสำหรับช่อง snippet.style
badRequest (400)	targetInvalidCountry	ค่าใดค่าหนึ่งในรายการ targeting.countries ตรวจสอบไม่ผ่าน ใช้เมธอด channelSections.list เพื่อดึงค่าที่ถูกต้องและอัปเดตค่าตามหลักเกณฑ์ในเอกสารประกอบของทรัพยากร a href="/youtube/v3/docs/channelSections#resource">channelSections
badRequest (400)	targetInvalidLanguage	ค่าใดค่าหนึ่งในรายการ targeting.languages ตรวจสอบไม่ผ่าน ใช้เมธอด channelSections.list เพื่อดึงค่าที่ถูกต้องและอัปเดตค่าตามหลักเกณฑ์ในเอกสารประกอบของทรัพยากร a href="/youtube/v3/docs/channelSections#resource">channelSections
badRequest (400)	targetInvalidRegion	ค่าใดค่าหนึ่งในรายการ targeting.regions ตรวจสอบไม่ผ่าน ใช้เมธอด channelSections.list เพื่อดึงค่าที่ถูกต้องและอัปเดตค่าตามหลักเกณฑ์ในเอกสารประกอบของทรัพยากร a href="/youtube/v3/docs/channelSections#resource">channelSections
badRequest (400)	typeRequired	ทรัพยากร channelSection ต้องระบุค่าสำหรับช่อง snippet.type
forbidden (403)	channelSectionForbidden	คำขอไม่ได้รับการตรวจสอบสิทธิ์อย่างถูกต้องหรือไม่รองรับสำหรับช่องนี้
invalidValue (400)	channelNotActive	แชแนลที่ระบุอย่างน้อย 1 รายการไม่ทำงาน
invalidValue (400)	channelsDuplicated	คำขอล้มเหลวเนื่องจากระบุแชแนลที่ซ้ำกัน
invalidValue (400)	channelsNeeded	หากพร็อพเพอร์ตี้ snippet.type มีค่าเป็น multipleChannels จะต้องระบุพร็อพเพอร์ตี้ contentDetails.channels[] และต้องระบุแชแนลอย่างน้อย 1 รายการ
invalidValue (400)	channelsNotExpected	ทรัพยากรที่ระบุพร้อมกับคําขอระบุค่าสําหรับพร็อพเพอร์ตี้ contentDetails.channels[] แต่ส่วนแชแนลประเภทนี้ไม่จําเป็นต้องมีแชแนล
invalidValue (400)	contentDetailsNeeded	ทรัพยากรที่คุณแทรกต้องมีออบเจ็กต์ contentDetails สำหรับส่วนในช่องประเภทนี้
invalidValue (400)	inValidPosition	พร็อพเพอร์ตี้ snippet.position มีค่าที่ไม่ถูกต้อง
invalidValue (400)	maxChannelSectionExceeded	ดำเนินการตามคำขอไม่ได้เนื่องจากช่องมีส่วนในช่องถึงจำนวนสูงสุดแล้ว
invalidValue (400)	maxChannelsExceeded	คำขอล้มเหลวเนื่องจากพยายามรวมช่องมากเกินไปในส่วนช่อง
invalidValue (400)	maxPlaylistExceeded	คำขอล้มเหลวเนื่องจากพยายามรวมเพลย์ลิสต์มากเกินไปในส่วนช่อง
invalidValue (400)	onePlaylistNeeded	หากพร็อพเพอร์ตี้ snippet.type มีค่าเป็น singlePlaylist พร็อพเพอร์ตี้ contentDetails.playlists[] ต้องระบุเพลย์ลิสต์เพียงรายการเดียว
invalidValue (400)	ownChannelInChannels	คุณไม่สามารถรวมช่องของคุณเองในส่วนช่องที่ปรากฏในช่องนั้น
invalidValue (400)	playlistIsPrivate	เพลย์ลิสต์ที่ระบุอย่างน้อย 1 รายการเป็นแบบส่วนตัว จึงรวมไว้ในส่วนช่องไม่ได้
invalidValue (400)	playlistsDuplicated	คำขอล้มเหลวเนื่องจากระบุเพลย์ลิสต์ที่ซ้ำกัน
invalidValue (400)	playlistsNeeded	หากพร็อพเพอร์ตี้ snippet.type มีค่าเป็น singlePlaylist หรือ multiplePlaylists ก็จะต้องระบุพร็อพเพอร์ตี้ contentDetails.playlists[]
invalidValue (400)	playlistsNotExpected	ทรัพยากรที่ระบุพร้อมกับคำขอระบุค่าสำหรับพร็อพเพอร์ตี้ contentDetails.playlists[] แต่ส่วนช่องประเภทนี้ไม่อนุญาตให้ใช้เพลย์ลิสต์
invalidValue (400)	snippetNeeded	คุณต้องระบุ snippet เพื่อสร้างส่วนช่อง
invalidValue (400)	titleLengthExceeded	ค่าของพร็อพเพอร์ตี้ snippet.title ยาวเกินไป
invalidValue (400)	titleRequired	หากพร็อพเพอร์ตี้ snippet.type มีค่าเป็น multiplePlaylists หรือ multipleChannels คุณต้องตั้งค่าชื่อของส่วนโดยระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.title
notFound (404)	channelNotFound	ไม่พบช่องที่ระบุอย่างน้อย 1 ช่อง
notFound (404)	playlistNotFound	ไม่พบเพลย์ลิสต์ที่ระบุอย่างน้อย 1 รายการ

channelSections.list

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
forbidden (403)	channelSectionForbidden	ผู้ขอไม่ได้รับอนุญาตให้เข้าถึงส่วนต่างๆ ของช่องที่ขอ
invalidValue (400)	idInvalid	คำขอระบุรหัสส่วนช่องที่ไม่ถูกต้อง
invalidValue (400)	invalidCriteria	ดำเนินการตามคำขอให้เสร็จสมบูรณ์ไม่ได้เนื่องจากเกณฑ์ตัวกรองไม่ถูกต้อง
notFound (404)	channelNotFound	ไม่พบช่องที่เชื่อมโยงกับคำขอ
notFound (404)	channelSectionNotFound	ไม่พบส่วนช่องที่เชื่อมโยงกับคำขอ

channelSections.update

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	defaultLanguageNotSetError	ต้องตั้งค่าพร็อพเพอร์ตี้ snippet.defaultLanguage ของแหล่งข้อมูล channelSection เพื่อแทรกหรืออัปเดตออบเจ็กต์ localizations ของแหล่งข้อมูลนั้นให้สําเร็จ
badRequest (400)	invalidLanguage	คีย์ภาษารายการใดรายการหนึ่งของออบเจ็กต์ localizations ตรวจสอบไม่สำเร็จ ใช้เมธอด channelSections.list เพื่อดึงค่าที่ถูกต้องและอัปเดตค่าตามหลักเกณฑ์ในเอกสารประกอบของทรัพยากร a href="/youtube/v3/docs/channelSections#resource">channelSections
badRequest (400)	notEditable	ไม่สามารถแก้ไขส่วนนี้ของช่องได้
badRequest (400)	styleRequired	ทรัพยากร channelSection ต้องระบุค่าสำหรับช่อง snippet.style
badRequest (400)	targetInvalidCountry	ค่าใดค่าหนึ่งในรายการ targeting.countries ตรวจสอบไม่ผ่าน ใช้เมธอด channelSections.list เพื่อดึงค่าที่ถูกต้องและอัปเดตค่าตามหลักเกณฑ์ในเอกสารประกอบของทรัพยากร a href="/youtube/v3/docs/channelSections#resource">channelSections
badRequest (400)	targetInvalidLanguage	ค่าใดค่าหนึ่งในรายการ targeting.languages ตรวจสอบไม่ผ่าน ใช้เมธอด channelSections.list เพื่อดึงค่าที่ถูกต้องและอัปเดตค่าตามหลักเกณฑ์ในเอกสารประกอบของทรัพยากร a href="/youtube/v3/docs/channelSections#resource">channelSections
badRequest (400)	targetInvalidRegion	ค่าใดค่าหนึ่งในรายการ targeting.regions ตรวจสอบไม่ผ่าน ใช้เมธอด channelSections.list เพื่อดึงค่าที่ถูกต้องและอัปเดตค่าตามหลักเกณฑ์ในเอกสารประกอบของทรัพยากร a href="/youtube/v3/docs/channelSections#resource">channelSections
badRequest (400)	typeRequired	ทรัพยากร channelSection ต้องระบุค่าสำหรับช่อง snippet.type
forbidden (403)	channelSectionForbidden	คำขอไม่ได้รับการตรวจสอบสิทธิ์อย่างถูกต้องหรือไม่รองรับสำหรับช่องนี้
invalidValue (400)	channelNotActive	แชแนลที่ระบุอย่างน้อย 1 รายการไม่ทำงาน
invalidValue (400)	channelsDuplicated	คำขอล้มเหลวเนื่องจากระบุแชแนลที่ซ้ำกัน
invalidValue (400)	channelsNeeded	หากพร็อพเพอร์ตี้ snippet.type มีค่าเป็น multipleChannels จะต้องระบุพร็อพเพอร์ตี้ contentDetails.channels[] และต้องระบุแชแนลอย่างน้อย 1 รายการ
invalidValue (400)	channelsNotExpected	ทรัพยากรที่ระบุพร้อมกับคําขอระบุค่าสําหรับพร็อพเพอร์ตี้ contentDetails.channels[] แต่ส่วนแชแนลประเภทนี้ไม่จําเป็นต้องมีแชแนล
invalidValue (400)	contentDetailsNeeded	ทรัพยากรที่คุณอัปเดตต้องมีออบเจ็กต์ contentDetails สำหรับส่วนในช่องประเภทนี้
invalidValue (400)	idInvalid	พร็อพเพอร์ตี้ id ระบุรหัสส่วนช่องที่ไม่ถูกต้อง
invalidValue (400)	idRequired	พร็อพเพอร์ตี้ id ต้องระบุค่าที่ระบุส่วนในช่องที่จะอัปเดต
invalidValue (400)	inValidPosition	พร็อพเพอร์ตี้ snippet.position มีค่าที่ไม่ถูกต้อง
invalidValue (400)	maxChannelsExceeded	คำขอล้มเหลวเนื่องจากพยายามรวมช่องมากเกินไปในส่วนช่อง
invalidValue (400)	maxPlaylistExceeded	คำขอล้มเหลวเนื่องจากพยายามรวมเพลย์ลิสต์มากเกินไปในส่วนช่อง
invalidValue (400)	onePlaylistNeeded	หากพร็อพเพอร์ตี้ snippet.type มีค่าเป็น singlePlaylist พร็อพเพอร์ตี้ contentDetails.playlists[] ต้องระบุเพลย์ลิสต์เพียงรายการเดียว
invalidValue (400)	ownChannelInChannels	คุณไม่สามารถรวมช่องของคุณเองในส่วนช่องที่ปรากฏในช่องนั้น
invalidValue (400)	playlistIsPrivate	เพลย์ลิสต์ที่ระบุอย่างน้อย 1 รายการเป็นแบบส่วนตัว จึงรวมไว้ในส่วนช่องไม่ได้
invalidValue (400)	playlistsDuplicated	คำขอล้มเหลวเนื่องจากระบุเพลย์ลิสต์ที่ซ้ำกัน
invalidValue (400)	playlistsNeeded	หากพร็อพเพอร์ตี้ snippet.type มีค่าเป็น singlePlaylist หรือ multiplePlaylists ก็จะต้องระบุพร็อพเพอร์ตี้ contentDetails.playlists[]
invalidValue (400)	playlistsNotExpected	ทรัพยากรที่ระบุพร้อมกับคำขอระบุค่าสำหรับพร็อพเพอร์ตี้ contentDetails.playlists[] แต่ส่วนช่องประเภทนี้ไม่อนุญาตให้ใช้เพลย์ลิสต์
invalidValue (400)	snippetNeeded	คุณต้องระบุ snippet เพื่ออัปเดตส่วนแชแนล
invalidValue (400)	titleLengthExceeded	ค่าของพร็อพเพอร์ตี้ snippet.title ยาวเกินไป
invalidValue (400)	titleRequired	หากพร็อพเพอร์ตี้ snippet.type มีค่าเป็น multiplePlaylists หรือ multipleChannels คุณต้องตั้งค่าชื่อของส่วนโดยระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.title
notFound (404)	channelNotFound	ไม่พบช่องที่ระบุอย่างน้อย 1 ช่อง
notFound (404)	channelSectionNotFound	ไม่พบส่วนช่องที่คุณพยายามอัปเดต
notFound (404)	playlistNotFound	ไม่พบเพลย์ลิสต์ที่ระบุอย่างน้อย 1 รายการ

ช่อง

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

channels.list

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	invalidCriteria	คุณสามารถระบุตัวกรองได้สูงสุด 1 รายการจากid, mySubscribers, categoryId, mine, managedByMe, forUsername ในกรณีที่ใช้การตรวจสอบสิทธิ์เจ้าของเนื้อหาโดยใช้พารามิเตอร์ onBehalfOfContentOwner คุณจะระบุได้เฉพาะ id หรือ managedByMe เท่านั้น
forbidden (403)	channelForbidden	แชแนลที่ระบุโดยพารามิเตอร์ id ไม่รองรับคําขอ หรือคําขอไม่ได้รับอนุญาตอย่างถูกต้อง
notFound (404)	categoryNotFound	ไม่พบหมวดหมู่ที่ระบุโดยพารามิเตอร์ categoryId ใช้เมธอด guideCategories.list เพื่อดึงข้อมูลรายการค่าที่ถูกต้อง
notFound (404)	channelNotFound	ไม่พบช่องที่ระบุไว้ในพารามิเตอร์ id

channels.update

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	brandingValidationError	ค่าใดค่าหนึ่งในออบเจ็กต์ brandingSettings ตรวจสอบไม่ผ่าน ใช้เมธอด channels.list เพื่อดึงข้อมูลการตั้งค่าที่มีอยู่ของช่อง และอัปเดตค่าพร็อพเพอร์ตี้ตามหลักเกณฑ์ในเอกสารประกอบของทรัพยากร channels
badRequest (400)	channelTitleUpdateForbidden	เมื่ออัปเดต brandingSettings part ของช่อง คุณต้องตั้งค่าของพร็อพเพอร์ตี้ brandingSettings.channel.title เป็นชื่อปัจจุบันของช่อง หรือจะละเว้นพร็อพเพอร์ตี้นี้ก็ได้ API จะแสดงข้อผิดพลาดหากคุณเปลี่ยนค่าของพร็อพเพอร์ตี้
badRequest (400)	defaultLanguageNotSetError	คุณต้องตั้งค่า defaultLanguage เพื่ออัปเดต localizations
badRequest (400)	invalidBrandingOption	การตั้งค่าการสร้างแบรนด์ที่คุณระบุไม่มีอยู่ ใช้เมธอด channels.list เพื่อดึงค่าที่ถูกต้อง และอย่าลืมอัปเดตค่าตามหลักเกณฑ์ในเอกสารประกอบแหล่งข้อมูล channels
badRequest (400)	invalidCustomMessage	ข้อมูลเมตาของคําขอระบุข้อความที่กําหนดเองไม่ถูกต้อง ตรวจสอบค่าของพร็อพเพอร์ตี้ invideoPromotion.items[].customMessage ในทรัพยากรที่ส่งคำขอ
badRequest (400)	invalidDuration	ข้อมูลเมตาของคำขอระบุระยะเวลาที่ไม่ถูกต้องในส่วน invideoPromotion
badRequest (400)	invalidDuration	ข้อมูลเมตาคำขอระบุประเภทตำแหน่งที่ไม่ถูกต้องสำหรับกำหนดตำแหน่งของรายการที่โปรโมตในวิดีโอเพลเยอร์ ตรวจสอบค่าของพร็อพเพอร์ตี้ invideoPromotion.position.type ในทรัพยากรที่ส่งคำขอ
badRequest (400)	invalidRecentlyUploadedBy	ข้อมูลเมตาของคำขอระบุรหัสช่องที่ไม่ถูกต้อง ตรวจสอบค่าของพร็อพเพอร์ตี้ invideoPromotion.items[].id.recentlyUploadedBy ในทรัพยากรที่ส่งคำขอ
badRequest (400)	invalidTimingOffset	ข้อมูลเมตาของคำขอระบุการเลื่อนเวลาที่ไม่ถูกต้องในส่วน invideoPromotion
badRequest (400)	invalidTimingOffset	ข้อมูลเมตาคำขอระบุการเลื่อนเวลาที่ไม่ถูกต้องสำหรับกำหนดเวลาที่ควรแสดงรายการที่โปรโมตในวิดีโอเพลเยอร์ ตรวจสอบค่าของพร็อพเพอร์ตี้ invideoPromotion.timing.offsetMs ในทรัพยากรที่ส่งคำขอ
badRequest (400)	invalidTimingType	ข้อมูลเมตาของคำขอระบุวิธีการกำหนดเวลาที่ไม่ถูกต้องสำหรับกำหนดเวลาที่รายการที่โปรโมตควรแสดงในวิดีโอเพลเยอร์ ตรวจสอบค่าของพร็อพเพอร์ตี้ invideoPromotion.timing.type ในทรัพยากรที่ส่งคำขอ
badRequest (400)	localizationValidationError	ค่าหนึ่งในออบเจ็กต์การแปลไม่ผ่านการตรวจสอบ ใช้เมธอด channels.list เพื่อดึงค่าที่ถูกต้อง และอย่าลืมอัปเดตค่าตามหลักเกณฑ์ในเอกสารประกอบเกี่ยวกับทรัพยากรของช่อง
badRequest (400)	tooManyPromotedItems	รายการที่โปรโมตที่อนุญาตมีจำนวนเกินในส่วน invideoPromotion
forbidden (403)	channelForbidden	แชแนลที่ระบุไว้ในพารามิเตอร์ id ไม่รองรับคําขอ หรือคําขอไม่ได้รับอนุญาตอย่างถูกต้อง
forbidden (403)	promotedVideoNotAllowed	ไม่พบช่องที่คำขอ API พยายามอัปเดต ตรวจสอบค่าของพร็อพเพอร์ตี้ id ในทรัพยากร channel ที่ส่งคำขอเพื่อให้แน่ใจว่ารหัสช่องถูกต้อง
forbidden (403)	websiteLinkNotAllowed	ไม่อนุญาตให้ใช้ URL ของเว็บไซต์ที่ระบุ
notFound (404)	channelNotFound	ไม่พบช่องที่ระบุโดยพารามิเตอร์ id หรือช่องไม่มีตัวเลือกการสร้างแบรนด์
notFound (404)	channelNotFound	ไม่พบช่องที่ระบุไว้ในพารามิเตอร์ id
notFound (404)	unknownChannelId	ไม่พบรหัสช่องที่ระบุ
notFound (404)	unknownChannelId	ไม่พบรหัสช่อง recentlyUploadedBy ที่ระบุ
notFound (404)	unknownVideoId	ไม่พบรหัสวิดีโอที่ระบุเป็นรายการที่โปรโมต
required (400)	requiredItemIdType	ข้อมูลเมตาของคำขอต้องระบุประเภทรายการในส่วน invideoPromotion
required (400)	requiredItemId	ข้อมูลเมตาของคำขอต้องระบุรายการในส่วน invideoPromotion
required (400)	requiredTimingOffset	ข้อมูลเมตาของคำขอต้องระบุการเลื่อนเวลาเริ่มต้นเพื่อให้ YouTube กำหนดเวลาที่จะแสดงรายการที่โปรโมตได้ ตั้งค่าพร็อพเพอร์ตี้ invideoPromotion.defaultTiming.offsetMs ในทรัพยากรที่คําขอส่ง
required (400)	requiredTimingOffset	ข้อมูลเมตาคำขอต้องระบุการเลื่อนเวลาเพื่อให้ YouTube กำหนดเวลาที่จะแสดงรายการที่โปรโมตได้ ตั้งค่าพร็อพเพอร์ตี้ invideoPromotion.timing.offsetMs ในทรัพยากรที่คําขอส่ง
required (400)	requiredTimingType	ข้อมูลเมตาคำขอต้องระบุวิธีการกำหนดเวลาเพื่อให้ YouTube กำหนดเวลาที่จะแสดงรายการที่โปรโมตได้ ตั้งค่าพร็อพเพอร์ตี้ invideoPromotion.defaultTiming.type ในทรัพยากรที่คําขอส่ง
required (400)	requiredTimingType	ข้อมูลเมตาของคำขอต้องระบุวิธีการกำหนดเวลาเพื่อให้ YouTube กำหนดได้ว่าควรแสดงรายการที่โปรโมตเมื่อใด ตั้งค่าพร็อพเพอร์ตี้ invideoPromotion.timing.type ในทรัพยากรที่คําขอส่ง
required (400)	requiredTiming	ข้อมูลเมตาของคำขอต้องระบุเวลาของรายการแต่ละรายการในส่วน invideoPromotion
required (400)	requiredVideoId	ข้อมูลเมตาของคำขอต้องระบุรหัสวิดีโอเพื่อระบุรายการที่โปรโมต
required (400)	requiredWebsiteUrl	ข้อมูลเมตาของคำขอต้องระบุ URL ของเว็บไซต์ในส่วน invideoPromotion ตั้งค่าพร็อพเพอร์ตี้ invideoPromotion.items[].id.websiteUrl ในทรัพยากรที่คําขอส่ง

commentThreads

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

commentThreads.list

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	operationNotSupported	คำขอ API ไม่ถูกต้องหรือมีรูปแบบไม่ถูกต้อง ทำให้เซิร์ฟเวอร์ API ไม่เข้าใจคำขอ
badRequest (400)	processingFailure	เซิร์ฟเวอร์ API ประมวลผลคําขอไม่สําเร็จ แม้ว่านี่อาจเป็นข้อผิดพลาดชั่วคราว แต่มักบ่งบอกว่าอินพุตของคําขอไม่ถูกต้อง ตรวจสอบโครงสร้างของทรัพยากร commentThread ในเนื้อหาคำขอเพื่อให้แน่ใจว่าถูกต้อง
forbidden (403)	commentsDisabled	วิดีโอที่ระบุโดยพารามิเตอร์ videoId ปิดใช้ความคิดเห็น
forbidden (403)	forbidden	ดึงข้อมูลชุดข้อความความคิดเห็นที่ขออย่างน้อย 1 ชุดไม่ได้เนื่องจากมีสิทธิ์ไม่เพียงพอ คำขออาจไม่ได้รับอนุญาตอย่างเหมาะสม
notFound (404)	channelNotFound	ไม่พบแชแนลที่ระบุโดยพารามิเตอร์ allThreadsRelatedToChannelId
notFound (404)	commentThreadNotFound	ไม่พบชุดข้อความความคิดเห็นที่ระบุอย่างน้อย 1 ชุด ตรวจสอบค่าของพารามิเตอร์ id ของคําขอเพื่อให้แน่ใจว่าถูกต้อง
notFound (404)	videoNotFound	ไม่พบวิดีโอที่ระบุโดยพารามิเตอร์ videoId

commentThreads.insert

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	channelOrVideoIdMissing	แต่ละชุดความคิดเห็นต้องลิงก์กับช่องหรือวิดีโอ ตรวจสอบว่าทรัพยากรระบุค่าสำหรับทั้งพร็อพเพอร์ตี้ snippet.channelId และ snippet.videoId ความคิดเห็นในวิดีโอจะปรากฏในหน้าดูวิดีโอ
badRequest (400)	commentTextRequired	ทรัพยากร comment ที่แทรกต้องระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.topLevelComment.snippet.textOriginal ต้องระบุความคิดเห็น
badRequest (400)	commentTextTooLong	ทรัพยากร comment ที่กำลังแทรกมีอักขระในพร็อพเพอร์ตี้ snippet.topLevelComment.snippet.textOriginal มากเกินไป
badRequest (400)	invalidCommentThreadMetadata	ข้อมูลเมตาของคำขอไม่ถูกต้อง
badRequest (400)	processingFailure	เซิร์ฟเวอร์ API ประมวลผลคําขอไม่สําเร็จ แม้ว่านี่อาจเป็นข้อผิดพลาดชั่วคราว แต่มักบ่งบอกว่าอินพุตของคําขอไม่ถูกต้อง ตรวจสอบโครงสร้างของทรัพยากร commentThread ในเนื้อหาคำขอเพื่อให้แน่ใจว่าถูกต้อง
forbidden (403)	forbidden	ไม่สามารถสร้างชุดข้อความความคิดเห็นได้เนื่องจากมีสิทธิ์ไม่เพียงพอ คำขออาจไม่ได้รับอนุญาตอย่างเหมาะสม
forbidden (403)	ineligibleAccount	บัญชี YouTube ที่ใช้ให้สิทธิ์คําขอ API ต้องผสานรวมกับบัญชี Google ของผู้ใช้เพื่อแทรกความคิดเห็นหรือชุดความคิดเห็น
notFound (404)	channelNotFound	ไม่พบแชแนลที่ระบุ ตรวจสอบค่าของพร็อพเพอร์ตี้ snippet.channelId ว่าถูกต้อง
notFound (404)	videoNotFound	ไม่พบวิดีโอที่ระบุ ตรวจสอบค่าของพร็อพเพอร์ตี้ snippet.videoId ว่าถูกต้อง

ความคิดเห็น

ระบบไม่รองรับวิธีการ comments.markAsSpam อีกต่อไป

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

comments.list

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	operationNotSupported	คำขอ API ไม่ถูกต้องหรือมีรูปแบบไม่ถูกต้อง ทำให้เซิร์ฟเวอร์ API ไม่เข้าใจคำขอ
forbidden (403)	forbidden	ดึงข้อมูลความคิดเห็นที่ขออย่างน้อย 1 รายการไม่ได้เนื่องจากมีสิทธิ์ไม่เพียงพอ คำขออาจไม่ได้รับอนุญาตอย่างเหมาะสม
notFound (404)	commentNotFound	ไม่พบความคิดเห็นที่ระบุอย่างน้อย 1 รายการ ตรวจสอบค่าของพารามิเตอร์ id และ parentId ของคําขอเพื่อให้แน่ใจว่าถูกต้อง

comments.setModerationStatus

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	banWithoutReject	คุณจะใช้พารามิเตอร์ banAuthor ได้ก็ต่อเมื่อค่าพารามิเตอร์ moderationStatus เป็น rejected
badRequest (400)	operationNotSupported	คำขอ API ไม่ถูกต้องหรือมีรูปแบบไม่ถูกต้อง ทำให้เซิร์ฟเวอร์ API ไม่เข้าใจคำขอ
badRequest (400)	processingFailure	เซิร์ฟเวอร์ API ประมวลผลคําขอไม่สําเร็จ แม้ว่านี่อาจเป็นข้อผิดพลาดชั่วคราว แต่มักบ่งบอกว่าอินพุตของคําขอไม่ถูกต้อง
forbidden (403)	forbidden	ตั้งค่าสถานะการดูแลความคิดเห็นอย่างน้อย 1 รายการไม่ได้เนื่องจากมีสิทธิ์ไม่เพียงพอ คำขออาจไม่ได้รับอนุญาตอย่างเหมาะสม
notFound (404)	commentNotFound	ไม่พบความคิดเห็นอย่างน้อย 1 รายการที่คำขอพยายามอัปเดต ตรวจสอบค่าของพารามิเตอร์ id ของคําขอเพื่อให้แน่ใจว่าถูกต้อง

comments.insert

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	commentTextRequired	ทรัพยากร comment ที่แทรกต้องระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.textOriginal ต้องระบุความคิดเห็น
badRequest (400)	commentTextTooLong	ทรัพยากร comment ที่กำลังแทรกมีอักขระในพร็อพเพอร์ตี้ snippet.textOriginal มากเกินไป
badRequest (400)	invalidCommentMetadata	ข้อมูลเมตาของคำขอไม่ถูกต้อง
badRequest (400)	operationNotSupported	ผู้ใช้ API จะแทรกความคิดเห็นเพื่อตอบกลับความคิดเห็นระดับบนสุดที่ระบุโดยพร็อพเพอร์ตี้ snippet.parentId ไม่ได้ ในทรัพยากร commentThread พร็อพเพอร์ตี้ snippet.canReply จะระบุว่าผู้ชมปัจจุบันตอบชุดข้อความได้หรือไม่
badRequest (400)	parentCommentIsPrivate	ความคิดเห็นหลักที่ระบุเป็นความคิดเห็นส่วนตัว API ไม่รองรับการตอบกลับความคิดเห็นส่วนตัว
badRequest (400)	parentIdMissing	ความคิดเห็นที่แทรกต้องลิงก์กับความคิดเห็นหลัก อย่างไรก็ตาม แหล่งข้อมูล comment ในส่วนเนื้อหาของคำขอ API ไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.parentId
badRequest (400)	processingFailure	เซิร์ฟเวอร์ API ประมวลผลคําขอไม่สําเร็จ แม้ว่านี่อาจเป็นข้อผิดพลาดชั่วคราว แต่มักบ่งบอกว่าอินพุตของคําขอไม่ถูกต้อง ตรวจสอบโครงสร้างของทรัพยากร comment ในเนื้อหาคำขอเพื่อให้แน่ใจว่าถูกต้อง
forbidden (403)	forbidden	สร้างความคิดเห็นไม่ได้เนื่องจากมีสิทธิ์ไม่เพียงพอ คำขออาจไม่ได้รับอนุญาตอย่างเหมาะสม
forbidden (403)	ineligibleAccount	บัญชี YouTube ที่ใช้ให้สิทธิ์คําขอ API ต้องผสานรวมกับบัญชี Google ของผู้ใช้เพื่อแทรกความคิดเห็นหรือชุดความคิดเห็น
notFound (404)	parentCommentNotFound	ไม่พบความคิดเห็นหลักที่ระบุ ตรวจสอบค่าของพร็อพเพอร์ตี้ snippet.parentId ในเนื้อหาคำขอเพื่อให้แน่ใจว่าถูกต้อง

comments.delete

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	processingFailure	เซิร์ฟเวอร์ API ประมวลผลคําขอไม่สําเร็จ แม้ว่านี่อาจเป็นข้อผิดพลาดชั่วคราว แต่มักบ่งบอกว่าอินพุตของคําขอไม่ถูกต้อง
forbidden (403)	forbidden	ลบความคิดเห็นไม่ได้เนื่องจากมีสิทธิ์ไม่เพียงพอ คำขออาจไม่ได้รับอนุญาตอย่างเหมาะสม
notFound (404)	commentNotFound	ไม่พบความคิดเห็นที่ระบุ ตรวจสอบค่าของพารามิเตอร์ id ของคำขอเพื่อให้แน่ใจว่าถูกต้อง

comments.update

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	commentTextTooLong	ทรัพยากร comment ที่กำลังอัปเดตมีอักขระในพร็อพเพอร์ตี้ snippet.textOriginal มากเกินไป
badRequest (400)	invalidCommentMetadata	ข้อมูลเมตาของคำขอไม่ถูกต้อง
badRequest (400)	operationNotSupported	คำขอ API ไม่ถูกต้องหรือมีรูปแบบไม่ถูกต้อง ทำให้เซิร์ฟเวอร์ API ไม่เข้าใจคำขอ
badRequest (400)	processingFailure	เซิร์ฟเวอร์ API ประมวลผลคําขอไม่สําเร็จ แม้ว่านี่อาจเป็นข้อผิดพลาดชั่วคราว แต่มักบ่งบอกว่าอินพุตของคําขอไม่ถูกต้อง ตรวจสอบโครงสร้างของทรัพยากร comment ในเนื้อหาคำขอเพื่อให้แน่ใจว่าถูกต้อง
forbidden (403)	forbidden	อัปเดตความคิดเห็นไม่ได้เนื่องจากมีสิทธิ์ไม่เพียงพอ คำขออาจไม่ได้รับอนุญาตอย่างเหมาะสม
forbidden (403)	ineligibleAccount	บัญชี YouTube ที่ใช้ให้สิทธิ์คำขอ API ต้องผสานรวมกับบัญชี Google ของผู้ใช้เพื่ออัปเดตความคิดเห็นหรือชุดความคิดเห็น
notFound (404)	commentNotFound	ไม่พบความคิดเห็นที่ระบุ ตรวจสอบค่าของพร็อพเพอร์ตี้ id ในเนื้อหาคำขอเพื่อให้แน่ใจว่าถูกต้อง

สมาชิก

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

members.list

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	channelMembershipsNotEnabled	ช่องของครีเอเตอร์ที่อนุญาตให้ส่งคำขอไม่ได้เปิดใช้การเป็นสมาชิกของช่อง
badRequest (400)	invalidMode	ค่าพารามิเตอร์ mode ไม่ถูกต้อง ข้อผิดพลาดนี้อาจเกิดขึ้นหากพารามิเตอร์ pageToken ระบุโทเค็นที่ดึงข้อมูลโดยใช้โหมดอื่นนอกเหนือจากที่ระบุ
badRequest (400)	invalidPageToken	ค่าพารามิเตอร์ pageToken ไม่ถูกต้อง ข้อผิดพลาดนี้เกิดขึ้นหากโทเค็นหน้าเว็บที่ใช้ในคำขอหมดอายุ
badRequest (400)	invalidHasAccessToLevel	ค่าพารามิเตอร์ hasAccessToLevel ไม่ถูกต้อง ไม่มีระดับที่มีidที่ระบุ
badRequest (400)	invalidFilterByMemberChannelId	ค่าพารามิเตอร์ filterByMemberChannelId ไม่ถูกต้อง ข้อผิดพลาดนี้จะเกิดขึ้นหากค่าพารามิเตอร์ filterByMemberChannelId ระบุแชแนลมากกว่า 100 รายการ

membershipsLevels

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

membershipsLevels.list

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	channelMembershipsNotEnabled	ช่องของครีเอเตอร์ที่อนุญาตให้ส่งคำขอไม่ได้เปิดใช้การเป็นสมาชิกของช่อง

playlistItems

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

playlistItems.delete

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
forbidden (403)	playlistItemsNotAccessible	คำขอไม่ได้รับอนุญาตอย่างเหมาะสมให้ลบรายการเพลย์ลิสต์ที่ระบุ
notFound (404)	playlistItemNotFound	ไม่พบรายการเพลย์ลิสต์ที่ระบุด้วยพารามิเตอร์ id ของคำขอ
invalidValue (400)	playlistOperationUnsupported	API ไม่รองรับความสามารถในการลบวิดีโอออกจากเพลย์ลิสต์ที่ระบุ เช่น คุณจะลบวิดีโอออกจากเพลย์ลิสต์วิดีโอที่อัปโหลดไม่ได้

playlistItems.insert

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
duplicate	videoAlreadyInPlaylist	วิดีโอที่คุณพยายามเพิ่มลงในเพลย์ลิสต์อยู่ในเพลย์ลิสต์อยู่แล้ว
forbidden (403)	playlistContainsMaximumNumberOfVideos	เพลย์ลิสต์มีรายการครบจำนวนสูงสุดที่อนุญาตแล้ว
forbidden (403)	playlistItemsNotAccessible	คำขอไม่ได้รับสิทธิ์อย่างถูกต้องในการแทรกรายการเพลย์ลิสต์ที่ระบุ
invalidValue (400)	invalidContentDetails	พร็อพเพอร์ตี้ contentDetails ในคําขอไม่ถูกต้อง สาเหตุที่เป็นไปได้คือช่อง contentDetails.note มีความยาวมากกว่า 280 อักขระ
invalidValue (400)	invalidPlaylistItemPosition	คำขอพยายามตั้งค่าตำแหน่งของรายการเพลย์ลิสต์เป็นค่าที่ไม่ถูกต้องหรือไม่รองรับ ตรวจสอบค่าของพร็อพเพอร์ตี้ position ใน snippet ของทรัพยากร
invalidValue (400)	invalidResourceType	ระบบไม่รองรับ type ที่ระบุสำหรับรหัสทรัพยากรสําหรับการดำเนินการนี้ รหัสทรัพยากรจะระบุรายการที่เพิ่มลงในเพลย์ลิสต์ เช่น youtube#video
invalidValue (400)	manualSortRequired	คำขอพยายามตั้งค่าตำแหน่งของรายการในเพลย์ลิสต์ แต่เพลย์ลิสต์ไม่ได้ใช้การจัดเรียงด้วยตนเอง (เช่น รายการในเพลย์ลิสต์อาจจัดเรียงตามวันที่หรือความนิยม) คุณแก้ไขข้อผิดพลาดได้โดยนำองค์ประกอบ snippet.position ออกจากทรัพยากรที่คำขอกำลังแทรก หากต้องการให้รายการในเพลย์ลิสต์มีตำแหน่งที่เจาะจงในรายการ ก่อนอื่นคุณต้องอัปเดตตัวเลือกการจัดเรียงของเพลย์ลิสต์เป็นด้วยตนเองในการตั้งค่าของเพลย์ลิสต์ คุณปรับการตั้งค่านี้ได้ในเครื่องมือจัดการวิดีโอ YouTube
invalidValue (400)	videoAlreadyInAnotherSeriesPlaylist	วิดีโอที่คุณพยายามเพิ่มลงในเพลย์ลิสต์อยู่ในรายการซีรีส์อื่นแล้ว
invalidValue (400)	playlistOperationUnsupported	API ไม่รองรับความสามารถในการแทรกวิดีโอลงในเพลย์ลิสต์ที่ระบุ เช่น คุณจะแทรกวิดีโอลงในเพลย์ลิสต์วิดีโอที่อัปโหลดไม่ได้
notFound (404)	playlistNotFound	ไม่พบเพลย์ลิสต์ที่ระบุด้วยพารามิเตอร์ playlistId ของคำขอ
notFound (404)	videoNotFound	ไม่พบวิดีโอที่คุณพยายามเพิ่มลงในเพลย์ลิสต์ ตรวจสอบค่าของพร็อพเพอร์ตี้ videoId เพื่อให้แน่ใจว่าถูกต้อง
required (400)	channelIdRequired	คำขอไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้ channelId ที่จําเป็น
required (400)	playlistIdRequired	คำขอไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้ playlistId ที่ต้องระบุ
required (400)	resourceIdRequired	คำขอต้องมีทรัพยากรที่ออบเจ็กต์ snippet ระบุ resourceId

playlistItems.list

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
forbidden (403)	playlistItemsNotAccessible	คำขอไม่ได้รับสิทธิ์อย่างถูกต้องในการดึงข้อมูลเพลย์ลิสต์ที่ระบุ
notFound (404)	playlistNotFound	ไม่พบเพลย์ลิสต์ที่ระบุด้วยพารามิเตอร์ playlistId ของคำขอ
notFound (404)	videoNotFound	ไม่พบวิดีโอที่ระบุด้วยพารามิเตอร์ videoId ของคำขอ
required (400)	playlistIdRequired	คำขอสมัครใช้บริการไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้ playlistId ที่จำเป็น
invalidValue (400)	playlistOperationUnsupported	API ไม่รองรับการแสดงรายการวิดีโอในเพลย์ลิสต์ที่ระบุ เช่น คุณจะแสดงวิดีโอในเพลย์ลิสต์ดูภายหลังไม่ได้

playlistItems.update

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
forbidden (403)	playlistItemsNotAccessible	คำขอไม่ได้รับสิทธิ์อย่างถูกต้องในการอัปเดตรายการเพลย์ลิสต์ที่ระบุ
invalidValue (400)	invalidPlaylistItemPosition	คำขอพยายามตั้งค่าตำแหน่งของรายการเพลย์ลิสต์เป็นค่าที่ไม่ถูกต้องหรือไม่รองรับ ตรวจสอบค่าของพร็อพเพอร์ตี้ position ใน snippet ของทรัพยากร
invalidValue (400)	invalidResourceType	ระบบไม่รองรับ type ที่ระบุสำหรับรหัสทรัพยากรสําหรับการดำเนินการนี้ รหัสทรัพยากรจะระบุรายการที่เพิ่มลงในเพลย์ลิสต์ เช่น youtube#video
invalidValue (400)	invalidSnippet	คำขอไม่ได้ระบุพร็อพเพอร์ตี้ snippet ที่ถูกต้อง
invalidValue (400)	manualSortRequired	คำขอพยายามตั้งค่าตำแหน่งของรายการในเพลย์ลิสต์ แต่เพลย์ลิสต์ไม่ได้ใช้การจัดเรียงด้วยตนเอง (เช่น รายการในเพลย์ลิสต์อาจจัดเรียงตามวันที่หรือความนิยม) คุณแก้ไขข้อผิดพลาดได้โดยนำองค์ประกอบ snippet.position ออกจากทรัพยากรที่คำขอกำลังแทรก หากต้องการให้รายการในเพลย์ลิสต์มีตำแหน่งที่เจาะจงในรายการ ก่อนอื่นคุณต้องอัปเดตตัวเลือกการจัดเรียงของเพลย์ลิสต์เป็นด้วยตนเองในการตั้งค่าของเพลย์ลิสต์ คุณปรับการตั้งค่านี้ได้ในเครื่องมือจัดการวิดีโอ YouTube
invalidValue (400)	playlistOperationUnsupported	API ไม่รองรับความสามารถในการอัปเดตวิดีโอในเพลย์ลิสต์ที่ระบุ เช่น คุณจะอัปเดตวิดีโอในเพลย์ลิสต์วิดีโอที่อัปโหลดไม่ได้
notFound (404)	playlistItemNotFound	ไม่พบรายการเพลย์ลิสต์ที่ระบุด้วยพร็อพเพอร์ตี้ id ของคำขอ
notFound (404)	playlistNotFound	ไม่พบเพลย์ลิสต์ที่ระบุด้วยพารามิเตอร์ playlistId ของคำขอ
required (400)	channelIdRequired	คำขอไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้ channelId ที่ต้องระบุ
required (400)	playlistIdRequired	คำขอไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้ playlistId ที่จําเป็น
required (400)	playlistItemIdRequired	แหล่งข้อมูลรายการเพลย์ลิสต์ที่ระบุในคำขอต้องใช้พร็อพเพอร์ตี้ id เพื่อระบุรายการเพลย์ลิสต์ที่อัปเดต

เพลย์ลิสต์

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

playlists.delete

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
forbidden (403)	playlistForbidden	การดำเนินการนี้ถูกห้ามหรือคำขอไม่ได้รับอนุญาตอย่างเหมาะสม
notFound (404)	playlistNotFound	ไม่พบเพลย์ลิสต์ที่ระบุด้วยพารามิเตอร์ id ของคำขอ
invalidValue (400)	playlistOperationUnsupported	API ไม่รองรับความสามารถในการลบเพลย์ลิสต์ที่ระบุ เช่น คุณจะลบเพลย์ลิสต์วิดีโอที่อัปโหลดไม่ได้

playlists.list

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
forbidden (403)	channelClosed	ช่องที่ระบุไว้ในพารามิเตอร์ channelId ถูกปิดแล้ว
forbidden (403)	channelSuspended	ช่องที่ระบุไว้ในพารามิเตอร์ channelId ถูกระงับ
forbidden (403)	playlistForbidden	เพลย์ลิสต์ที่ระบุด้วยพารามิเตอร์ id ของคำขอไม่รองรับคำขอหรือคำขอไม่ได้รับอนุญาตอย่างถูกต้อง
notFound (404)	channelNotFound	ไม่พบช่องที่ระบุไว้ในพารามิเตอร์ channelId
notFound (404)	playlistNotFound	ไม่พบเพลย์ลิสต์ที่ระบุด้วยพารามิเตอร์ id ของคำขอ
invalidValue (400)	playlistOperationUnsupported	API ไม่รองรับการแสดงรายการเพลย์ลิสต์ที่ระบุ เช่น คุณจะแสดงเพลย์ลิสต์ดูภายหลังไม่ได้

playlists.insert

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	defaultLanguageNotSetError	คุณต้องตั้งค่า defaultLanguage เพื่ออัปเดต localizations
badRequest (400)	localizationValidationError	ค่าหนึ่งในออบเจ็กต์การแปลไม่ผ่านการตรวจสอบ ใช้เมธอด playlists.list เพื่อดึงค่าที่ถูกต้อง และอย่าลืมอัปเดตค่าตามหลักเกณฑ์ในเอกสารประกอบเกี่ยวกับทรัพยากรเพลย์ลิสต์
badRequest (400)	maxPlaylistExceeded	สร้างเพลย์ลิสต์ไม่ได้เนื่องจากช่องมีเพลย์ลิสต์ถึงจำนวนสูงสุดที่อนุญาตแล้ว
forbidden (403)	playlistForbidden	การดำเนินการนี้ถูกห้ามหรือคำขอไม่ได้รับอนุญาตอย่างเหมาะสม
invalidValue (400)	invalidPlaylistSnippet	คำขอระบุข้อมูลโค้ดเพลย์ลิสต์ที่ไม่ถูกต้อง
required (400)	playlistTitleRequired	โดยคำขอต้องระบุชื่อเพลย์ลิสต์

playlists.update

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	defaultLanguageNotSetError	คุณต้องตั้งค่า defaultLanguage เพื่ออัปเดต localizations
badRequest (400)	localizationValidationError	ค่าหนึ่งในออบเจ็กต์การแปลไม่ผ่านการตรวจสอบ ใช้เมธอด playlists.list เพื่อดึงค่าที่ถูกต้อง และอย่าลืมอัปเดตค่าตามหลักเกณฑ์ในเอกสารประกอบเกี่ยวกับทรัพยากรเพลย์ลิสต์
forbidden (403)	playlistForbidden	การดำเนินการนี้ถูกห้ามหรือคำขอไม่ได้รับอนุญาตอย่างเหมาะสม
invalidValue (400)	invalidPlaylistSnippet	คำขอระบุข้อมูลโค้ดเพลย์ลิสต์ที่ไม่ถูกต้อง
invalidValue (400)	playlistOperationUnsupported	API ไม่รองรับความสามารถในการอัปเดตเพลย์ลิสต์ที่ระบุ เช่น คุณจะอัปเดตพร็อพเพอร์ตี้ของเพลย์ลิสต์วิดีโอที่อัปโหลดไม่ได้
notFound (404)	playlistNotFound	ไม่พบเพลย์ลิสต์ที่ระบุด้วยพารามิเตอร์ id ของคำขอ
required (400)	playlistTitleRequired	โดยคำขอต้องระบุชื่อเพลย์ลิสต์

ค้นหา

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

search.list

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	invalidChannelId	พารามิเตอร์ channelId ระบุรหัสช่องไม่ถูกต้อง
badRequest (400)	invalidLocation	ค่าพารามิเตอร์ location และ/หรือ locationRadius มีการจัดรูปแบบไม่ถูกต้อง
badRequest (400)	invalidRelevanceLanguage	ค่าพารามิเตอร์ relevanceLanguage มีการจัดรูปแบบไม่ถูกต้อง
badRequest (400)	invalidSearchFilter	คำขอมีชุดค่าผสมของตัวกรองการค้นหาและ/หรือข้อจำกัดที่ไม่ถูกต้อง คุณต้องตั้งค่าพารามิเตอร์ type เป็น video หากคุณตั้งค่าพารามิเตอร์ eventType, videoCaption, videoCategoryId, videoDefinition, videoDimension, videoDuration, videoEmbeddable, videoLicense, videoSyndicated หรือ videoType

การสมัครสมาชิก

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

subscriptions.delete

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
forbidden (403)	subscriptionForbidden	คำขอไม่ได้รับการตรวจสอบสิทธิ์อย่างถูกต้องหรือไม่รองรับสำหรับช่องนี้
notFound (404)	subscriptionNotFound	ไม่พบการสมัครใช้บริการที่คุณพยายามลบ ตรวจสอบค่าของพารามิเตอร์ id ของคำขอเพื่อให้แน่ใจว่าถูกต้อง

subscriptions.insert

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	subscriptionDuplicate	การติดตามที่คุณพยายามสร้างมีอยู่แล้ว
badRequest (400)	subscriptionForbidden	คุณมีการสมัครใช้บริการถึงจำนวนสูงสุดแล้ว
badRequest (400)	subscriptionForbidden	มีการติดตามมากเกินกำหนดเมื่อเร็วๆ นี้ โปรดลองอีกครั้งในอีก 2-3 ชั่วโมง
badRequest (400)	subscriptionForbidden	ระบบไม่รองรับการติดตามช่องของคุณเอง
forbidden (403)	subscriptionForbidden	คำขอไม่ได้รับการตรวจสอบสิทธิ์อย่างถูกต้องหรือไม่รองรับสำหรับช่องนี้
notFound (404)	publisherNotFound	ไม่พบทรัพยากรที่ระบุโดยพร็อพเพอร์ตี้ snippet.resourceId ของคําขอ
notFound (404)	subscriberNotFound	ไม่พบผู้สมัครใช้บริการที่ระบุในคำขอ
required (400)	publisherRequired	ทรัพยากรการติดตามที่ระบุในคำขอต้องใช้พร็อพเพอร์ตี้ snippet.resourceId เพื่อระบุช่องที่กำลังติดตาม

subscriptions.list

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
forbidden (403)	accountClosed	ดึงข้อมูลการติดตามไม่ได้เนื่องจากบัญชีของผู้ติดตามถูกปิด
forbidden (403)	accountSuspended	ดึงข้อมูลการติดตามไม่ได้เนื่องจากบัญชีของผู้ติดตามถูกระงับ
forbidden (403)	subscriptionForbidden	ผู้ขอไม่ได้รับอนุญาตให้เข้าถึงการติดตามที่ขอ
notFound (404)	subscriberNotFound	ไม่พบผู้สมัครใช้บริการที่ระบุในคำขอ

ภาพขนาดย่อ

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

thumbnails.set

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	invalidImage	เนื้อหารูปภาพที่ระบุไม่ถูกต้อง
badRequest (400)	mediaBodyRequired	คำขอไม่มีเนื้อหารูปภาพ
forbidden (403)	forbidden	ตั้งค่าภาพปกสำหรับวิดีโอที่ระบุไม่ได้ คำขออาจไม่ได้รับอนุญาตอย่างเหมาะสม
forbidden (403)	forbidden	ผู้ใช้ที่ได้รับการตรวจสอบแล้วรายนี้ไม่มีสิทธิ์อัปโหลดและตั้งค่าภาพปกวิดีโอที่กำหนดเอง
notFound (404)	videoNotFound	ไม่พบวิดีโอที่คุณพยายามแทรกภาพปก ตรวจสอบค่าของพารามิเตอร์ videoId ของคำขอว่าถูกต้อง
tooManyRequests (429)	uploadRateLimitExceeded	ช่องอัปโหลดภาพปกมากเกินไปเมื่อเร็วๆ นี้ โปรดลองส่งคำขออีกครั้งในภายหลัง

videoAbuseReportReasons

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

videoAbuseReportReasons.list

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
forbidden (403)	forbidden	ห้ามเข้าถึง คำขออาจไม่ได้รับอนุญาตอย่างเหมาะสม

videoCategories

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

videoCategories.list

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
notFound (404)	videoCategoryNotFound	ไม่พบหมวดหมู่วิดีโอที่ระบุโดยพารามิเตอร์ id ใช้เมธอด videoCategories.list เพื่อเรียกข้อมูลรายการค่าที่ถูกต้อง

วิดีโอ

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

videos.insert

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	defaultLanguageNotSet	คำขอพยายามเพิ่มรายละเอียดวิดีโอที่แปลแล้วโดยไม่ระบุภาษาเริ่มต้นของรายละเอียดวิดีโอ
badRequest (400)	invalidCategoryId	พร็อพเพอร์ตี้ snippet.categoryId ระบุรหัสหมวดหมู่ที่ไม่ถูกต้อง ใช้เมธอด videoCategories.list เพื่อเรียกข้อมูลหมวดหมู่ที่รองรับ
badRequest (400)	invalidDescription	ข้อมูลเมตาคำขอระบุคำอธิบายวิดีโอที่ไม่ถูกต้อง
badRequest (400)	invalidFilename	ชื่อไฟล์วิดีโอที่ระบุในส่วนหัว Slug ไม่ถูกต้อง
badRequest (400)	invalidPublishAt	ข้อมูลเมตาของคำขอระบุเวลาเผยแพร่ตามกำหนดการที่ไม่ถูกต้อง
badRequest (400)	invalidRecordingDetails	ออบเจ็กต์ recordingDetails ในข้อมูลเมตาของคำขอระบุรายละเอียดการบันทึกที่ไม่ถูกต้อง
badRequest (400)	invalidTags	ข้อมูลเมตาคำขอระบุคีย์เวิร์ดวิดีโอที่ไม่ถูกต้อง
badRequest (400)	invalidTitle	ข้อมูลเมตาของคำขอระบุชื่อวิดีโอที่ไม่ถูกต้องหรือว่างเปล่า
badRequest (400)	invalidVideoGameRating	ข้อมูลเมตาของคำขอระบุการจัดประเภทวิดีโอเกมที่ไม่ถูกต้อง
badRequest (400)	invalidVideoMetadata	ข้อมูลเมตาของคำขอไม่ถูกต้อง ข้อผิดพลาดนี้เกิดขึ้นหากคําขออัปเดตส่วน snippet ของแหล่งข้อมูล video แต่ไม่ได้ตั้งค่าสําหรับทั้งพร็อพเพอร์ตี้ snippet.title และ snippet.categoryId
badRequest (400)	mediaBodyRequired	คำขอนี้ไม่มีเนื้อหาวิดีโอ
badRequest (400)	uploadLimitExceeded	ผู้ใช้อัปโหลดวิดีโอเกินจำนวนที่อนุญาตแล้ว
forbidden (403)	forbidden
forbidden (403)	forbiddenLicenseSetting	คำขอพยายามตั้งค่าใบอนุญาตที่ไม่ถูกต้องสำหรับวิดีโอ
forbidden (403)	forbiddenPrivacySetting	คำขอพยายามตั้งค่าความเป็นส่วนตัวที่ไม่ถูกต้องสำหรับวิดีโอ

videos.list

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	videoChartNotFound	ระบบไม่รองรับหรือไม่มีแผนภูมิวิดีโอที่ขอ
forbidden (403)	forbidden	คำขอไม่ได้รับสิทธิ์อย่างถูกต้องในการเข้าถึงไฟล์วิดีโอหรือข้อมูลการประมวลผล ส่วน fileDetails, processingDetails และ suggestions มีไว้สำหรับเจ้าของวิดีโอเท่านั้น
forbidden (403)	forbidden	คำขอเข้าถึงข้อมูลการให้คะแนนของผู้ใช้ไม่ได้ ข้อผิดพลาดนี้อาจเกิดขึ้นเนื่องจากคำขอไม่ได้รับสิทธิ์อย่างเหมาะสมในการใช้พารามิเตอร์ myRating
notFound (404)	videoNotFound	ไม่พบวิดีโอที่คุณพยายามเรียกข้อมูล ตรวจสอบค่าของพารามิเตอร์ id ของคำขอเพื่อให้แน่ใจว่าถูกต้อง

videos.delete

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
forbidden (403)	forbidden	ลบวิดีโอที่คุณพยายามลบไม่ได้ คำขออาจไม่ได้รับอนุญาตอย่างเหมาะสม
notFound (404)	videoNotFound	ไม่พบวิดีโอที่คุณพยายามลบ ตรวจสอบค่าของพารามิเตอร์ id ของคำขอว่าถูกต้อง

videos.update

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	defaultLanguageNotSet	คำขอ API พยายามเพิ่มรายละเอียดวิดีโอที่แปลแล้วโดยไม่ระบุภาษาเริ่มต้นของรายละเอียดวิดีโอ
badRequest (400)	invalidCategoryId	พร็อพเพอร์ตี้ snippet.categoryId ระบุรหัสหมวดหมู่ที่ไม่ถูกต้อง ใช้เมธอด videoCategories.list เพื่อเรียกข้อมูลหมวดหมู่ที่รองรับ
badRequest (400)	invalidDefaultBroadcastPrivacySetting	คำขอพยายามตั้งค่าความเป็นส่วนตัวที่ไม่ถูกต้องสำหรับการออกอากาศเริ่มต้น
badRequest (400)	invalidDescription	ข้อมูลเมตาคำขอระบุคำอธิบายวิดีโอที่ไม่ถูกต้อง
badRequest (400)	invalidPublishAt	ข้อมูลเมตาคำขอระบุเวลาเผยแพร่ตามกำหนดการที่ไม่ถูกต้อง
badRequest (400)	invalidRecordingDetails	ออบเจ็กต์ recordingDetails ในข้อมูลเมตาของคำขอระบุรายละเอียดการบันทึกที่ไม่ถูกต้อง
badRequest (400)	invalidTags	ข้อมูลเมตาคำขอระบุคีย์เวิร์ดวิดีโอที่ไม่ถูกต้อง
badRequest (400)	invalidTitle	ข้อมูลเมตาของคำขอระบุชื่อวิดีโอที่ไม่ถูกต้องหรือว่างเปล่า
badRequest (400)	invalidVideoMetadata	ข้อมูลเมตาของคำขอไม่ถูกต้อง ข้อผิดพลาดนี้เกิดขึ้นหากคําขออัปเดตส่วน snippet ของแหล่งข้อมูล video แต่ไม่ได้ตั้งค่าสําหรับทั้งพร็อพเพอร์ตี้ snippet.title และ snippet.categoryId
forbidden (403)	forbidden	ห้ามเข้าถึง คำขออาจไม่ได้รับอนุญาตอย่างเหมาะสม
forbidden (403)	forbiddenEmbedSetting	คำขอพยายามตั้งค่าการฝังที่ไม่ถูกต้องสำหรับวิดีโอ ช่องบางช่องอาจไม่มีสิทธิ์แสดงวิดีโอเพลเยอร์แบบฝังสำหรับสตรีมแบบสด ดูข้อมูลเพิ่มเติมได้ที่ศูนย์ช่วยเหลือของ YouTube
forbidden (403)	forbiddenLicenseSetting	คำขอพยายามตั้งค่าใบอนุญาตที่ไม่ถูกต้องสำหรับวิดีโอ
forbidden (403)	forbiddenPrivacySetting	คำขอพยายามตั้งค่าความเป็นส่วนตัวที่ไม่ถูกต้องสำหรับวิดีโอ
notFound (404)	videoNotFound	ไม่พบวิดีโอที่คุณพยายามอัปเดต ตรวจสอบค่าของช่อง id ในเนื้อหาคําขอเพื่อให้แน่ใจว่าถูกต้อง

videos.rate

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	emailNotVerified	ผู้ใช้ต้องยืนยันอีเมลก่อนให้คะแนน
badRequest (400)	invalidRating	คำขอมีค่าที่ไม่คาดคิดสำหรับพารามิเตอร์ rating
badRequest (400)	videoPurchaseRequired	เฉพาะผู้ใช้ที่เช่าวิดีโอเท่านั้นที่จะให้คะแนนวิดีโอเช่าได้
forbidden (403)	forbidden	วิดีโอที่คุณพยายามจัดประเภทจัดประเภทไม่ได้ คำขออาจไม่ได้รับอนุญาตอย่างเหมาะสม
forbidden (403)	videoRatingDisabled	เจ้าของวิดีโอที่คุณพยายามจัดประเภทได้ปิดใช้การจัดประเภทสำหรับวิดีโอนั้น
notFound (404)	videoNotFound	ไม่พบวิดีโอที่คุณพยายามให้คะแนน ตรวจสอบค่าของพารามิเตอร์ id ของคำขอเพื่อให้แน่ใจว่าถูกต้อง

videos.reportAbuse

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	invalidAbuseReason	คำขอมีค่าที่ไม่คาดคิดสำหรับฟิลด์ reason_id หรือมีฟิลด์ reason_id และ secondary_reason_id รวมกัน
badRequest (400)	rateLimitExceeded	ผู้ใช้ส่งคำขอมากเกินไปในกรอบเวลาที่กำหนด
forbidden (403)	forbidden
notFound (404)	videoNotFound	ไม่พบวิดีโอที่คุณพยายามรายงานการละเมิด

ลายน้ำ

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

watermarks.set

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
badRequest (400)	imageFormatUnsupported	รูปภาพที่คุณให้ไว้อยู่ในรูปแบบที่ระบบไม่รองรับ
badRequest (400)	imageTooTall	รูปภาพที่คุณให้ไว้สูงเกินไป
badRequest (400)	imageTooWide	รูปภาพที่คุณให้กว้างเกินไป
badRequest (400)	mediaBodyRequired	คำขอไม่มีเนื้อหารูปภาพ
forbidden (403)	forbidden	ตั้งค่าลายน้ำสำหรับช่องที่ระบุไม่ได้ คำขออาจไม่ได้รับสิทธิ์อย่างถูกต้อง หรือมีการตั้งค่าพารามิเตอร์ channelId เป็นค่าที่ไม่ถูกต้อง

watermarks.unset

ประเภทข้อผิดพลาด	รายละเอียดข้อผิดพลาด	คำอธิบาย
forbidden (403)	forbidden	ยกเลิกการตั้งค่าลายน้ำสำหรับช่องที่ระบุไม่ได้ คำขออาจไม่ได้รับสิทธิ์อย่างถูกต้อง หรือมีการตั้งค่าพารามิเตอร์ channelId เป็นค่าที่ไม่ถูกต้อง