วิดีโอทั้งหมดที่อัปโหลดผ่านปลายทาง
videos.insert
จากโปรเจ็กต์ API ที่ไม่ได้รับการยืนยันซึ่งสร้างขึ้นหลังวันที่ 28 กรกฎาคม 2020 จะจำกัดให้อยู่ในโหมดดูแบบส่วนตัว หากต้องการยกเลิกข้อจํากัดนี้ โปรเจ็กต์ API แต่ละโปรเจ็กต์ต้องผ่านการตรวจสอบเพื่อยืนยันว่าเป็นไปตามข้อกําหนดในการให้บริการ โปรดดูรายละเอียดเพิ่มเติมที่ประวัติการแก้ไข API
ทรัพยากร video
แสดงถึงวิดีโอ YouTube
เมธอด
API รองรับวิธีการต่อไปนี้สําหรับทรัพยากร videos
- getRating
- ดึงข้อมูลการให้คะแนนที่ผู้ใช้ที่ได้รับอนุญาตมอบให้กับรายการวิดีโอที่ระบุ ลองใช้เลย
- list
- แสดงรายการวิดีโอที่ตรงกับพารามิเตอร์คำขอ API ลองใช้เลย
- แทรก
- อัปโหลดวิดีโอไปยัง YouTube และตั้งค่าข้อมูลเมตาของวิดีโอ (ไม่บังคับ)
- update
- อัปเดตข้อมูลเมตาของวิดีโอ ลองใช้เลย
- ลบ
- ลบวิดีโอ YouTube ลองใช้เลย
- rate
- เพิ่มหรือนำการให้คะแนนชอบหรือไม่ชอบออกจากวิดีโอ ลองใช้เลย
- reportAbuse
- รายงานวิดีโอที่มีเนื้อหาที่เป็นการละเมิด ลองใช้เลย
การนําเสนอทรัพยากร
โครงสร้าง JSON ต่อไปนี้แสดงรูปแบบของทรัพยากร videos
{ "kind": "youtube#video", "etag": etag, "id": string, "snippet": { "publishedAt": datetime, "channelId": string, "title": string, "description": string, "thumbnails": { (key): { "url": string, "width": unsigned integer, "height": unsigned integer } }, "channelTitle": string, "tags": [ string ], "categoryId": string, "liveBroadcastContent": string, "defaultLanguage": string, "localized": { "title": string, "description": string }, "defaultAudioLanguage": string }, "contentDetails": { "duration": string, "dimension": string, "definition": string, "caption": string, "licensedContent": boolean, "regionRestriction": { "allowed": [ string ], "blocked": [ string ] }, "contentRating": { "acbRating": string, "agcomRating": string, "anatelRating": string, "bbfcRating": string, "bfvcRating": string, "bmukkRating": string, "catvRating": string, "catvfrRating": string, "cbfcRating": string, "cccRating": string, "cceRating": string, "chfilmRating": string, "chvrsRating": string, "cicfRating": string, "cnaRating": string, "cncRating": string, "csaRating": string, "cscfRating": string, "czfilmRating": string, "djctqRating": string, "djctqRatingReasons": [, string ], "ecbmctRating": string, "eefilmRating": string, "egfilmRating": string, "eirinRating": string, "fcbmRating": string, "fcoRating": string, "fmocRating": string, "fpbRating": string, "fpbRatingReasons": [, string ], "fskRating": string, "grfilmRating": string, "icaaRating": string, "ifcoRating": string, "ilfilmRating": string, "incaaRating": string, "kfcbRating": string, "kijkwijzerRating": string, "kmrbRating": string, "lsfRating": string, "mccaaRating": string, "mccypRating": string, "mcstRating": string, "mdaRating": string, "medietilsynetRating": string, "mekuRating": string, "mibacRating": string, "mocRating": string, "moctwRating": string, "mpaaRating": string, "mpaatRating": string, "mtrcbRating": string, "nbcRating": string, "nbcplRating": string, "nfrcRating": string, "nfvcbRating": string, "nkclvRating": string, "oflcRating": string, "pefilmRating": string, "rcnofRating": string, "resorteviolenciaRating": string, "rtcRating": string, "rteRating": string, "russiaRating": string, "skfilmRating": string, "smaisRating": string, "smsaRating": string, "tvpgRating": string, "ytRating": string }, "projection": string, "hasCustomThumbnail": boolean }, "status": { "uploadStatus": string, "failureReason": string, "rejectionReason": string, "privacyStatus": string, "publishAt": datetime, "license": string, "embeddable": boolean, "publicStatsViewable": boolean, "madeForKids": boolean, "selfDeclaredMadeForKids": boolean, "containsSyntheticMedia": boolean }, "statistics": { "viewCount": string, "likeCount": string, "dislikeCount": string, "favoriteCount": string, "commentCount": string }, "paidProductPlacementDetails": { "hasPaidProductPlacement": boolean }, "player": { "embedHtml": string, "embedHeight": long, "embedWidth": long }, "topicDetails": { "topicIds": [ string ], "relevantTopicIds": [ string ], "topicCategories": [ string ] }, "recordingDetails": { "recordingDate": datetime }, "fileDetails": { "fileName": string, "fileSize": unsigned long, "fileType": string, "container": string, "videoStreams": [ { "widthPixels": unsigned integer, "heightPixels": unsigned integer, "frameRateFps": double, "aspectRatio": double, "codec": string, "bitrateBps": unsigned long, "rotation": string, "vendor": string } ], "audioStreams": [ { "channelCount": unsigned integer, "codec": string, "bitrateBps": unsigned long, "vendor": string } ], "durationMs": unsigned long, "bitrateBps": unsigned long, "creationTime": string }, "processingDetails": { "processingStatus": string, "processingProgress": { "partsTotal": unsigned long, "partsProcessed": unsigned long, "timeLeftMs": unsigned long }, "processingFailureReason": string, "fileDetailsAvailability": string, "processingIssuesAvailability": string, "tagSuggestionsAvailability": string, "editorSuggestionsAvailability": string, "thumbnailsAvailability": string }, "suggestions": { "processingErrors": [ string ], "processingWarnings": [ string ], "processingHints": [ string ], "tagSuggestions": [ { "tag": string, "categoryRestricts": [ string ] } ], "editorSuggestions": [ string ] }, "liveStreamingDetails": { "actualStartTime": datetime, "actualEndTime": datetime, "scheduledStartTime": datetime, "scheduledEndTime": datetime, "concurrentViewers": unsigned long, "activeLiveChatId": string }, "localizations": { (key): { "title": string, "description": string } } }
พร็อพเพอร์ตี้
ตารางต่อไปนี้จะกำหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้
พร็อพเพอร์ตี้ | |
---|---|
kind |
string ระบุประเภทของทรัพยากร API ค่าจะเป็น youtube#video |
etag |
etag Etag ของทรัพยากรนี้ |
id |
string รหัสที่ YouTube ใช้เพื่อระบุวิดีโอโดยไม่ซ้ำกัน |
snippet |
object ออบเจ็กต์ snippet มีรายละเอียดพื้นฐานเกี่ยวกับวิดีโอ เช่น ชื่อ คำอธิบาย และหมวดหมู่ |
snippet.publishedAt |
datetime วันที่และเวลาที่เผยแพร่วิดีโอ โปรดทราบว่าเวลานี้อาจแตกต่างจากเวลาที่อัปโหลดวิดีโอ ตัวอย่างเช่น หากอัปโหลดวิดีโอเป็นวิดีโอส่วนตัวแล้วเปลี่ยนเป็นวิดีโอสาธารณะในภายหลัง พร็อพเพอร์ตี้นี้จะระบุเวลาที่วิดีโอเปลี่ยนเป็นแบบสาธารณะ มีกรณีพิเศษ 2 กรณีดังนี้
|
snippet.channelId |
string รหัสที่ YouTube ใช้เพื่อระบุช่องที่อัปโหลดวิดีโอโดยไม่ซ้ำกัน |
snippet.title |
string ชื่อวิดีโอ ค่าพร็อพเพอร์ตี้มีความยาวสูงสุด 100 อักขระ และอาจมีอักขระ UTF-8 ที่ถูกต้องทั้งหมด ยกเว้น < และ > คุณต้องตั้งค่าสำหรับพร็อพเพอร์ตี้นี้หากคุณเรียกใช้เมธอด videos.update และกำลังอัปเดตส่วน snippet ของทรัพยากร video |
snippet.description |
string คําอธิบายของวิดีโอ ค่าพร็อพเพอร์ตี้มีความยาวได้สูงสุด 5,000 ไบต์ และอาจมีอักขระ UTF-8 ที่ถูกต้องทั้งหมดยกเว้น < และ > |
snippet.thumbnails |
object แผนที่รูปภาพขนาดย่อที่เชื่อมโยงกับวิดีโอ สำหรับวัตถุแต่ละรายการในแผนที่ คีย์คือชื่อของภาพขนาดย่อ และค่าคือวัตถุที่มีข้อมูลอื่นๆ เกี่ยวกับภาพขนาดย่อ |
snippet.thumbnails.(key) |
object คีย์-ค่าที่ใช้ได้มีดังนี้
|
snippet.thumbnails.(key).url |
string URL ของรูปภาพ |
snippet.thumbnails.(key).width |
unsigned integer ความกว้างของรูปภาพ |
snippet.thumbnails.(key).height |
unsigned integer ความสูงของรูปภาพ |
snippet.channelTitle |
string ชื่อช่องสำหรับช่องที่มีวิดีโอ |
snippet.tags[] |
list รายการแท็กคีย์เวิร์ดที่เชื่อมโยงกับวิดีโอ แท็กอาจมีเว้นวรรคได้ ค่าพร็อพเพอร์ตี้มีความยาวได้สูงสุด 500 อักขระ โปรดศึกษากฎต่อไปนี้ซึ่งเกี่ยวกับวิธีคำนวณจำนวนอักขระสูงสุด:
|
snippet.categoryId |
string หมวดหมู่วิดีโอ YouTube ที่เชื่อมโยงกับวิดีโอ คุณต้องตั้งค่าพร็อพเพอร์ตี้นี้หากเรียกใช้เมธอด videos.update และอัปเดตส่วน snippet ของทรัพยากร video |
snippet.liveBroadcastContent |
string ระบุว่าวิดีโอเป็นการถ่ายทอดสดที่กำลังจะเผยแพร่/ใช้งานอยู่หรือไม่ หรือเป็น "none" หากวิดีโอไม่ใช่การถ่ายทอดสดที่กําลังจะมีขึ้น/กำลังถ่ายทอดสด ค่าที่ถูกต้องของพร็อพเพอร์ตี้นี้คือ
|
snippet.defaultLanguage |
string ภาษาของข้อความในพร็อพเพอร์ตี้ snippet.title และ snippet.description ของทรัพยากร video |
snippet.localized |
object ออบเจ็กต์ snippet.localized มีชื่อและคำอธิบายที่แปลแล้วสำหรับวิดีโอ หรือชื่อในภาษาเริ่มต้นสำหรับข้อมูลเมตาของวิดีโอ
localizations เพื่อเพิ่ม อัปเดต หรือลบชื่อที่แปลแล้ว |
snippet.localized.title |
string ชื่อวิดีโอที่แปลเป็นภาษาท้องถิ่น |
snippet.localized.description |
string คำอธิบายวิดีโอที่แปลแล้ว |
snippet.defaultAudioLanguage |
string พร็อพเพอร์ตี้ default_audio_language จะระบุภาษาที่พูดในแทร็กเสียงเริ่มต้นของวิดีโอ |
contentDetails |
object ออบเจ็กต์ contentDetails มีข้อมูลเกี่ยวกับเนื้อหาวิดีโอ ซึ่งรวมถึงความยาวของวิดีโอและตัวบ่งชี้ว่าวิดีโอมีคำบรรยายแทนเสียงหรือไม่ |
contentDetails.duration |
string ความยาวของวิดีโอ ค่าพร็อพเพอร์ตี้เป็นระยะเวลา ISO 8601 ตัวอย่างเช่น สำหรับวิดีโอที่มีความยาวอย่างน้อย 1 นาทีแต่น้อยกว่า 1 ชั่วโมง ระยะเวลาจะเป็นรูปแบบ PT#M#S โดยตัวอักษร PT บ่งบอกว่าค่าระบุระยะเวลา และตัวอักษร M และ S หมายถึงความยาวเป็นนาทีและวินาทีตามลำดับ อักขระ # ที่มาก่อนตัวอักษร M และ S จะเป็นจำนวนเต็มซึ่งระบุจำนวนนาที (หรือวินาที) ของวิดีโอ ตัวอย่างเช่น ค่า PT15M33S บ่งบอกว่าวิดีโอมีความยาว 15 นาที 33 วินาทีหากวิดีโอมีความยาวอย่างน้อย 1 ชั่วโมง ระยะเวลาจะเป็นรูปแบบ PT#H#M#S โดยที่ # ก่อนตัวอักษร H จะระบุความยาวของวิดีโอเป็นชั่วโมง และรายละเอียดอื่นๆ ทั้งหมดจะเหมือนกับที่อธิบายไว้ข้างต้น หากวิดีโอมีความยาวอย่างน้อย 1 วัน อักษร P และ T จะแยกกัน และรูปแบบของค่าจะเป็น P#DT#H#M#S โปรดดูรายละเอียดทั้งหมดในข้อกำหนด ISO 8601 |
contentDetails.dimension |
string ระบุว่าวิดีโอมีให้บริการในรูปแบบ 3 มิติหรือ 2 มิติ |
contentDetails.definition |
string ระบุว่าวิดีโอพร้อมใช้งานในแบบความละเอียดสูง ( HD ) หรือแบบความละเอียดมาตรฐานเท่านั้นค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้
|
contentDetails.caption |
string ระบุว่าวิดีโอมีคำบรรยายแทนเสียงหรือไม่ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.licensedContent |
boolean ระบุว่าวิดีโอแสดงเนื้อหาที่ได้รับอนุญาตหรือไม่ ซึ่งหมายความว่ามีการอัปโหลดเนื้อหาไปยังช่องที่ลิงก์กับพาร์ทเนอร์เนื้อหาของ YouTube แล้วพาร์ทเนอร์รายดังกล่าวอ้างสิทธิ์ในเนื้อหา |
contentDetails.regionRestriction |
object ออบเจ็กต์ regionRestriction มีข้อมูลเกี่ยวกับประเทศที่รับชมวิดีโอได้ (หรือไม่ได้) ออบเจ็กต์จะมีพร็อพเพอร์ตี้ contentDetails.regionRestriction.allowed หรือพร็อพเพอร์ตี้ contentDetails.regionRestriction.blocked |
contentDetails.regionRestriction.allowed[] |
list รายการรหัสภูมิภาคที่ระบุประเทศที่รับชมวิดีโอได้ หากพร็อพเพอร์ตี้นี้แสดงอยู่และไม่มีประเทศแสดงอยู่ในค่า ระบบจะบล็อกวิดีโอไม่ให้ปรากฏในประเทศนั้น หากมีพร็อพเพอร์ตี้นี้อยู่และมีรายการที่ว่างเปล่า ระบบจะบล็อกวิดีโอในทุกประเทศ |
contentDetails.regionRestriction.blocked[] |
list รายการรหัสภูมิภาคที่ระบุประเทศที่วิดีโอถูกบล็อก หากพร็อพเพอร์ตี้นี้แสดงอยู่และไม่มีประเทศแสดงอยู่ในค่า แสดงว่าวิดีโอจะรับชมได้ในประเทศนั้น หากพร็อพเพอร์ตี้นี้มีอยู่และมีรายการว่าง วิดีโอจะดูได้ในทุกประเทศ |
contentDetails.contentRating |
object ระบุการจัดประเภทที่วิดีโอได้รับภายใต้รูปแบบการจัดประเภทต่างๆ |
contentDetails.contentRating.acbRating |
string การจัดประเภทวิดีโอของ Australian Classification Board (ACB) หรือ Australian Communications and Media Authority (ACMA) ระบบใช้การจัดประเภทของ ACMA เพื่อจัดประเภทรายการทีวีสำหรับเด็ก ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.agcomRating |
string การจัดประเภทวิดีโอจาก Autorità per le Garanzie nelle Comunicazioni (AGCOM) ของอิตาลี ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.anatelRating |
string การจัดประเภท Anatel (Asociación Nacional de Televisión) ของวิดีโอสำหรับโทรทัศน์ชิลี ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.bbfcRating |
string การจัดประเภทของคณะกรรมการจัดประเภทภาพยนตร์ของสหราชอาณาจักร (BBFC) สำหรับวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.bfvcRating |
string การจัดประเภทวิดีโอจากคณะกรรมการพิจารณาภาพยนตร์และวีดิทัศน์แห่งประเทศไทย ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.bmukkRating |
string การจัดประเภทวิดีโอจากคณะกรรมการการจัดประเภทสื่อของออสเตรีย (Bundesministerium für Unterricht, Kunst und Kultur) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.catvRating |
string ระบบการจัดประเภทสำหรับ Canadian TV - Canadian TV Classification System การจัดประเภทวิดีโอจากคณะกรรมการวิทยุและโทรคมนาคมของแคนาดา (Canadian Radio-Television and Telecommunications Commission หรือ CRTC) สำหรับการออกอากาศภาษาอังกฤษของแคนาดา ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ของCanadian Broadcast Standards Council ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.catvfrRating |
string การจัดประเภทวิดีโอจากคณะกรรมการกิจการกระจายเสียง กิจการโทรทัศน์ และกิจการโทรคมนาคมแห่งแคนาดา (CRTC) สําหรับการออกอากาศภาษาฝรั่งเศสในแคนาดา ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ของCanadian Broadcast Standards Council ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.cbfcRating |
string การจัดประเภทของคณะกรรมการกลางพิจารณาภาพยนตร์ (CBFC - อินเดีย) สำหรับวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.cccRating |
string การจัดประเภทของ Consejo de Calificación Cinematográfica (ชิลี) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.cceRating |
string การจัดประเภทของวิดีโอจาก Comissão de Classificação de Espect´culos ของโปรตุเกส ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.chfilmRating |
string การจัดประเภทวิดีโอในสวิตเซอร์แลนด์ ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.chvrsRating |
string การจัดประเภทของระบบการจัดประเภทวิดีโอสำหรับใช้ในบ้านของแคนาดา (CHVRS) ของวิดีโอ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.cicfRating |
string การจัดประเภทวิดีโอจาก Commission de Contrôle des Films (เบลเยียม) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.cnaRating |
string การจัดประเภทวิดีโอจาก CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) ของโรมาเนีย ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.cncRating |
string ระบบการจัดประเภทในฝรั่งเศส - Commission de classification cinematographique ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.csaRating |
string การจัดประเภทวิดีโอจาก Conseil supérieur de l?audiovisuel ของฝรั่งเศส ซึ่งจัดประเภทเนื้อหาที่ออกอากาศ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.cscfRating |
string การจัดประเภทวิดีโอจาก Commission de surveillance de la classification des films (CSCF) ของลักเซมเบิร์ก ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.czfilmRating |
string การจัดประเภทของวิดีโอในสาธารณรัฐเช็ก ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.djctqRating |
string การจัดประเภทของ Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - บราซิล) ของวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.djctqRatingReasons[] |
list เหตุผลที่วิดีโอได้รับการจัดประเภทโดย DJCQT (บราซิล) |
contentDetails.contentRating.ecbmctRating |
string ระบบการจัดประเภทในตุรกี - คณะกรรมการประเมินและจัดประเภทของกระทรวงวัฒนธรรมและการท่องเที่ยง ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.eefilmRating |
string การจัดประเภทของวิดีโอในเอสโตเนีย ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.egfilmRating |
string การจัดประเภทวิดีโอในอียิปต์ ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.eirinRating |
string การจัดประเภท Eirin (映倫) ของวิดีโอ Eirin เป็นระบบการจัดประเภทของญี่ปุ่น ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.fcbmRating |
string การจัดประเภทวิดีโอจากคณะกรรมการพิจารณาภาพยนตร์ของมาเลเซีย ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.fcoRating |
string การจัดประเภทของวิดีโอจากสำนักงานบริหารภาพยนตร์ หนังสือพิมพ์ และบทความของฮ่องกง ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.fmocRating |
string เราได้เลิกใช้งานพร็อพเพอร์ตี้นี้ตั้งแต่วันที่ 2 พฤศจิกายน 2015 ใช้พร็อพเพอร์ตี้ contentDetails.contentRating.cncRating แทนการจัดประเภทของ Centre national du cinéma et de l'image animé (กระทรวงวัฒนธรรมฝรั่งเศส) สำหรับวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.fpbRating |
string การจัดประเภทของวิดีโอจากคณะกรรมการภาพยนตร์และสื่อสิ่งพิมพ์ของแอฟริกาใต้ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.fpbRatingReasons[] |
list เหตุผลที่อธิบายว่าเหตุใดวิดีโอจึงได้รับการจัดประเภท FPB (แอฟริกาใต้) |
contentDetails.contentRating.fskRating |
string การจัดประเภท Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - เยอรมนี) ของวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.grfilmRating |
string การจัดประเภทวิดีโอในกรีซ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.icaaRating |
string การจัดประเภทของ Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - สเปน) ของวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.ifcoRating |
string การจัดประเภทของวิดีโอโดยสำนักงานการจัดประเภทภาพยนตร์แห่งไอร์แลนด์ (IFCO - ไอร์แลนด์) ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ IFCO ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.ilfilmRating |
string การจัดประเภทของวิดีโอในอิสราเอล ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.incaaRating |
string การจัดประเภทของ INCAA (Instituto Nacional de Cine y Artes Audiovisuales - อาร์เจนตินา) สำหรับวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.kfcbRating |
string การจัดประเภทของวิดีโอจากคณะกรรมการการจัดประเภทภาพยนตร์ของ Kenya ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.kijkwijzerRating |
string voor de Classificatie van Audiovisuele Media (เนเธอร์แลนด์) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.kmrbRating |
string การจัดประเภทของคณะกรรมการการจัดประเภทสื่อเกาหลี (영상물등급위원회) สำหรับวิดีโอ KMRB จัดประเภทวิดีโอในเกาหลีใต้ ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.lsfRating |
string การจัดประเภทวิดีโอจากภาพยนตร์เซ็นเซอร์ Lembaga ของอินโดนีเซีย ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.mccaaRating |
string การจัดประเภทของวิดีโอจากคณะกรรมการการจัดประเภทภาพยนตร์ตามอายุของมอลตา ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.mccypRating |
string การจัดประเภทวิดีโอจากสภาสื่อสำหรับเด็กและเยาวชนของเดนมาร์ก (Det Danske Filminstitut) จากสภาสื่อสำหรับเด็กและเยาวชน ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.mcstRating |
string ระบบการจัดประเภทของวิดีโอสำหรับเวียดนาม - MCST ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.mdaRating |
string การจัดประเภทวิดีโอจากหน่วยงานพัฒนาสื่อ (Media Development Authority หรือ MDA) ของสิงคโปร์ และโดยเฉพาะคณะกรรมการตรวจสอบภาพยนตร์ (Board of Film Censors หรือ BFC) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.medietilsynetRating |
string การจัดประเภทวิดีโอจาก Medietilsynet ซึ่งเป็นหน่วยงานกำกับดูแลสื่อของนอร์เวย์ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.mekuRating |
string การจัดประเภทวิดีโอจาก Kansallinen Audiovisuaalinen Instituutti (สถาบันภาพและเสียงแห่งชาติ) ของฟินแลนด์ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.mibacRating |
string การจัดประเภทวิดีโอจาก Ministero dei Beni e delle Attività Culturali e del Turismo (อิตาลี) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.mocRating |
string การจัดประเภทของ Ministerio de Cultura (โคลอมเบีย) สำหรับวิดีโอ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.moctwRating |
string การจัดประเภทของวิดีโอจากกระทรวงวัฒนธรรม (文化部) ของไต้หวัน ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.mpaaRating |
string การจัดประเภทของสมาคมภาพยนตร์แห่งสหรัฐอเมริกา (MPAA) สำหรับวิดีโอ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.mpaatRating |
string การจัดประเภทของตัวอย่างภาพยนตร์และตัวอย่างเพลงโดยสมาคมภาพยนตร์อเมริกัน ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.mtrcbRating |
string การจัดประเภทของวิดีโอจากคณะกรรมการตรวจสอบและจัดประเภทภาพยนตร์และโทรทัศน์ (ฟิลิปปินส์) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.nbcRating |
string การจัดประเภทของวิดีโอจากสำนักการจัดประเภทแห่งชาติของมัลดีฟส์ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.nfrcRating |
string การจัดประเภทวิดีโอจากศูนย์ภาพยนตร์แห่งชาติบัลแกเรีย ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.nfvcbRating |
string การจัดประเภทวิดีโอจากคณะกรรมการตรวจสอบภาพยนตร์และวิดีโอแห่งชาติของไนจีเรีย ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.nkclvRating |
string การจัดประเภทวิดีโอจาก Nacionãlais Kino centrs (ศูนย์ภาพยนตร์แห่งชาติของลัตเวีย) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.oflcRating |
string การจัดประเภทของ Office of Film and Literature Classification (OFLC - นิวซีแลนด์) สำหรับวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.pefilmRating |
string การจัดประเภทของวิดีโอในเปรู ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.resorteviolenciaRating |
string การจัดประเภทวิดีโอในเวเนซุเอลา ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
|
contentDetails.contentRating.rtcRating |
string การจัดประเภทของวิดีโอโดยสำนักผู้อำนวยการทั่วไปด้านวิทยุ ทีวี และภาพยนตร์ (เม็กซิโก) ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.rteRating |
string การจัดประเภทของวิดีโอจาก Raidió Teilifís Éireann ของไอร์แลนด์ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.russiaRating |
string การจัดประเภทภาพยนตร์แห่งชาติของสหพันธรัฐรัสเซีย (MKRF - รัสเซีย) ของวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.skfilmRating |
string การจัดประเภทของวิดีโอในสโลวาเกีย ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.smaisRating |
string การจัดประเภทของวิดีโอในไอซ์แลนด์ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.smsaRating |
string การจัดประเภทของวิดีโอจาก Statens medieråd (คณะกรรมการสื่อแห่งชาติของสวีเดน) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.tvpgRating |
string การจัดประเภท TV Parental Guidelines (TVPG) ของวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.ytRating |
string การจัดประเภทที่ YouTube ใช้เพื่อระบุเนื้อหาที่มีการจำกัดอายุผู้ชม ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.projection |
string ระบุรูปแบบการฉายภาพของวิดีโอ ค่าที่ถูกต้องสำหรับคุณสมบัตินี้คือ
|
contentDetails.hasCustomThumbnail |
boolean ระบุว่าผู้อัปโหลดวิดีโอได้ระบุภาพปกวิดีโอที่กำหนดเองสำหรับวิดีโอหรือไม่ เฉพาะผู้อัปโหลดวิดีโอเท่านั้นที่จะเห็นพร็อพเพอร์ตี้นี้ |
status |
object ออบเจ็กต์ status มีข้อมูลเกี่ยวกับการอัปโหลด การประมวลผล และสถานะความเป็นส่วนตัวของวิดีโอ |
status.uploadStatus |
string สถานะของวิดีโอที่อัปโหลด ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
status.failureReason |
string ค่านี้อธิบายสาเหตุที่วิดีโออัปโหลดไม่สำเร็จ พร็อพเพอร์ตี้นี้จะแสดงก็ต่อเมื่อพร็อพเพอร์ตี้ uploadStatus ระบุว่าการอัปโหลดไม่สำเร็จค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
status.rejectionReason |
string ค่านี้อธิบายสาเหตุที่ YouTube ปฏิเสธวิดีโอที่อัปโหลด พร็อพเพอร์ตี้นี้จะแสดงก็ต่อเมื่อพร็อพเพอร์ตี้ uploadStatus ระบุว่าการอัปโหลดถูกปฏิเสธค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
status.privacyStatus |
string สถานะความเป็นส่วนตัวของวิดีโอ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
status.publishAt |
datetime วันที่และเวลาที่มีการกำหนดให้เผยแพร่วิดีโอ โดยคุณจะตั้งค่าได้ก็ต่อเมื่อสถานะความเป็นส่วนตัวของวิดีโอเป็นแบบส่วนตัวเท่านั้น ค่าจะอยู่ในรูปแบบ ISO 8601 โปรดทราบประเด็นเพิ่มเติม 2 ข้อต่อไปนี้เกี่ยวกับลักษณะการทํางานของพร็อพเพอร์ตี้นี้
|
status.license |
string ใบอนุญาตของวิดีโอ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
status.embeddable |
boolean ค่านี้ระบุให้ทราบว่าวิดีโอจะฝังในเว็บไซต์อื่นได้หรือไม่ |
status.publicStatsViewable |
boolean ค่านี้ใช้เพื่อระบุว่าสถิติวิดีโอแบบขยายในหน้าดูวิดีโอจะแสดงต่อสาธารณะหรือไม่ โดยค่าเริ่มต้น สถิติเหล่านั้นจะสามารถดูได้ และสถิติต่างๆ เช่น จำนวนการดูและการให้คะแนนของวิดีโอจะยังคงแสดงแบบสาธารณะ แม้ว่าจะตั้งค่าของพร็อพเพอร์ตี้นี้เป็น false ก็ตาม |
status.madeForKids |
boolean ค่านี้ระบุว่าวิดีโอได้รับการระบุว่ามีเด็กเป็นกลุ่มเป้าหมายหรือไม่ และมีสถานะปัจจุบันของวิดีโอเป็น "สร้างมาเพื่อเด็ก" เช่น สถานะอาจกำหนดตามค่าของพร็อพเพอร์ตี้ selfDeclaredMadeForKids ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดผู้ชมของช่อง วิดีโอ หรือการออกอากาศได้ที่ศูนย์ช่วยเหลือของ YouTube
|
status.selfDeclaredMadeForKids |
boolean ในคำขอ videos.insert หรือ videos.update พร็อพเพอร์ตี้นี้ช่วยให้เจ้าของช่องระบุว่าวิดีโอมีเด็กเป็นกลุ่มเป้าหมายได้ ในคำขอ videos.list ระบบจะแสดงผลค่าของพร็อพเพอร์ตี้ก็ต่อเมื่อเจ้าของช่องให้สิทธิ์คำขอ API เท่านั้น |
status.containsSyntheticMedia |
boolean ในคำขอ videos.insert หรือ videos.update พร็อพเพอร์ตี้นี้ช่วยให้เจ้าของช่องเปิดเผยได้ว่าวิดีโอมีเนื้อหาที่ดัดแปลงหรือสังเคราะห์ (A/S) ซึ่งดูสมจริง ดูข้อมูลเพิ่มเติมเกี่ยวกับนโยบายของ YouTube ที่เกี่ยวข้องกับเนื้อหาการซ่อมและบำรุงรักษาตัวอย่างของเนื้อหา A/S ได้แก่ วิดีโอที่มีลักษณะต่อไปนี้
|
statistics |
object ออบเจ็กต์ statistics มีสถิติเกี่ยวกับวิดีโอ |
statistics.viewCount |
unsigned long จำนวนครั้งที่มีการดูวิดีโอ |
statistics.likeCount |
unsigned long จำนวนผู้ใช้ที่ระบุว่าชอบวิดีโอ |
statistics.dislikeCount |
unsigned long หมายเหตุ: เราได้ทำให้พร็อพเพอร์ตี้
statistics.dislikeCount เป็นแบบส่วนตัวแล้วเมื่อวันที่ 13 ธันวาคม 2021 ซึ่งหมายความว่าพร็อพเพอร์ตี้จะรวมอยู่ในการตอบกลับของ API ก็ต่อเมื่อเจ้าของวิดีโอตรวจสอบสิทธิ์คำขอ API เท่านั้น ดูข้อมูลเพิ่มเติมได้ที่ประวัติการแก้ไขจำนวนผู้ใช้ที่ระบุว่ากดไม่ชอบวิดีโอ |
statistics.favoriteCount |
unsigned long หมายเหตุ: เราได้เลิกใช้งานพร็อพเพอร์ตี้นี้แล้ว การเลิกใช้งานจะมีผลตั้งแต่วันที่ 28 สิงหาคม 2015 ตอนนี้ค่าของพร็อพเพอร์ตี้จะตั้งไว้ที่ 0 เสมอ |
statistics.commentCount |
unsigned long จำนวนความคิดเห็นของวิดีโอ |
paidProductPlacementDetails |
object ออบเจ็กต์ paidProductPlacementDetails มีข้อมูลเกี่ยวกับการแสดงผลิตภัณฑ์แบบชำระเงินในวิดีโอ |
paidProductPlacementDetails.hasPaidProductPlacement |
boolean ตั้งค่าเป็น true หากเนื้อหาใช้การแสดงผลิตภัณฑ์แบบชำระเงิน ค่าเริ่มต้นคือ false |
player |
object ออบเจ็กต์ player มีข้อมูลที่คุณจะใช้ในการเล่นวิดีโอในโปรแกรมเล่นที่ฝัง |
player.embedHtml |
string แท็ก <iframe> ที่ฝังวิดีโอเพลเยอร์ซึ่งเล่นวิดีโอ |
player.embedHeight |
long ความสูงของโปรแกรมเล่นที่ฝังซึ่งแสดงผลในพร็อพเพอร์ตี้ player.embedHtml ระบบจะแสดงพร็อพเพอร์ตี้นี้เฉพาะในกรณีที่คำขอระบุค่าสำหรับพารามิเตอร์ maxHeight และ/หรือ maxWidth และระบบทราบสัดส่วนภาพของวิดีโอ |
player.embedWidth |
long ความกว้างของโปรแกรมเล่นแบบฝังที่แสดงผลในพร็อพเพอร์ตี้ player.embedHtml พร็อพเพอร์ตี้นี้จะส่งคืนก็ต่อเมื่อคำขอระบุค่าสำหรับพารามิเตอร์ maxHeight และ/หรือ maxWidth และทราบสัดส่วนภาพของวิดีโอเท่านั้น |
topicDetails |
object ออบเจ็กต์ topicDetails จะรวมข้อมูลเกี่ยวกับหัวข้อที่เชื่อมโยงกับวิดีโอสำคัญ: ดูรายละเอียดเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงที่กําลังจะเกิดขึ้นเกี่ยวกับรหัสหัวข้อได้ที่คําจํากัดความของพร็อพเพอร์ตี้ topicDetails.relevantTopicIds[] และ topicDetails.topicIds[] รวมถึงประวัติการแก้ไข |
topicDetails.topicIds[] |
list สำคัญ: เราเลิกใช้งานพร็อพเพอร์ตี้นี้แล้วตั้งแต่วันที่ 10 พฤศจิกายน 2016 API จะไม่แสดงค่าสำหรับพร็อพเพอร์ตี้นี้อีกต่อไป และตอนนี้หัวข้อทั้งหมดที่เชื่อมโยงกับวิดีโอจะแสดงโดยค่าพร็อพเพอร์ตี้ topicDetails.relevantTopicIds[] |
topicDetails.relevantTopicIds[] |
list รายการรหัสหัวข้อที่เกี่ยวข้องกับวิดีโอ เราเลิกใช้งานพร็อพเพอร์ตี้นี้ตั้งแต่วันที่ 10 พฤศจิกายน 2016 ระบบจะรองรับจนถึงวันที่ 10 พฤศจิกายน 2017 สำคัญ: เนื่องจากมีการเลิกใช้งาน Freebase และ Freebase API รหัสหัวข้อจึงเริ่มทำงานต่างจากเดิมตั้งแต่วันที่ 27 กุมภาพันธ์ 2017 ในช่วงเวลาดังกล่าว YouTube เริ่มแสดงรหัสหัวข้อที่ดูแลจัดการชุดเล็กๆ |
topicDetails.topicCategories[] |
list รายการ URL ของ Wikipedia ที่ให้คำอธิบายระดับสูงเกี่ยวกับเนื้อหาของวิดีโอ |
recordingDetails |
object ออบเจ็กต์ recordingDetails จะรวมข้อมูลเกี่ยวกับสถานที่ตั้ง วันที่ และที่อยู่ที่มีการบันทึกวิดีโอ |
recordingDetails.locationDescription |
string เราเลิกใช้งานพร็อพเพอร์ตี้นี้แล้วตั้งแต่วันที่ 1 มิถุนายน 2017 โปรดดูรายละเอียดเพิ่มเติมในประกาศการเลิกใช้งาน ข้อความอธิบายสถานที่ที่มีการบันทึกวิดีโอ |
recordingDetails.location |
object ข้อมูลตำแหน่งทางภูมิศาสตร์ที่เชื่อมโยงกับวิดีโอ โปรดทราบว่าค่าพร็อพเพอร์ตี้ย่อยจะระบุสถานที่ที่เจ้าของวิดีโอต้องการเชื่อมโยงกับวิดีโอ ค่านี้แก้ไขได้ ค้นหาได้ในวิดีโอสาธารณะ และอาจแสดงต่อผู้ใช้สำหรับวิดีโอสาธารณะ |
recordingDetails.location.latitude |
double เราเลิกใช้งานพร็อพเพอร์ตี้นี้ตั้งแต่วันที่ 1 มิถุนายน 2017 โปรดดูรายละเอียดเพิ่มเติมในประกาศการเลิกใช้งาน ละติจูดเป็นองศา |
recordingDetails.location.longitude |
double เราเลิกใช้งานพร็อพเพอร์ตี้นี้แล้วตั้งแต่วันที่ 1 มิถุนายน 2017 โปรดดูรายละเอียดเพิ่มเติมในประกาศการเลิกใช้งาน ลองจิจูดเป็นองศา |
recordingDetails.location.altitude |
double เราเลิกใช้งานพร็อพเพอร์ตี้นี้ตั้งแต่วันที่ 9 กรกฎาคม 2018 โปรดดูรายละเอียดเพิ่มเติมในประกาศการเลิกใช้งาน ความสูงเหนือทรงกลมอ้างอิงเป็นเมตร |
recordingDetails.recordingDate |
datetime วันที่และเวลาที่บันทึกวิดีโอ ค่าที่ระบุอยู่ในรูปแบบ ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ ) |
fileDetails |
object ออบเจ็กต์ fileDetails สรุปข้อมูลเกี่ยวกับไฟล์วิดีโอที่อัปโหลดไปยัง YouTube รวมถึงความละเอียดของไฟล์ ระยะเวลา ตัวแปลงสัญญาณเสียงและวิดีโอ อัตราบิตของสตรีม และอื่นๆ เจ้าของวิดีโอเท่านั้นที่เรียกข้อมูลนี้ได้ระบบจะแสดงผลออบเจ็กต์ fileDetails ก็ต่อเมื่อพร็อพเพอร์ตี้ processingDetails.fileAvailability มีค่าเป็น available เท่านั้น |
fileDetails.fileName |
string ชื่อไฟล์ที่อัปโหลด ช่องนี้จะปรากฏขึ้นไม่ว่าไฟล์วิดีโอหรือไฟล์ประเภทอื่นจะถูกอัปโหลดหรือไม่ |
fileDetails.fileSize |
unsigned long ขนาดของไฟล์ที่อัปโหลดเป็นไบต์ ช่องนี้จะปรากฏขึ้นไม่ว่าจะมีการอัปโหลดไฟล์วิดีโอหรือไฟล์ประเภทอื่น |
fileDetails.fileType |
string ประเภทของไฟล์ที่อัปโหลดตามที่เครื่องมือประมวลผลวิดีโอของ YouTube ตรวจพบ ปัจจุบัน YouTube ประมวลผลเฉพาะไฟล์วิดีโอเท่านั้น แต่ช่องนี้จะปรากฏขึ้นไม่ว่าอัปโหลดไฟล์วิดีโอหรือไฟล์ประเภทอื่น ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
fileDetails.container |
string รูปแบบคอนเทนเนอร์ของไฟล์วิดีโอที่อัปโหลด |
fileDetails.videoStreams[] |
list รายการสตรีมวิดีโอที่อยู่ในไฟล์วิดีโอที่อัปโหลด แต่ละรายการในรายการจะมีข้อมูลเมตาโดยละเอียดเกี่ยวกับสตรีมวิดีโอ |
fileDetails.videoStreams[].widthPixels |
unsigned integer ความกว้างของเนื้อหาวิดีโอที่เข้ารหัสในหน่วยพิกเซล คุณสามารถคำนวณสัดส่วนภาพในการเข้ารหัสของวิดีโอเป็น width_pixels / height_pixels |
fileDetails.videoStreams[].heightPixels |
unsigned integer ความสูงของเนื้อหาวิดีโอที่เข้ารหัสเป็นพิกเซล |
fileDetails.videoStreams[].frameRateFps |
double อัตราเฟรมของสตรีมวิดีโอเป็นเฟรมต่อวินาที |
fileDetails.videoStreams[].aspectRatio |
double สัดส่วนภาพในเนื้อหาวิดีโอของเนื้อหาวิดีโอ ซึ่งระบุสัดส่วนภาพที่วิดีโอควรแสดง |
fileDetails.videoStreams[].codec |
string ตัวแปลงรหัสวิดีโอที่สตรีมใช้ |
fileDetails.videoStreams[].bitrateBps |
unsigned long อัตราบิตของสตรีมวิดีโอเป็นบิตต่อวินาที |
fileDetails.videoStreams[].rotation |
string จำนวนครั้งที่ YouTube ต้องหมุนเนื้อหาต้นฉบับเพื่อแสดงวิดีโออย่างถูกต้อง ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
fileDetails.videoStreams[].vendor |
string ค่าที่ระบุผู้ให้บริการวิดีโอโดยไม่ซ้ำกัน โดยปกติแล้ว ค่าจะเป็นรหัสผู้ให้บริการ 4 ตัว |
fileDetails.audioStreams[] |
list รายการสตรีมเสียงที่อยู่ในไฟล์วิดีโอที่อัปโหลด แต่ละรายการในรายการจะมีข้อมูลเมตาโดยละเอียดเกี่ยวกับสตรีมเสียง |
fileDetails.audioStreams[].channelCount |
unsigned integer จำนวนช่องเสียงของสตรีม |
fileDetails.audioStreams[].codec |
string ตัวแปลงสัญญาณเสียงที่สตรีมใช้ |
fileDetails.audioStreams[].bitrateBps |
unsigned long อัตราบิตของสตรีมเสียงเป็นบิตต่อวินาที |
fileDetails.audioStreams[].vendor |
string ค่าที่ระบุผู้ให้บริการวิดีโอโดยไม่ซ้ำกัน โดยปกติแล้ว ค่าจะเป็นรหัสผู้ให้บริการ 4 ตัว |
fileDetails.durationMs |
unsigned long ความยาวของวิดีโอที่อัปโหลดเป็นมิลลิวินาที |
fileDetails.bitrateBps |
unsigned long อัตราบิตรวม (วิดีโอและเสียง) ของไฟล์วิดีโอที่อัปโหลดเป็นบิตต่อวินาที |
fileDetails.creationTime |
string วันที่และเวลาที่สร้างไฟล์วิดีโอที่อัปโหลด ค่าจะอยู่ในรูปแบบ ISO 8601 ปัจจุบันระบบรองรับเฉพาะรูปแบบ ISO 8601 ต่อไปนี้
|
processingDetails |
object ออบเจ็กต์ processingDetails จะรวมข้อมูลเกี่ยวกับความคืบหน้าของ YouTube ในการประมวลผลไฟล์วิดีโอที่อัปโหลด พร็อพเพอร์ตี้ในออบเจ็กต์จะระบุสถานะการประมวลผลปัจจุบันและเวลาโดยประมาณที่เหลือจนกว่า YouTube จะประมวลผลวิดีโอเสร็จ ส่วนนี้ยังระบุว่าวิดีโอมีข้อมูลหรือเนื้อหาประเภทต่างๆ เช่น รายละเอียดไฟล์หรือภาพปก หรือไม่ออบเจ็กต์ processingProgress ได้รับการออกแบบมาเพื่อใช้โพลเพื่อให้วิดีโอที่อัปโหลดติดตามความคืบหน้าที่ YouTube ดำเนินการประมวลผลไฟล์วิดีโอที่อัปโหลด เจ้าของวิดีโอเท่านั้นที่เรียกข้อมูลนี้ได้ |
processingDetails.processingStatus |
string สถานะการประมวลผลของวิดีโอ ค่านี้บ่งชี้ว่า YouTube ประมวลผลวิดีโอได้หรือไม่ หรือวิดีโอยังอยู่ระหว่างการประมวลผล ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
processingDetails.processingProgress |
object ออบเจ็กต์ processingProgress มีข้อมูลเกี่ยวกับความคืบหน้าที่ YouTube ดำเนินการในการประมวลผลวิดีโอ ค่าเหล่านี้จะเกี่ยวข้องก็ต่อเมื่อสถานะการประมวลผลของวิดีโอเป็น processing |
processingDetails.processingProgress.partsTotal |
unsigned long จำนวนชิ้นส่วนทั้งหมดโดยประมาณที่ต้องประมวลผลสำหรับวิดีโอ ตัวเลขดังกล่าวอาจมีการอัปเดตจากค่าประมาณที่แม่นยํามากขึ้นในขณะที่ YouTube ประมวลผลวิดีโอ |
processingDetails.processingProgress.partsProcessed |
unsigned long จำนวนส่วนของวิดีโอที่ YouTube ประมวลผลแล้ว คุณประมาณเปอร์เซ็นต์ของวิดีโอที่ YouTube ประมวลผลแล้วได้โดยคำนวณจากข้อมูลต่อไปนี้ 100 * parts_processed / parts_total โปรดทราบว่าเนื่องจากจำนวนส่วนที่ประมาณอาจเพิ่มขึ้นโดยไม่สอดคล้องกับจำนวนส่วนที่ประมวลผลแล้ว จึงเป็นไปได้ที่ความคืบหน้าที่คำนวณอาจลดลงเป็นระยะๆ ขณะที่ YouTube ประมวลผลวิดีโอ |
processingDetails.processingProgress.timeLeftMs |
unsigned long ระยะเวลาโดยประมาณในหน่วยมิลลิวินาทีที่ YouTube ต้องประมวลผลวิดีโอให้เสร็จสิ้น |
processingDetails.processingFailureReason |
string สาเหตุที่ YouTube ประมวลผลวิดีโอไม่สำเร็จ พร็อพเพอร์ตี้นี้จะมีค่าก็ต่อเมื่อค่าของพร็อพเพอร์ตี้ processingStatus เป็น failed ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
processingDetails.fileDetailsAvailability |
string ค่านี้จะระบุว่าวิดีโอที่อัปโหลดมีรายละเอียดไฟล์หรือไม่ คุณสามารถเรียกดูรายละเอียดไฟล์ของวิดีโอได้โดยขอส่วน fileDetails ในคำขอ videos.list() |
processingDetails.processingIssuesAvailability |
string ค่านี้ระบุว่าเครื่องมือประมวลผลวิดีโอสร้างคำแนะนำที่อาจช่วยปรับปรุงความสามารถของ YouTube ในการประมวลผลวิดีโอ คำเตือนที่อธิบายปัญหาการประมวลผลวิดีโอ หรือข้อผิดพลาดที่ทำให้เกิดปัญหาการประมวลผลวิดีโอหรือไม่ คุณเรียกดูคําแนะนําเหล่านี้ได้โดยขอส่วน suggestions ในคําขอ videos.list() |
processingDetails.tagSuggestionsAvailability |
string ค่านี้ระบุว่าคำแนะนำคีย์เวิร์ด (แท็ก) พร้อมใช้งานสำหรับวิดีโอหรือไม่ คุณสามารถเพิ่มแท็กลงในข้อมูลเมตาของวิดีโอเพื่อให้ผู้ใช้รายอื่นค้นหาวิดีโอได้ง่ายขึ้น คุณเรียกดูคําแนะนําเหล่านี้ได้โดยขอส่วน suggestions ในคําขอ videos.list() |
processingDetails.editorSuggestionsAvailability |
string ค่านี้จะบ่งบอกว่ามีคำแนะนำการแก้ไขวิดีโอซึ่งอาจช่วยปรับปรุงคุณภาพวิดีโอหรือประสบการณ์การเล่นวิดีโอ หรือไม่ คุณเรียกดูคําแนะนําเหล่านี้ได้โดยขอส่วน suggestions ในคําขอ videos.list() |
processingDetails.thumbnailsAvailability |
string ค่านี้ใช้เพื่อระบุว่ามีการสร้างภาพปกสำหรับวิดีโอหรือไม่ |
suggestions |
object ออบเจ็กต์ suggestions สรุปคำแนะนำซึ่งระบุโอกาสในการปรับปรุงคุณภาพหรือข้อมูลเมตาของวิดีโอที่อัปโหลด เจ้าของวิดีโอเท่านั้นที่เรียกข้อมูลนี้ได้ ระบบจะแสดงผลออบเจ็กต์ suggestions เฉพาะในกรณีที่พร็อพเพอร์ตี้ processingDetails.tagSuggestionsAvailability หรือพร็อพเพอร์ตี้ processingDetails.editorSuggestionsAvailability มีค่าเป็น available |
suggestions.processingErrors[] |
list รายการข้อผิดพลาดที่ทําให้ YouTube ประมวลผลวิดีโอที่อัปโหลดไม่สําเร็จ ข้อผิดพลาดเหล่านี้บ่งชี้ว่าไม่ว่าสถานะการประมวลผลปัจจุบันของวิดีโอจะเป็นอย่างไร สถานะดังกล่าวก็เกือบจะแน่นอนที่จะเป็น failed ในท้ายที่สุดค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
suggestions.processingWarnings[] |
list รายการสาเหตุที่ YouTube อาจพบปัญหาในการแปลงวิดีโอที่อัปโหลด หรืออาจส่งผลให้การแปลงผิดพลาด คำเตือนเหล่านี้สร้างขึ้นก่อนที่ YouTube จะประมวลผลไฟล์วิดีโอที่อัปโหลด นอกจากนี้ สถานะยังระบุปัญหาที่ไม่ได้บ่งชี้ว่าการประมวลผลวิดีโอจะล้มเหลวเสมอไป แต่อาจทำให้เกิดปัญหา เช่น ปัญหาการซิงค์ สัญญาณรบกวนวิดีโอ หรือไม่มีแทร็กเสียง ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
suggestions.processingHints[] |
list รายการคำแนะนำที่อาจช่วยปรับปรุงความสามารถของ YouTube ในการจัดการวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
suggestions.tagSuggestions[] |
list รายการแท็กคีย์เวิร์ดที่เพิ่มลงในข้อมูลเมตาของวิดีโอได้เพื่อเพิ่มโอกาสที่ผู้ใช้จะพบวิดีโอของคุณเมื่อค้นหาหรือเรียกดูบน YouTube |
suggestions.tagSuggestions[].tag |
string แท็กคีย์เวิร์ดที่แนะนำสำหรับวิดีโอ |
suggestions.tagSuggestions[].categoryRestricts[] |
list ชุดหมวดหมู่วิดีโอที่แท็กมีความเกี่ยวข้อง คุณสามารถใช้ข้อมูลนี้เพื่อแสดงคำแนะนำแท็กที่เหมาะสมตามหมวดหมู่วิดีโอที่ผู้อัปโหลดวิดีโอเชื่อมโยงกับวิดีโอ โดยค่าเริ่มต้น คําแนะนําแท็กจะเกี่ยวข้องกับทุกหมวดหมู่หากไม่มีการกําหนดข้อจํากัดสําหรับคีย์เวิร์ด |
suggestions.editorSuggestions[] |
list รายการการดำเนินการแก้ไขวิดีโอที่อาจปรับปรุงคุณภาพวิดีโอหรือประสบการณ์การเล่นวิดีโอที่อัปโหลด ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
liveStreamingDetails |
object ออบเจ็กต์ liveStreamingDetails มีข้อมูลเมตาเกี่ยวกับการออกอากาศวิดีโอสด ออบเจ็กต์จะปรากฏในทรัพยากร video เฉพาะในกรณีที่วิดีโอเป็นการถ่ายทอดสดที่กำลังจะเผยแพร่ กำลังเผยแพร่ หรือสิ้นสุดไปแล้ว |
liveStreamingDetails.actualStartTime |
datetime เวลาที่การออกอากาศเริ่มต้นจริง ค่าที่ระบุอยู่ในรูปแบบ ISO 8601 ค่านี้จะใช้ไม่ได้จนกว่าการออกอากาศจะเริ่มขึ้น |
liveStreamingDetails.actualEndTime |
datetime เวลาที่ออกอากาศจริงสิ้นสุดลง ค่าที่ระบุอยู่ในรูปแบบ ISO 8601 ค่านี้จะใช้ไม่ได้จนกว่าการออกอากาศจะสิ้นสุด |
liveStreamingDetails.scheduledStartTime |
datetime เวลาที่กำหนดให้เริ่มออกอากาศ ค่าที่ระบุอยู่ในรูปแบบ ISO 8601 |
liveStreamingDetails.scheduledEndTime |
datetime เวลาที่กำหนดให้การออกอากาศจบ ค่าที่ระบุอยู่ในรูปแบบ ISO 8601 หากค่าเป็นค่าว่างหรือไม่มีพร็อพเพอร์ตี้ ระบบจะตั้งเวลาออกอากาศต่อไปอย่างไม่มีกำหนด |
liveStreamingDetails.concurrentViewers |
unsigned long จำนวนผู้ชมที่ดูการออกอากาศอยู่ในปัจจุบัน พร็อพเพอร์ตี้และค่าจะปรากฏหากการออกอากาศมีผู้ชมปัจจุบัน และเจ้าของการออกอากาศไม่ได้ซ่อนยอดดูของวิดีโอ โปรดทราบว่า YouTube จะหยุดติดตามจำนวนผู้ชมที่ดูพร้อมกันสำหรับการออกอากาศเมื่อการออกอากาศสิ้นสุดลง ดังนั้นพร็อพเพอร์ตี้นี้จะไม่ระบุจํานวนผู้ชมที่ดูวิดีโอที่เก็บถาวรของการออกอากาศสดที่จบไปแล้ว จำนวนผู้ชมที่ดูพร้อมกันที่ YouTube Data API แสดงอาจแตกต่างจากจำนวนผู้ชมที่ดูพร้อมกันที่ประมวลผลแล้วและกรองสแปมออกแล้วซึ่งดูได้จาก YouTube Analytics ดูข้อมูลเพิ่มเติมเกี่ยวกับเมตริกสตรีมมิงแบบสดได้ในศูนย์ช่วยเหลือของ YouTube
|
liveStreamingDetails.activeLiveChatId |
string รหัสของแชทสดที่ใช้งานอยู่ซึ่งแนบอยู่กับวิดีโอนี้ ช่องนี้จะกรอกข้อมูลก็ต่อเมื่อวิดีโอเป็นการถ่ายทอดสดที่มีแชทสดเท่านั้น เมื่อออกอากาศเสร็จสมบูรณ์แล้ว ระบบจะนำช่องนี้ออกและปิดแชทสด สำหรับการออกอากาศอย่างต่อเนื่อง รหัสแชทสดจะไม่เชื่อมโยงกับวิดีโอนี้อีกต่อไป แต่จะเชื่อมโยงกับวิดีโอใหม่ที่แสดงในหน้าถาวร |
localizations |
object ออบเจ็กต์ localizations มีคำแปลข้อมูลเมตาของวิดีโอ |
localizations.(key) |
object ภาษาของข้อความที่แปลแล้วซึ่งเชื่อมโยงกับค่าคีย์ ค่าคือสตริงที่มีรหัสภาษา BCP-47 |
localizations.(key).title |
string ชื่อวิดีโอที่แปลแล้ว |
localizations.(key).description |
string คำอธิบายวิดีโอที่แปลแล้ว |