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 แต่ไม่ได้รับอนุญาตอย่างถูกต้อง

captions

ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ 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 แชแนลที่ระบุอย่างน้อยหนึ่งแชแนลไม่ทำงาน
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 ไม่พบแชแนลที่ระบุอย่างน้อยหนึ่งแชแนล
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 แชแนลที่ระบุอย่างน้อยหนึ่งแชแนลไม่ทำงาน
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 ไม่พบแชแนลที่ระบุอย่างน้อยหนึ่งแชแนล
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 ไม่พบรหัสช่องอัปเดตล่าสุดที่ระบุ
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

ระบบไม่รองรับเมธอด 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 ส่งคืนเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร 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 ไม่พบวิดีโอที่คุณพยายามรายงานการละเมิด

watermarks

ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ 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 ถูกตั้งเป็นค่าที่ไม่ถูกต้อง