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 ในทรัพยากรที่คำขอส่ง |
สมาชิก
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API แสดงเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร members
นอกจากนี้ เมธอดเหล่านี้ยังอาจแสดงข้อผิดพลาดที่ระบุไว้ในส่วนข้อผิดพลาดที่พบบ่อยในคำขอด้วย
members.list
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
badRequest (400) |
channelMembershipsNotEnabled |
ช่องของครีเอเตอร์ที่ให้สิทธิ์คำขอไม่ได้เปิดใช้การเป็นสมาชิกของช่อง
ไว้ |
badRequest (400) |
invalidMode |
ค่าพารามิเตอร์ mode ไม่ถูกต้อง
ข้อผิดพลาดนี้อาจเกิดขึ้นหากพารามิเตอร์ pageToken
ระบุโทเค็นที่ดึงข้อมูลโดยใช้โหมดอื่นที่ไม่ใช่โหมดที่ระบุ |
badRequest (400) |
invalidPageToken |
ค่าพารามิเตอร์ pageToken ไม่ถูกต้อง ข้อผิดพลาดนี้เกิดขึ้นหากโทเค็นหน้าเว็บที่ใช้ในคำขอหมดอายุแล้ว |
badRequest (400) |
invalidHasAccessToLevel |
ค่าพารามิเตอร์ hasAccessToLevel
ไม่ถูกต้อง ไม่มีระดับที่มี
id ที่ระบุ |
badRequest (400) |
invalidFilterByMemberChannelId |
ค่าพารามิเตอร์ filterByMemberChannelId
ไม่ถูกต้อง ข้อผิดพลาดนี้จะเกิดขึ้นหาก
filterByMemberChannelId ค่าพารามิเตอร์
ระบุแชแนลมากกว่า 100 รายการ |
membershipsLevels
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API แสดงเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร members
นอกจากนี้ เมธอดเหล่านี้ยังอาจแสดงข้อผิดพลาดที่ระบุไว้ในส่วนข้อผิดพลาดที่พบบ่อยในคำขอด้วย
membershipsLevels.list
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
badRequest (400) |
channelMembershipsNotEnabled |
ช่องของครีเอเตอร์ที่ให้สิทธิ์คำขอไม่ได้เปิดใช้การเป็นสมาชิกของช่อง
ไว้ |
playlistItems
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API แสดงเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร playlistItems
นอกจากนี้ เมธอดเหล่านี้ยังอาจแสดงข้อผิดพลาดที่ระบุไว้ในส่วนข้อผิดพลาดที่พบบ่อยในคำขอด้วย
playlistItems.delete
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
forbidden (403) |
playlistItemsNotAccessible |
คำขอไม่ได้รับอนุญาตอย่างถูกต้องในการลบรายการเพลย์ลิสต์ที่ระบุ |
notFound (404) |
playlistItemNotFound |
ไม่พบรายการในเพลย์ลิสต์ที่ระบุด้วยพารามิเตอร์ id ของคำขอ |
invalidValue (400) |
playlistOperationUnsupported |
API ไม่รองรับความสามารถในการลบวิดีโอจากเพลย์ลิสต์ที่ระบุ เช่น คุณจะลบวิดีโอออกจากเพลย์ลิสต์วิดีโอที่อัปโหลดไม่ได้ |
playlistItems.insert
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
duplicate |
videoAlreadyInPlaylist |
วิดีโอที่คุณพยายามเพิ่มลงในเพลย์ลิสต์อยู่ในเพลย์ลิสต์อยู่แล้ว |
forbidden (403) |
playlistContainsMaximumNumberOfVideos |
เพลย์ลิสต์มีจำนวนรายการถึงขีดจำกัดสูงสุดที่อนุญาตแล้ว |
forbidden (403) |
playlistItemsNotAccessible |
คำขอไม่ได้รับอนุญาตอย่างถูกต้องเพื่อแทรกรายการในเพลย์ลิสต์ที่ระบุ |
invalidValue (400) |
invalidContentDetails |
พร็อพเพอร์ตี้ contentDetails ในคำขอไม่ถูกต้อง สาเหตุที่เป็นไปได้คือฟิลด์ contentDetails.note ยาวกว่า 280 อักขระ |
invalidValue (400) |
invalidPlaylistItemPosition |
คำขอพยายามตั้งค่าตำแหน่งของรายการในเพลย์ลิสต์เป็นค่าที่ไม่ถูกต้องหรือไม่รองรับ ตรวจสอบค่าของพร็อพเพอร์ตี้ position ใน snippet ของทรัพยากร |
invalidValue (400) |
invalidResourceType |
การดำเนินการนี้ไม่รองรับ type ที่ระบุสำหรับรหัสทรัพยากร รหัสทรัพยากรจะระบุรายการที่เพิ่มลงในเพลย์ลิสต์ เช่น youtube#video |
invalidValue (400) |
manualSortRequired |
คำขอพยายามตั้งค่าตำแหน่งของรายการในเพลย์ลิสต์ แต่เพลย์ลิสต์ไม่ได้ใช้การจัดเรียงด้วยตนเอง (เช่น ระบบอาจจัดเรียงรายการในเพลย์ลิสต์ตามวันที่หรือความนิยม) คุณแก้ไขข้อผิดพลาดได้โดยนำองค์ประกอบ snippet.position ออกจากทรัพยากรที่คำขอจะแทรก หากต้องการให้รายการในเพลย์ลิสต์อยู่ในตำแหน่งใดตำแหน่งหนึ่งในรายการ คุณต้องอัปเดตตัวเลือกการจัดเรียงของเพลย์ลิสต์เป็นด้วยตนเองในการตั้งค่าของเพลย์ลิสต์ก่อน คุณปรับการตั้งค่านี้ได้ในเครื่องมือจัดการวิดีโอของ YouTube |
invalidValue (400) |
videoAlreadyInAnotherSeriesPlaylist |
วิดีโอที่คุณพยายามเพิ่มลงในเพลย์ลิสต์อยู่ในรายการซีรีส์อื่นแล้ว |
invalidValue (400) |
playlistOperationUnsupported |
API ไม่รองรับความสามารถในการแทรกวิดีโอลงในเพลย์ลิสต์ที่ระบุ เช่น คุณจะแทรกวิดีโอลงในเพลย์ลิสต์วิดีโอที่อัปโหลดไม่ได้ |
notFound (404) |
playlistNotFound |
ไม่พบเพลย์ลิสต์ที่ระบุด้วยพารามิเตอร์ playlistId ของคำขอ |
notFound (404) |
videoNotFound |
ไม่พบวิดีโอที่คุณพยายามเพิ่มลงในเพลย์ลิสต์ ตรวจสอบค่าของพร็อพเพอร์ตี้ videoId เพื่อให้แน่ใจว่าถูกต้อง |
required (400) |
channelIdRequired |
คำขอไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้ channelId ที่จำเป็น |
required (400) |
playlistIdRequired |
คำขอไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้ playlistId ที่จำเป็น |
required (400) |
resourceIdRequired |
คำขอต้องมีทรัพยากรซึ่งออบเจ็กต์ snippet ระบุ resourceId |
playlistItems.list
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
forbidden (403) |
playlistItemsNotAccessible |
คำขอไม่ได้รับอนุญาตอย่างถูกต้องเพื่อดึงข้อมูลเพลย์ลิสต์ที่ระบุ |
notFound (404) |
playlistNotFound |
ไม่พบเพลย์ลิสต์ที่ระบุด้วยพารามิเตอร์ playlistId ของคำขอ |
notFound (404) |
videoNotFound |
ไม่พบวิดีโอที่ระบุด้วยพารามิเตอร์ videoId ของคำขอ |
required (400) |
playlistIdRequired |
คำขอสมัครใช้บริการไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้ playlistId ที่จำเป็น |
invalidValue (400) |
playlistOperationUnsupported |
API ไม่รองรับความสามารถในการแสดงวิดีโอในเพลย์ลิสต์ที่ระบุ เช่น คุณจะแสดงวิดีโอในเพลย์ลิสต์ดูภายหลังไม่ได้ |
playlistItems.update
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
forbidden (403) |
playlistItemsNotAccessible |
คำขอไม่ได้รับอนุญาตอย่างถูกต้องเพื่ออัปเดตรายการเพลย์ลิสต์ที่ระบุ |
invalidValue (400) |
invalidPlaylistItemPosition |
คำขอพยายามตั้งค่าตำแหน่งของรายการในเพลย์ลิสต์เป็นค่าที่ไม่ถูกต้องหรือไม่รองรับ ตรวจสอบค่าของพร็อพเพอร์ตี้ position ใน snippet ของทรัพยากร |
invalidValue (400) |
invalidResourceType |
การดำเนินการนี้ไม่รองรับ type ที่ระบุสำหรับรหัสทรัพยากร รหัสทรัพยากรจะระบุรายการที่เพิ่มลงในเพลย์ลิสต์ เช่น youtube#video |
invalidValue (400) |
invalidSnippet |
คำขอไม่ได้ระบุพร็อพเพอร์ตี้ snippet ที่ถูกต้อง |
invalidValue (400) |
manualSortRequired |
คำขอพยายามตั้งค่าตำแหน่งของรายการในเพลย์ลิสต์ แต่เพลย์ลิสต์ไม่ได้ใช้การจัดเรียงด้วยตนเอง (เช่น ระบบอาจจัดเรียงรายการในเพลย์ลิสต์ตามวันที่หรือความนิยม) คุณแก้ไขข้อผิดพลาดได้โดยนำองค์ประกอบ snippet.position ออกจากทรัพยากรที่คำขอจะแทรก หากต้องการให้รายการในเพลย์ลิสต์อยู่ในตำแหน่งใดตำแหน่งหนึ่งในรายการ คุณต้องอัปเดตตัวเลือกการจัดเรียงของเพลย์ลิสต์เป็นด้วยตนเองในการตั้งค่าของเพลย์ลิสต์ก่อน คุณปรับการตั้งค่านี้ได้ในเครื่องมือจัดการวิดีโอของ YouTube |
invalidValue (400) |
playlistOperationUnsupported |
API ไม่รองรับความสามารถในการอัปเดตวิดีโอในเพลย์ลิสต์ที่ระบุ เช่น คุณจะอัปเดตวิดีโอในเพลย์ลิสต์วิดีโอที่อัปโหลดไม่ได้ |
notFound (404) |
playlistItemNotFound |
ไม่พบรายการในเพลย์ลิสต์ที่ระบุด้วยพร็อพเพอร์ตี้ id ของคำขอ |
notFound (404) |
playlistNotFound |
ไม่พบเพลย์ลิสต์ที่ระบุด้วยพารามิเตอร์ playlistId ของคำขอ |
required (400) |
channelIdRequired |
คำขอไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้ channelId ที่จำเป็น |
required (400) |
playlistIdRequired |
คำขอไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้ playlistId ที่จำเป็น |
required (400) |
playlistItemIdRequired |
ทรัพยากรรายการในเพลย์ลิสต์ที่ระบุในคำขอต้องใช้พร็อพเพอร์ตี้ id เพื่อระบุรายการในเพลย์ลิสต์ที่จะอัปเดต |
เพลย์ลิสต์
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API แสดงเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร playlists
นอกจากนี้ เมธอดเหล่านี้ยังอาจแสดงข้อผิดพลาดที่ระบุไว้ในส่วนข้อผิดพลาดที่พบบ่อยในคำขอด้วย
playlists.delete
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
forbidden (403) |
playlistForbidden |
การดำเนินการนี้ถูกห้ามหรือคำขอไม่ได้รับอนุญาตอย่างถูกต้อง |
notFound (404) |
playlistNotFound |
ไม่พบเพลย์ลิสต์ที่ระบุด้วยพารามิเตอร์ id ของคำขอ |
invalidValue (400) |
playlistOperationUnsupported |
API ไม่รองรับความสามารถในการลบเพลย์ลิสต์ที่ระบุ เช่น คุณจะลบเพลย์ลิสต์วิดีโอที่คุณอัปโหลดไม่ได้ |
playlists.list
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
forbidden (403) |
channelClosed |
ช่องที่ระบุในพารามิเตอร์ channelId ถูกปิดแล้ว |
forbidden (403) |
channelSuspended |
ช่องที่ระบุในพารามิเตอร์ channelId ถูกระงับแล้ว |
forbidden (403) |
playlistForbidden |
เพลย์ลิสต์ที่ระบุด้วยพารามิเตอร์ id ของคำขอไม่รองรับคำขอ หรือคำขอไม่ได้รับอนุญาตอย่างถูกต้อง |
notFound (404) |
channelNotFound |
ไม่พบช่องที่ระบุไว้ในพารามิเตอร์ channelId |
notFound (404) |
playlistNotFound |
ไม่พบเพลย์ลิสต์ที่ระบุด้วยพารามิเตอร์ id ของคำขอ |
invalidValue (400) |
playlistOperationUnsupported |
API ไม่รองรับความสามารถในการแสดงเพลย์ลิสต์ที่ระบุ เช่น คุณจะแสดงเพลย์ลิสต์ดูภายหลังไม่ได้ |
playlists.insert
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
badRequest (400) |
defaultLanguageNotSetError |
ต้องตั้งค่า defaultLanguage ให้อัปเดต localizations |
badRequest (400) |
localizationValidationError |
ค่าใดค่าหนึ่งในออบเจ็กต์การแปลไม่ผ่านการตรวจสอบ ใช้เมธอด playlists.list เพื่อดึงค่าที่ถูกต้องและตรวจสอบว่าได้อัปเดตค่าเหล่านั้นตามหลักเกณฑ์ในเอกสารประกอบเกี่ยวกับทรัพยากรเพลย์ลิสต์ |
badRequest (400) |
maxPlaylistExceeded |
สร้างเพลย์ลิสต์ไม่ได้เนื่องจากช่องมีเพลย์ลิสต์ถึงจำนวนสูงสุดที่อนุญาตแล้ว |
forbidden (403) |
playlistForbidden |
การดำเนินการนี้ถูกห้ามหรือคำขอไม่ได้รับอนุญาตอย่างถูกต้อง |
invalidValue (400) |
invalidPlaylistSnippet |
คำขอมีข้อมูลโค้ดเพลย์ลิสต์ที่ไม่ถูกต้อง |
required (400) |
playlistTitleRequired |
คำขอต้องระบุชื่อเพลย์ลิสต์ |
playlists.update
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
badRequest (400) |
defaultLanguageNotSetError |
ต้องตั้งค่า defaultLanguage ให้อัปเดต localizations |
badRequest (400) |
localizationValidationError |
ค่าใดค่าหนึ่งในออบเจ็กต์การแปลไม่ผ่านการตรวจสอบ ใช้เมธอด playlists.list เพื่อดึงค่าที่ถูกต้องและตรวจสอบว่าได้อัปเดตค่าเหล่านั้นตามหลักเกณฑ์ในเอกสารประกอบเกี่ยวกับทรัพยากรเพลย์ลิสต์ |
forbidden (403) |
playlistForbidden |
การดำเนินการนี้ถูกห้ามหรือคำขอไม่ได้รับอนุญาตอย่างถูกต้อง |
invalidValue (400) |
invalidPlaylistSnippet |
คำขอมีข้อมูลโค้ดเพลย์ลิสต์ที่ไม่ถูกต้อง |
invalidValue (400) |
playlistOperationUnsupported |
API ไม่รองรับความสามารถในการอัปเดตเพลย์ลิสต์ที่ระบุ เช่น คุณจะอัปเดตพร็อพเพอร์ตี้ของเพลย์ลิสต์วิดีโอที่อัปโหลดไม่ได้ |
notFound (404) |
playlistNotFound |
ไม่พบเพลย์ลิสต์ที่ระบุด้วยพารามิเตอร์ id ของคำขอ |
required (400) |
playlistTitleRequired |
คำขอต้องระบุชื่อเพลย์ลิสต์ |
ค้นหา
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API แสดงเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร search
นอกจากนี้ เมธอดเหล่านี้ยังอาจแสดงข้อผิดพลาดที่ระบุไว้ในส่วนข้อผิดพลาดที่พบบ่อยในคำขอด้วย
search.list
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
badRequest (400) |
invalidChannelId |
พารามิเตอร์ channelId ระบุรหัสช่องที่ไม่ถูกต้อง |
badRequest (400) |
invalidLocation |
ค่าพารามิเตอร์ location และ/หรือ locationRadius มีรูปแบบไม่ถูกต้อง |
badRequest (400) |
invalidRelevanceLanguage |
ค่าพารามิเตอร์ relevanceLanguage มีรูปแบบไม่ถูกต้อง |
badRequest (400) |
invalidSearchFilter |
คำขอมีชุดค่าผสมของตัวกรองการค้นหาและ/หรือข้อจำกัดที่ไม่ถูกต้อง คุณต้องตั้งค่าพารามิเตอร์ type เป็น video หากตั้งค่าสำหรับพารามิเตอร์ eventType , videoCaption , videoCategoryId , videoDefinition , videoDimension , videoDuration , videoEmbeddable , videoLicense , videoSyndicated หรือ videoType |
การสมัครสมาชิก
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API แสดงเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร subscriptions
นอกจากนี้ เมธอดเหล่านี้ยังอาจแสดงข้อผิดพลาดที่ระบุไว้ในส่วนข้อผิดพลาดที่พบบ่อยในคำขอด้วย
subscriptions.delete
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
forbidden (403) |
subscriptionForbidden |
คำขอไม่ได้รับการตรวจสอบสิทธิ์อย่างถูกต้องหรือไม่รองรับสำหรับช่องนี้ |
notFound (404) |
subscriptionNotFound |
ไม่พบการสมัครรับข้อมูลที่คุณพยายามลบ ตรวจสอบค่าของพารามิเตอร์ id ของคำขอเพื่อให้แน่ใจว่าถูกต้อง |
subscriptions.insert
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
badRequest (400) |
subscriptionDuplicate |
มีการสมัครใช้บริการที่คุณพยายามสร้างอยู่แล้ว |
badRequest (400) |
subscriptionForbidden |
คุณมีการสมัครใช้บริการครบตามจำนวนสูงสุดแล้ว |
badRequest (400) |
subscriptionForbidden |
มีการติดตามมากเกินกำหนดเมื่อเร็วๆ นี้ โปรดลองอีกครั้งในอีก 2-3 ชั่วโมง |
badRequest (400) |
subscriptionForbidden |
ระบบไม่รองรับการติดตามช่องของคุณเอง |
forbidden (403) |
subscriptionForbidden |
คำขอไม่ได้รับการตรวจสอบสิทธิ์อย่างถูกต้องหรือไม่รองรับสำหรับช่องนี้ |
notFound (404) |
publisherNotFound |
ไม่พบทรัพยากรที่ระบุโดยพร็อพเพอร์ตี้ snippet.resourceId ของคำขอ |
notFound (404) |
subscriberNotFound |
ไม่พบผู้ติดตามที่ระบุในคำขอ |
required (400) |
publisherRequired |
ทรัพยากรการติดตามที่ระบุในคำขอต้องใช้พร็อพเพอร์ตี้ snippet.resourceId เพื่อระบุช่องที่กำลังติดตาม |
subscriptions.list
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
forbidden (403) |
accountClosed |
ดึงข้อมูลการติดตามไม่ได้เนื่องจากบัญชีของผู้ติดตามถูกปิด |
forbidden (403) |
accountSuspended |
ดึงข้อมูลการติดตามไม่ได้เนื่องจากบัญชีของผู้ติดตามถูกระงับ |
forbidden (403) |
subscriptionForbidden |
ผู้ขอไม่ได้รับอนุญาตให้เข้าถึงการติดตามที่ขอ |
notFound (404) |
subscriberNotFound |
ไม่พบผู้ติดตามที่ระบุในคำขอ |
ภาพขนาดย่อ
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API แสดงเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร thumbnails
นอกจากนี้ เมธอดเหล่านี้ยังอาจแสดงข้อผิดพลาดที่ระบุไว้ในส่วนข้อผิดพลาดที่พบบ่อยในคำขอด้วย
thumbnails.set
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
badRequest (400) |
invalidImage |
เนื้อหารูปภาพที่ระบุไม่ถูกต้อง |
badRequest (400) |
mediaBodyRequired |
คำขอไม่มีเนื้อหารูปภาพ |
forbidden (403) |
forbidden |
ตั้งค่าภาพปกสำหรับวิดีโอที่ระบุไม่ได้ คำขออาจไม่ได้รับอนุญาตอย่างถูกต้อง |
forbidden (403) |
forbidden |
ผู้ใช้ที่ได้รับการตรวจสอบแล้วไม่มีสิทธิ์อัปโหลดและตั้งค่าภาพปกวิดีโอที่กำหนดเอง |
notFound (404) |
videoNotFound |
ไม่พบวิดีโอที่คุณพยายามแทรกรูปภาพปก ตรวจสอบค่าของพารามิเตอร์ videoId ของคำขอเพื่อให้แน่ใจว่าถูกต้อง |
tooManyRequests (429) |
uploadRateLimitExceeded |
ช่องอัปโหลดภาพปกมากเกินไปเมื่อเร็วๆ นี้ โปรดลองส่งคำขออีกครั้งในภายหลัง |
videoAbuseReportReasons
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API แสดงเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร videoAbuseReportReasons
นอกจากนี้ เมธอดเหล่านี้ยังอาจแสดงข้อผิดพลาดที่ระบุไว้ในส่วนข้อผิดพลาดที่พบบ่อยในคำขอด้วย
videoAbuseReportReasons.list
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
forbidden (403) |
forbidden |
ห้ามเข้าถึง คำขออาจไม่ได้รับอนุญาตอย่างถูกต้อง |
videoCategories
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API แสดงเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร videoCategories
นอกจากนี้ เมธอดเหล่านี้ยังอาจแสดงข้อผิดพลาดที่ระบุไว้ในส่วนข้อผิดพลาดที่พบบ่อยในคำขอด้วย
videoCategories.list
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
notFound (404) |
videoCategoryNotFound |
ไม่พบหมวดหมู่วิดีโอที่ระบุโดยพารามิเตอร์ id ใช้วิธี videoCategories.list เพื่อดึงข้อมูลรายการค่าที่ถูกต้อง |
วิดีโอ
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API แสดงเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร videos
นอกจากนี้ เมธอดเหล่านี้ยังอาจแสดงข้อผิดพลาดที่ระบุไว้ในส่วนข้อผิดพลาดที่พบบ่อยในคำขอด้วย
videos.insert
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
badRequest (400) |
defaultLanguageNotSet |
คำขอพยายามเพิ่มรายละเอียดวิดีโอที่แปลแล้วโดยไม่ได้ระบุภาษาเริ่มต้นของรายละเอียดวิดีโอ |
badRequest (400) |
invalidCategoryId |
พร็อพเพอร์ตี้ snippet.categoryId ระบุรหัสหมวดหมู่ที่ไม่ถูกต้อง ใช้เมธอด videoCategories.list เพื่อเรียกหมวดหมู่ที่รองรับ |
badRequest (400) |
invalidDescription |
ข้อมูลเมตาของคำขอระบุคำอธิบายวิดีโอที่ไม่ถูกต้อง |
badRequest (400) |
invalidFilename |
ชื่อไฟล์วิดีโอที่ระบุในส่วนหัว Slug ไม่ถูกต้อง |
badRequest (400) |
invalidPublishAt |
ข้อมูลเมตาของคำขอระบุเวลาเผยแพร่ที่กำหนดเวลาไว้ไม่ถูกต้อง |
badRequest (400) |
invalidRecordingDetails |
ออบเจ็กต์ recordingDetails ในข้อมูลเมตาของคำขอระบุรายละเอียดการบันทึกที่ไม่ถูกต้อง |
badRequest (400) |
invalidTags |
ข้อมูลเมตาของคำขอระบุคีย์เวิร์ดวิดีโอที่ไม่ถูกต้อง |
badRequest (400) |
invalidTitle |
ข้อมูลเมตาของคำขอระบุชื่อวิดีโอที่ไม่ถูกต้องหรือว่างเปล่า |
badRequest (400) |
invalidVideoGameRating |
ข้อมูลเมตาของคำขอระบุการจัดประเภทวิดีโอเกมที่ไม่ถูกต้อง |
badRequest (400) |
invalidVideoMetadata |
ข้อมูลเมตาของคำขอไม่ถูกต้อง ข้อผิดพลาดนี้จะเกิดขึ้นหากคำขออัปเดตส่วน snippet ของทรัพยากร video แต่ไม่ได้ตั้งค่าสำหรับทั้งพร็อพเพอร์ตี้ snippet.title และ snippet.categoryId |
badRequest (400) |
mediaBodyRequired |
คำขอไม่มีเนื้อหาวิดีโอ |
badRequest (400) |
uploadLimitExceeded |
ผู้ใช้ได้อัปโหลดวิดีโอเกินจำนวนที่อนุญาตแล้ว |
forbidden (403) |
forbidden |
|
forbidden (403) |
forbiddenLicenseSetting |
คำขอพยายามตั้งค่าใบอนุญาตที่ไม่ถูกต้องสำหรับวิดีโอ |
forbidden (403) |
forbiddenPrivacySetting |
คำขอพยายามตั้งค่าความเป็นส่วนตัวที่ไม่ถูกต้องสำหรับวิดีโอ |
videos.list
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
badRequest (400) |
videoChartNotFound |
ระบบไม่รองรับหรือไม่มีชาร์ตวิดีโอที่ขอ |
forbidden (403) |
forbidden |
คำขอไม่ได้รับสิทธิ์อย่างถูกต้องในการเข้าถึงไฟล์วิดีโอหรือข้อมูลการประมวลผล ส่วน fileDetails , processingDetails และ suggestions จะใช้ได้เฉพาะเจ้าของวิดีโอนั้นๆ เท่านั้น |
forbidden (403) |
forbidden |
คำขอไม่สามารถเข้าถึงข้อมูลการให้คะแนนของผู้ใช้ ข้อผิดพลาดนี้อาจเกิดขึ้นเนื่องจากคำขอไม่ได้รับอนุญาตอย่างถูกต้องให้ใช้พารามิเตอร์ myRating |
notFound (404) |
videoNotFound |
ไม่พบวิดีโอที่คุณพยายามดึงข้อมูล ตรวจสอบค่าของพารามิเตอร์ id ของคำขอเพื่อให้แน่ใจว่าถูกต้อง |
videos.delete
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
forbidden (403) |
forbidden |
ไม่สามารถลบวิดีโอที่คุณพยายามลบได้ คำขออาจไม่ได้รับอนุญาตอย่างถูกต้อง |
notFound (404) |
videoNotFound |
ไม่พบวิดีโอที่คุณพยายามลบ ตรวจสอบค่าของพารามิเตอร์ id ของคำขอเพื่อให้แน่ใจว่าถูกต้อง |
videos.update
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
badRequest (400) |
defaultLanguageNotSet |
คำขอ API พยายามเพิ่มรายละเอียดวิดีโอที่แปลแล้วโดยไม่ได้ระบุภาษาเริ่มต้นของรายละเอียดวิดีโอ |
badRequest (400) |
invalidCategoryId |
พร็อพเพอร์ตี้ snippet.categoryId ระบุรหัสหมวดหมู่ที่ไม่ถูกต้อง ใช้เมธอด videoCategories.list เพื่อเรียกหมวดหมู่ที่รองรับ |
badRequest (400) |
invalidDefaultBroadcastPrivacySetting |
คำขอพยายามตั้งค่าความเป็นส่วนตัวที่ไม่ถูกต้องสำหรับการออกอากาศเริ่มต้น |
badRequest (400) |
invalidDescription |
ข้อมูลเมตาของคำขอระบุคำอธิบายวิดีโอที่ไม่ถูกต้อง |
badRequest (400) |
invalidPublishAt |
ข้อมูลเมตาของคำขอระบุเวลาเผยแพร่ที่กำหนดเวลาไว้ไม่ถูกต้อง |
badRequest (400) |
invalidRecordingDetails |
ออบเจ็กต์ recordingDetails ในข้อมูลเมตาของคำขอระบุรายละเอียดการบันทึกที่ไม่ถูกต้อง |
badRequest (400) |
invalidTags |
ข้อมูลเมตาของคำขอระบุคีย์เวิร์ดวิดีโอที่ไม่ถูกต้อง |
badRequest (400) |
invalidTitle |
ข้อมูลเมตาของคำขอระบุชื่อวิดีโอที่ไม่ถูกต้องหรือว่างเปล่า |
badRequest (400) |
invalidVideoMetadata |
ข้อมูลเมตาของคำขอไม่ถูกต้อง ข้อผิดพลาดนี้จะเกิดขึ้นหากคำขออัปเดตส่วน snippet ของทรัพยากร video แต่ไม่ได้ตั้งค่าสำหรับทั้งพร็อพเพอร์ตี้ snippet.title และ snippet.categoryId |
forbidden (403) |
forbidden |
ห้ามเข้าถึง คำขออาจไม่ได้รับอนุญาตอย่างถูกต้อง |
forbidden (403) |
forbiddenEmbedSetting |
คำขอพยายามตั้งค่าการฝังที่ไม่ถูกต้องสำหรับวิดีโอ บางช่องอาจไม่มีสิทธิ์เสนอวิดีโอเพลเยอร์แบบฝังสำหรับไลฟ์สด ดูข้อมูลเพิ่มเติมได้ที่ศูนย์ช่วยเหลือของ YouTube |
forbidden (403) |
forbiddenLicenseSetting |
คำขอพยายามตั้งค่าใบอนุญาตที่ไม่ถูกต้องสำหรับวิดีโอ |
forbidden (403) |
forbiddenPrivacySetting |
คำขอพยายามตั้งค่าความเป็นส่วนตัวที่ไม่ถูกต้องสำหรับวิดีโอ |
notFound (404) |
videoNotFound |
ไม่พบวิดีโอที่คุณพยายามอัปเดต ตรวจสอบค่าของฟิลด์ id ในเนื้อหาคำขอเพื่อให้แน่ใจว่าถูกต้อง |
videos.rate
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
badRequest (400) |
emailNotVerified |
ผู้ใช้ต้องยืนยันอีเมลของตนเองก่อนให้คะแนน |
badRequest (400) |
invalidRating |
คำขอมีค่าที่ไม่คาดคิดสำหรับพารามิเตอร์ rating |
badRequest (400) |
videoPurchaseRequired |
มีเพียงผู้ใช้ที่เช่าวิดีโอเท่านั้นที่จะให้คะแนนวิดีโอที่เช่าได้ |
forbidden (403) |
forbidden |
คุณไม่สามารถจัดประเภทวิดีโอที่พยายามจัดประเภทได้ คำขออาจไม่ได้รับอนุญาตอย่างถูกต้อง |
forbidden (403) |
videoRatingDisabled |
เจ้าของวิดีโอที่คุณพยายามให้คะแนนได้ปิดใช้การให้คะแนนสำหรับวิดีโอนั้น |
notFound (404) |
videoNotFound |
ไม่พบวิดีโอที่คุณพยายามให้คะแนน ตรวจสอบค่าของพารามิเตอร์ id ของคำขอเพื่อให้แน่ใจว่าถูกต้อง |
videos.reportAbuse
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
badRequest (400) |
invalidAbuseReason |
คำขอมีค่าที่ไม่คาดคิดสำหรับฟิลด์ reason_id หรือค่าผสมของฟิลด์ reason_id และ secondary_reason_id |
badRequest (400) |
rateLimitExceeded |
ผู้ใช้ส่งคำขอมากเกินไปในช่วงเวลาที่กำหนด |
forbidden (403) |
forbidden |
|
notFound (404) |
videoNotFound |
ไม่พบวิดีโอที่คุณพยายามรายงานการละเมิด |
ลายน้ำ
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API แสดงเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร watermarks
นอกจากนี้ เมธอดเหล่านี้ยังอาจแสดงข้อผิดพลาดที่ระบุไว้ในส่วนข้อผิดพลาดที่พบบ่อยในคำขอด้วย
watermarks.set
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
badRequest (400) |
imageFormatUnsupported |
รูปภาพที่คุณระบุอยู่ในรูปแบบที่ระบบไม่รองรับ |
badRequest (400) |
imageTooTall |
รูปภาพที่คุณระบุมีความสูงมากเกินไป |
badRequest (400) |
imageTooWide |
รูปภาพที่คุณระบุมีความกว้างมากเกินไป |
badRequest (400) |
mediaBodyRequired |
คำขอไม่มีเนื้อหารูปภาพ |
forbidden (403) |
forbidden |
ตั้งลายน้ำสำหรับช่องที่ระบุไม่ได้ คำขออาจไม่ได้รับอนุญาตอย่างถูกต้อง หรือพารามิเตอร์ channelId ตั้งค่าเป็นค่าที่ไม่ถูกต้อง |
watermarks.unset
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
forbidden (403) |
forbidden |
ยกเลิกการตั้งค่าลายน้ำสำหรับช่องที่ระบุไม่ได้ คำขออาจไม่ได้รับอนุญาตอย่างถูกต้อง หรือพารามิเตอร์ channelId ตั้งค่าเป็นค่าที่ไม่ถูกต้อง |
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-10-06 UTC
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 2025-10-06 UTC"],[],["API errors include `forbidden (403)` for access or quota issues, and `notFound (404)` for missing resources. `badRequest (400)` signals invalid parameters or missing data. `unauthorized (401)` means proper authorization is missing. Actions like `insert`, `update`, `delete`, `list` and `rate` are subject to errors, such as invalid input, authorization failures, or resource unavailability. Operations involving channels, captions, playlists, comments, videos, and subscriptions have specific error conditions, like duplicate entries or channel/video not found. Error descriptions often indicate necessary parameter corrections or authorization requirements.\n"]]
ความคิดเห็น
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API แสดงเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร
comments
นอกจากนี้ เมธอดเหล่านี้ยังอาจแสดงข้อผิดพลาดที่ระบุไว้ในส่วนข้อผิดพลาดที่พบบ่อยในคำขอด้วยcomments.list
badRequest (400)
operationNotSupported
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
และparentId
ของคำขอเพื่อให้แน่ใจว่าถูกต้องcomments.setModerationStatus
badRequest (400)
banWithoutReject
banAuthor
ได้ก็ต่อเมื่อค่าพารามิเตอร์moderationStatus
เป็นrejected
เท่านั้นbadRequest (400)
operationNotSupported
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
ของคำขอเพื่อให้แน่ใจว่าถูกต้องcomments.insert
badRequest (400)
commentTextRequired
comment
ที่กำลังแทรกต้องระบุค่าสำหรับพร็อพเพอร์ตี้snippet.textOriginal
ต้องระบุความคิดเห็นbadRequest (400)
commentTextTooLong
comment
ที่กำลังแทรกมีอักขระมากเกินไปในพร็อพเพอร์ตี้snippet.textOriginal
badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
snippet.parentId
ไม่ได้ ในcommentThread
ทรัพยากร พร็อพเพอร์ตี้snippet.canReply
จะระบุว่าผู้ชมปัจจุบันตอบกลับเธรดได้หรือไม่badRequest (400)
parentCommentIsPrivate
badRequest (400)
parentIdMissing
comment
ในเนื้อหาของคำขอ API ไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้snippet.parentId
badRequest (400)
processingFailure
comment
ในเนื้อหาคำขอเพื่อให้แน่ใจว่าถูกต้องforbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
parentCommentNotFound
snippet.parentId
ในเนื้อหาคำขอเพื่อให้แน่ใจว่าถูกต้องcomments.delete
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
ของคำขอเพื่อให้แน่ใจว่าถูกต้องcomments.update
badRequest (400)
commentTextTooLong
comment
ที่กำลังอัปเดตมีอักขระมากเกินไปในพร็อพเพอร์ตี้snippet.textOriginal
badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
comment
ในเนื้อหาคำขอเพื่อให้แน่ใจว่าถูกต้องforbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
commentNotFound
id
ในเนื้อหาคำขอเพื่อให้แน่ใจว่าถูกต้อง