วิดีโอทั้งหมดที่อัปโหลดผ่านปลายทาง
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à ของอิตาลีต่อ 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 TV - Canadian TV Classification System การจัดประเภทวิดีโอจากคณะกรรมการวิทยุ-โทรทัศน์และโทรคมนาคมของแคนาดา (Canadian Radio-Television and Telecommunications Commission หรือ CRTC) สำหรับการออกอากาศภาษาอังกฤษในแคนาดา ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ของ Canadian Broadcast Standards Council ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.catvfrRating |
string การจัดประเภทวิดีโอจากคณะกรรมการวิทยุโทรทัศน์และโทรคมนาคมของแคนาดา (Canadian Radio-Television and Telecommunications Commission หรือ 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 '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องค์ประกอบ Cinematographique ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.csaRating |
string การจัดประเภทวิดีโอจาก Conseil supérieur de l?audiovisuel ของฝรั่งเศสซึ่งให้คะแนนเนื้อหาออกอากาศ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้ ได้แก่
|
contentDetails.contentRating.cscfRating |
string การจัดประเภทวิดีโอจาก Commission de surveillance de laองค์ประกอบ des Films (CSCF) ของลักเซมเบิร์ก (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 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 - Spain) ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.ifcoRating |
string การจัดประเภทของหน่วยงานการจัดประเภทภาพยนตร์ของไอร์แลนด์ (IFCO - Ireland) ของวิดีโอ ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ IFCO ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.ilfilmRating |
string การจัดประเภทของวิดีโอในอิสราเอล ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.incaaRating |
string การจัดประเภท INCAA (Instituto Nacional de Cine y Artes Audiovisuales - อาร์เจนตินา) ของวิดีโอ ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.kfcbRating |
string การจัดประเภทวิดีโอจากคณะกรรมการการจัดประเภทภาพยนตร์ของเคนยา ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.kijkwijzerRating |
string voor de Classificatie van Audiovisuele Media (เนเธอร์แลนด์) ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.kmrbRating |
string การจัดประเภทของ Korea Media Rating Board (영การนำส่ง물물ด้านขวาบน호) ของวิดีโอ KMRB ให้คะแนนวิดีโอในเกาหลีใต้ ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.lsfRating |
string การจัดประเภทวิดีโอจาก Lembaga Sensor Film ของอินโดนีเซีย ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.mccaaRating |
string การจัดประเภทวิดีโอจากคณะกรรมการการจัดประเภทภาพยนตร์ของมอลตา ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.mccypRating |
string การจัดประเภทวิดีโอจาก Danish Film Institutes (Det Danske Filminstitut) Media Council for Children and Young People ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.mcstRating |
string ระบบการจัดประเภทของวิดีโอสำหรับเวียดนาม - MCST ค่าที่ถูกต้องสำหรับที่พักนี้คือ
|
contentDetails.contentRating.mdaRating |
string การจัดประเภทวิดีโอจากหน่วยงานพัฒนาสื่อ (MDA) ของสิงคโปร์ โดยเฉพาะ Board of Film Censors (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 การจัดประเภทวิดีโอจาก National Film and Video Censors Board ของไนจีเรีย ค่าที่ถูกต้องสำหรับที่พักแห่งนี้ ได้แก่
|
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 สถานะความเป็นบิดามารดา (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 โปรดทราบข้อมูลเพิ่มเติมสองข้อต่อไปนี้เกี่ยวกับการทำงานของคุณสมบัตินี้:
|
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 จะหยุดติดตามจำนวนผู้ชมที่ดูพร้อมกัน ของการออกอากาศเมื่อการออกอากาศสิ้นสุดลง ดังนั้น พร็อพเพอร์ตี้นี้จะระบุจำนวนผู้ชมที่ดูวิดีโอที่เก็บถาวรของการถ่ายทอดสดที่จบไปแล้ว การนับจำนวนผู้ชมที่ดูพร้อมกันที่ API ข้อมูลของ YouTube แสดงผลอาจแตกต่างจากจำนวนผู้ชมที่ดูพร้อมกันที่ผ่านการประมวลผลและกำจัดสแปมแล้วที่มีให้ใน YouTube Analytics ดูข้อมูลเพิ่มเติมเกี่ยวกับเมตริกสตรีมมิงแบบสดได้ในศูนย์ช่วยเหลือของ YouTube
|
liveStreamingDetails.activeLiveChatId |
string รหัสของแชทสดที่ใช้งานอยู่ในปัจจุบันซึ่งแนบมากับวิดีโอนี้ ช่องนี้จะเติมก็ต่อเมื่อวิดีโอเป็นการถ่ายทอดสดที่กำลังเผยแพร่และมีแชทสดอยู่เท่านั้น เมื่อการออกอากาศเปลี่ยนไปยังช่องนี้เสร็จสมบูรณ์ ระบบจะนำการถ่ายทอดสดออกและแชทสดจะปิดลง สำหรับการออกอากาศอย่างต่อเนื่อง รหัสแชทสดจะไม่เชื่อมโยงกับวิดีโอนี้อีกต่อไป แต่เชื่อมโยงกับวิดีโอใหม่ที่แสดงในหน้าถาวร |
localizations |
object ออบเจ็กต์ localizations มีคำแปลข้อมูลเมตาของวิดีโอ |
localizations.(key) |
object ภาษาของข้อความที่แปลแล้วที่เชื่อมโยงกับคีย์-ค่า ค่าเป็นสตริงที่มีรหัสภาษา BCP-47 |
localizations.(key).title |
string ชื่อวิดีโอที่แปล |
localizations.(key).description |
string คำอธิบายวิดีโอที่แปลแล้ว |