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 แสดงเมื่อมีการเรียกใช้ทรัพยากร 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 เป็นค่าที่ไม่ถูกต้อง