วิดีโอทั้งหมดที่อัปโหลดผ่านปลายทาง
videos.insert
จากโปรเจ็กต์ API ที่ไม่ได้รับการยืนยันซึ่งสร้างขึ้นหลังวันที่ 28 กรกฎาคม 2020 จะถูกจำกัดอยู่ในโหมดดูแบบส่วนตัว หากต้องการยกเลิกการจำกัดนี้ โปรเจ็กต์ API แต่ละโปรเจ็กต์ต้องได้รับการตรวจสอบเพื่อยืนยันการปฏิบัติตามข้อกำหนดในการให้บริการ โปรดดูรายละเอียดเพิ่มเติมที่ประวัติการแก้ไข API
ทรัพยากร video
แสดงถึงวิดีโอ YouTube
วิธีการ
API รองรับเมธอดต่อไปนี้สำหรับทรัพยากร videos
รายการ
- getRating
- เรียกข้อมูลการจัดประเภทที่ผู้ใช้ที่ได้รับอนุญาตให้ไปยังรายการวิดีโอที่ระบุ ลองใช้เลย
- list
- แสดงรายการวิดีโอที่ตรงกับพารามิเตอร์คำขอ API ลองใช้เลย
- แทรก
- อัปโหลดวิดีโอไปยัง YouTube และตั้งค่าข้อมูลเมตาของวิดีโอ (ไม่บังคับ)
- อัปเดต
- อัปเดตข้อมูลเมตาของวิดีโอ ลองใช้เลย
- ลบ
- ลบวิดีโอ 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 }, "statistics": { "viewCount": string, "likeCount": string, "dislikeCount": string, "favoriteCount": string, "commentCount": string }, "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 ระบุว่าวิดีโอเป็นการถ่ายทอดสดที่กำลังจะเผยแพร่หรือดำเนินอยู่ หรือเป็น "ไม่มี" หากวิดีโอไม่ใช่การถ่ายทอดสดที่กำลังจะเผยแพร่/ที่ดำเนินอยู่ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
|
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 การจัดประเภทของ British Board of Film Classification (BBFC) ของวิดีโอ ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.bfvcRating |
string การจัดประเภทวิดีโอจากคณะกรรมการเซ็นเซอร์ภาพยนตร์และวิดีโอแห่งประเทศไทย ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.bmukkRating |
string การจัดประเภทวิดีโอจากคณะกรรมการการจัดประเภทสื่อของออสเตรีย (Bundesministerium für Unterricht, Kunst und Kultur) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
|
contentDetails.contentRating.catvRating |
string ระบบการจัดประเภทสำหรับแคนาดาทีวี - ระบบการจัดประเภททีวีของแคนาดา การจัดประเภทวิดีโอจากคณะกรรมการวิทยุโทรทัศน์และโทรคมนาคมของแคนาดา (Canadian Radio-Television and Telecommunications Commission หรือ CRTC) สำหรับการออกอากาศเป็นภาษาอังกฤษในแคนาดา ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ของ Canadian Broadcast Standards Council ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.catvfrRating |
string การจัดประเภทวิดีโอจากคณะกรรมาธิการด้านวิทยุและโทรทัศน์ (CRTC) ของแคนาดาสำหรับการออกอากาศภาษาฝรั่งเศสแคนาดา ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ของ Canadian Broadcast Standards Council ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.cbfcRating |
string การจัดประเภทของ Central Board of Film Certification (CBFC - India) ของวิดีโอ ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.cccRating |
string การให้คะแนน Consejo de Calificación Cinematográfica (ชิลี) ของวิดีโอ ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.cceRating |
string การจัดประเภทวิดีโอจาก Comissão de Classificação de Espect imagesculos ของโปรตุเกส ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
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 engagement Cinematographique ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.csaRating |
string การจัดประเภทวิดีโอจาก Conseil supérieur de l?audiovisuel ของฝรั่งเศส ซึ่งจะให้คะแนนเนื้อหาที่ออกอากาศ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
|
contentDetails.contentRating.cscfRating |
string การจัดประเภทของวิดีโอจาก Commission de surveillance de laคำหลัก des Films (CSCF) ของลักเซมเบิร์ก: ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.czfilmRating |
string การจัดประเภทของวิดีโอในสาธารณรัฐเช็ก ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.djctqRating |
string การจัดประเภทของวิดีโอ Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brazil) ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
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 Nation 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 - Spain) ของวิดีโอ ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.ifcoRating |
string การจัดประเภทของสำนักงานการจัดประเภทภาพยนตร์ไอร์แลนด์ (IFCO - ไอร์แลนด์) ของวิดีโอ ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ IFCO ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.ilfilmRating |
string การจัดประเภทของวิดีโอในอิสราเอล ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.incaaRating |
string การจัดประเภท INCAA ของวิดีโอ (Instituto Nacional de Cine y Artes Audiovisuales - Argentina) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
|
contentDetails.contentRating.kfcbRating |
string การจัดประเภทวิดีโอจากคณะกรรมการการจัดประเภทภาพยนตร์ของเคนยา ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.kijkwijzerRating |
string voor de Classificatie van Audiovisuele Media (เนเธอร์แลนด์) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.kmrbRating |
string การจัดประเภทของคณะกรรมการจัดระดับความเหมาะสมเนื้อหาสื่อของเกาหลี (영알물ؼ사型號) ของวิดีโอ KMRB ให้คะแนนวิดีโอในเกาหลีใต้ ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.lsfRating |
string การจัดประเภทวิดีโอจาก Lembaga Sensor Film ของอินโดนีเซีย ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.mccaaRating |
string การจัดประเภทวิดีโอจากคณะกรรมการการจัดประเภทภาพยนตร์ของมอลตา ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.mccypRating |
string การจัดประเภทวิดีโอจากสถาบันภาพยนตร์แห่งเดนมาร์ก (Det Danske Filminstitut) Media Council for Children and Young People ค่าที่ถูกต้องสำหรับที่พักดังกล่าวมีดังนี้
|
contentDetails.contentRating.mcstRating |
string ระบบการจัดประเภทของวิดีโอสำหรับเวียดนาม - MCST ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.mdaRating |
string การจัดประเภทวิดีโอจากหน่วยงานพัฒนาสื่อ (MDA) ของสิงคโปร์ กล่าวอย่างเจาะจงคือ คณะกรรมการกำกับภาพยนตร์ (BFC) ของสิงคโปร์ ค่าที่ถูกต้องสำหรับที่พักดังกล่าวมีดังนี้
|
contentDetails.contentRating.medietilsynetRating |
string การจัดประเภทของวิดีโอจาก Medietilsynet ซึ่งเป็นหน่วยงานสื่อของนอร์เวย์ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.mekuRating |
string การจัดประเภทวิดีโอจาก Kansallinen Audiovisuaalinen Instituutti (National Audiovisual Institute) ของฟินแลนด์ ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
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 (National Film Centre of Latvia) ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
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 (Sweden's National Media Council) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
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 ดังกล่าวเท่านั้น |
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 จำนวนความคิดเห็นในวิดีโอ |
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 คำอธิบายวิดีโอที่แปลแล้ว |