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 ไม่รองรับบัญชีบริการ และหากคุณพยายามตรวจสอบสิทธิ์โดยใช้บัญชีบริการ คุณจะได้รับข้อผิดพลาดนี้

บล็อกโพสต์เกี่ยวกับ API ของ YouTube ที่แนะนำการรองรับบัญชี 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 เพื่อดึงค่าที่ถูกต้องและอัปเดตค่าเหล่านั้นตามหลักเกณฑ์ในเอกสารประกอบเกี่ยวกับทรัพยากร channelSections
badRequest (400) notEditable สร้างส่วนของช่องนี้ไม่ได้
badRequest (400) styleRequired ทรัพยากร channelSection ต้องระบุค่าสำหรับช่อง snippet.style
badRequest (400) targetInvalidCountry ค่าใดค่าหนึ่งในรายการ targeting.countries ไม่ผ่านการตรวจสอบความถูกต้อง ใช้เมธอด channelSections.list เพื่อดึงค่าที่ถูกต้องและอัปเดตค่าเหล่านั้นตามหลักเกณฑ์ในเอกสารประกอบเกี่ยวกับทรัพยากร channelSections
badRequest (400) targetInvalidLanguage ค่าใดค่าหนึ่งในรายการ targeting.languages ไม่ผ่านการตรวจสอบ ใช้เมธอด channelSections.list เพื่อดึงค่าที่ถูกต้องและอัปเดตค่าเหล่านั้นตามหลักเกณฑ์ในเอกสารประกอบเกี่ยวกับทรัพยากร channelSections
badRequest (400) targetInvalidRegion ค่าใดค่าหนึ่งในรายการ targeting.regions ไม่ผ่านการตรวจสอบความถูกต้อง ใช้เมธอด channelSections.list เพื่อดึงค่าที่ถูกต้องและอัปเดตค่าเหล่านั้นตามหลักเกณฑ์ในเอกสารประกอบของทรัพยากร 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 เพื่อดึงค่าที่ถูกต้องและอัปเดตค่าเหล่านั้นตามหลักเกณฑ์ในเอกสารประกอบของทรัพยากร channelSections
badRequest (400) notEditable แก้ไขส่วนของช่องนี้ไม่ได้
badRequest (400) styleRequired ทรัพยากร channelSection ต้องระบุค่าสำหรับช่อง snippet.style
badRequest (400) targetInvalidCountry ค่าใดค่าหนึ่งในรายการ targeting.countries ไม่ผ่านการตรวจสอบ ใช้เมธอด channelSections.list เพื่อดึงค่าที่ถูกต้องและอัปเดตค่าเหล่านั้นตามหลักเกณฑ์ในเอกสารประกอบของทรัพยากร channelSections
badRequest (400) targetInvalidLanguage ค่าใดค่าหนึ่งในรายการ targeting.languages ไม่ผ่านการตรวจสอบความถูกต้อง ใช้เมธอด channelSections.list เพื่อดึงค่าที่ถูกต้องและอัปเดตค่าเหล่านั้นตามหลักเกณฑ์ในเอกสารประกอบเกี่ยวกับทรัพยากร channelSections
badRequest (400) targetInvalidRegion ค่าใดค่าหนึ่งในรายการ targeting.regions ไม่ผ่านการตรวจสอบ ใช้เมธอด channelSections.list เพื่อดึงค่าที่ถูกต้องและอัปเดตค่าเหล่านั้นตามหลักเกณฑ์ในเอกสารประกอบของทรัพยากร 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 ช่องอัปโหลดวิดีโอถึงขีดจำกัดต่อวันแล้ว นี่คือข้อจำกัดของแพลตฟอร์ม YouTube และแยกจากโควต้า API ของโปรเจ็กต์ที่อยู่ในระบบคลาวด์ Google โดยสิ้นเชิง
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 เป็นค่าที่ไม่ถูกต้อง