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 อื่น ข้อผิดพลาดนี้จะหมายถึงบัญชี Google อื่นดังกล่าว
forbidden (403) authenticatedUserAccountSuspended บัญชี YouTube ของผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ถูกระงับ ในกรณีที่ผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ดำเนินการในนามของบัญชี Google อื่น ข้อผิดพลาดนี้จะหมายถึงบัญชี 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 แต่ความหมายของข้อผิดพลาดก็ยังคงเกี่ยวข้อง

กิจกรรม

ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ 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[] ต้องระบุเพลย์ลิสต์ 1 รายการเท่านั้น
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[] ต้องระบุเพลย์ลิสต์ 1 รายการเท่านั้น
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
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 เพื่อให้แน่ใจว่าถูกต้อง

ความคิดเห็น

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