วิดีโอทั้งหมดที่อัปโหลดผ่านปลายทาง
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 |
etagEtag ของทรัพยากรนี้ |
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 |
stringURL ของรูปภาพ |
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การจัดประเภทของคณะกรรมการการจัดประเภทของออสเตรเลีย (ACB) หรือหน่วยงานกำกับดูแลการสื่อสารและสื่อของออสเตรเลีย (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ระบบการจัดประเภทสำหรับทีวีของแคนาดา - ระบบการจัดประเภททีวีของแคนาดา การจัดประเภทวิดีโอจากคณะกรรมการกิจการกระจายเสียง กิจการโทรทัศน์ และกิจการโทรคมนาคมของแคนาดา (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 |
stringvoor 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การจัดประเภทวิดีโอจาก Media Council for Children and Young People ของ Danish Film Institute (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การจัดประเภทของ National Film Registry of the Russian Federation (MKRF - Russia) ของวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.skfilmRating |
stringการจัดประเภทของวิดีโอในสโลวาเกีย ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.smaisRating |
stringการจัดประเภทของวิดีโอในไอซ์แลนด์ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.smsaRating |
stringการจัดประเภทของวิดีโอจาก Statens medieråd (คณะกรรมการสื่อแห่งชาติของสวีเดน) ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้คือ
|
contentDetails.contentRating.tvpgRating |
stringการจัดประเภทตามหลักเกณฑ์ด้านผู้ปกครองสำหรับทีวี (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จำนวนครั้งที่มีการดูวิดีโอ ตั้งแต่วันที่ 31 มีนาคม 2025 เป็นต้นไป สำหรับ Shorts ผลลัพธ์ของ viewCount จะเป็นจำนวนครั้งที่ Shorts เริ่มเล่นหรือเล่นซ้ำ โดยไม่มีการกำหนดเวลาในการรับชมขั้นต่ำ |
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คำอธิบายวิดีโอที่แปลแล้ว |