videos.insert
จากโปรเจ็กต์ API ที่ไม่ได้รับการยืนยันซึ่งสร้างขึ้นหลังจากวันที่ 28 กรกฎาคม 2020 จะถูกจำกัดให้ดูได้ในโหมดส่วนตัว
หากต้องการยกเลิกข้อจำกัดนี้ โปรเจ็กต์ API แต่ละโปรเจ็กต์ต้องผ่านการตรวจสอบเพื่อยืนยัน
การปฏิบัติตามข้อกำหนดในการให้บริการ โปรดดูรายละเอียดเพิ่มเติมในประวัติการแก้ไข API
video ทรัพยากรแสดงถึงวิดีโอ YouTube
เมธอด
API รองรับวิธีการต่อไปนี้สำหรับทรัพยากร videos
- getRating
- ดึงข้อมูลคะแนนที่ผู้ใช้ที่ได้รับอนุญาตให้ไว้กับรายการวิดีโอที่ระบุ ลองใช้เลย
- list
- แสดงรายการวิดีโอที่ตรงกับพารามิเตอร์คำขอ API ลองใช้เลย
- batchGetStats
- ดึงข้อมูลรายการสถิติของวิดีโอที่ตรงกับพารามิเตอร์คำขอ 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,
"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ระบุว่าวิดีโอเป็นการถ่ายทอดสดที่กำลังจะเผยแพร่/กำลังเผยแพร่หรือไม่ ค่าจะเป็น ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
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การจัดประเภทของ 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ระบบการจัดประเภทสำหรับทีวีของแคนาดา - ระบบการจัดประเภททีวีของแคนาดา การจัดประเภทวิดีโอจากคณะกรรมการกำกับดูแลวิทยุ โทรทัศน์ และโทรคมนาคมของแคนาดา (CRTC) สำหรับการออกอากาศภาษาอังกฤษในแคนาดา ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ของCanadian Broadcast Standards Council ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.catvfrRating |
stringการจัดประเภทวิดีโอจากคณะกรรมการกำกับดูแลวิทยุ โทรทัศน์ และโทรคมนาคมของแคนาดา (CRTC) สำหรับการออกอากาศภาษาฝรั่งเศสในแคนาดา ดูข้อมูลเพิ่มเติมได้ที่เว็บไซต์ของสภามาตรฐานการออกอากาศของแคนาดา ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
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การจัดประเภทของวิดีโอจาก Film and Publication Board ของแอฟริกาใต้ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
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 - Argentina) ของวิดีโอ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.kfcbRating |
stringการจัดประเภทของวิดีโอจากคณะกรรมการจัดประเภทภาพยนตร์ของเคนยา ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
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การจัดประเภทวิดีโอจากสภากำกับดูแลสื่อสำหรับเด็กและเยาวชนของสถาบันภาพยนตร์เดนมาร์ก (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การจัดประเภทของสำนักงานการจัดประเภทภาพยนตร์และวรรณกรรม (OFLC - นิวซีแลนด์) ของวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.pefilmRating |
stringการจัดประเภทของวิดีโอในเปรู ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.resorteviolenciaRating |
stringการจัดประเภทของวิดีโอในเวเนซุเอลา ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.rtcRating |
stringการจัดประเภทของวิดีโอจาก General Directorate of Radio, Television and Cinematography (เม็กซิโก) ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.rteRating |
stringการจัดประเภทของวิดีโอจาก Raidió Teilifís Éireann ของไอร์แลนด์ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.russiaRating |
stringการจัดประเภทของ National Film Registry of the Russian Federation (MKRF - รัสเซีย) ของวิดีโอ ค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.skfilmRating |
stringการจัดประเภทของวิดีโอในสโลวาเกีย ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้ ได้แก่
|
contentDetails.contentRating.smaisRating |
stringการจัดประเภทของวิดีโอในไอซ์แลนด์ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.smsaRating |
stringการจัดประเภทวิดีโอจาก Statens medieråd (สภาสื่อแห่งชาติของสวีเดน) ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.tvpgRating |
stringการจัดประเภทตาม TV Parental Guidelines (TVPG) ของวิดีโอ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.contentRating.ytRating |
stringการจัดประเภทที่ YouTube ใช้เพื่อระบุเนื้อหาที่จำกัดอายุผู้ชม ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.projection |
stringระบุรูปแบบการฉายวิดีโอ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
contentDetails.hasCustomThumbnail |
booleanระบุว่าผู้อัปโหลดวิดีโอได้ระบุภาพปกวิดีโอที่ทำเองสำหรับวิดีโอหรือไม่ มีเพียงผู้อัปโหลดวิดีโอเท่านั้นที่จะเห็นพร็อพเพอร์ตี้นี้ |
status |
objectออบเจ็กต์ status มีข้อมูลเกี่ยวกับการอัปโหลด การประมวลผล และสถานะความเป็นส่วนตัวของวิดีโอ |
status.uploadStatus |
stringสถานะของวิดีโอที่อัปโหลด ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
status.failureReason |
stringค่านี้อธิบายสาเหตุที่อัปโหลดวิดีโอไม่สำเร็จ พร็อพเพอร์ตี้นี้จะปรากฏก็ต่อเมื่อพร็อพเพอร์ตี้ uploadStatus ระบุว่าการอัปโหลดล้มเหลวค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
status.rejectionReason |
stringค่านี้อธิบายเหตุผลที่ YouTube ปฏิเสธวิดีโอที่อัปโหลด พร็อพเพอร์ตี้นี้จะแสดงก็ต่อเมื่อพร็อพเพอร์ตี้ uploadStatus ระบุว่าการอัปโหลดถูกปฏิเสธค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
status.privacyStatus |
stringสถานะความเป็นส่วนตัวของวิดีโอ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้มีดังนี้
|
status.publishAt |
datetimeวันที่และเวลาที่กำหนดเวลาเผยแพร่วิดีโอ โดยจะตั้งค่าได้ก็ต่อเมื่อสถานะความเป็นส่วนตัวของวิดีโอเป็นแบบส่วนตัวเท่านั้น ค่าจะระบุในรูปแบบ ISO 8601 โปรดทราบประเด็นเพิ่มเติม 2 ข้อต่อไปนี้เกี่ยวกับลักษณะการทำงานของพร็อพเพอร์ตี้นี้
|
status.license |
stringใบอนุญาตของวิดีโอ ค่าที่ใช้ได้สำหรับพร็อพเพอร์ตี้นี้ ได้แก่
|
status.embeddable |
booleanค่านี้จะระบุว่าฝังวิดีโอในเว็บไซต์อื่นได้หรือไม่ |
status.publicStatsViewable |
booleanค่านี้ใช้เพื่อระบุว่าสถิติของวิดีโอแบบขยายในหน้าดูวิดีโอจะปรากฏต่อสาธารณะหรือไม่ โดยค่าเริ่มต้น สถิติเหล่านั้นจะปรากฏ และสถิติ เช่น จำนวนการดูและการให้คะแนนของวิดีโอจะยังคงปรากฏต่อสาธารณะแม้ว่าจะตั้งค่าพร็อพเพอร์ตี้นี้เป็น false ก็ตาม |
status.madeForKids |
booleanค่านี้จะระบุว่าวิดีโอได้รับการกำหนดให้เป็นเนื้อหาที่มุ่งเป้าไปที่เด็กหรือไม่ และมี สถานะ "สร้างมาเพื่อเด็ก" ปัจจุบันของวิดีโอ เช่น ระบบอาจกำหนดสถานะ โดยอิงตามค่าของพร็อพเพอร์ตี้ selfDeclaredMadeForKids ดูข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดผู้ชมสำหรับช่อง วิดีโอ หรือการออกอากาศได้ที่
ศูนย์ช่วยเหลือของ YouTube
|
status.selfDeclaredMadeForKids |
booleanในคำขอ videos.insert หรือ
videos.update พร็อพเพอร์ตี้นี้
ช่วยให้เจ้าของช่องระบุวิดีโอว่ามีเด็กเป็นกลุ่มเป้าหมายได้ ในคำขอ videos.list ค่าพร็อพเพอร์ตี้จะแสดงก็ต่อเมื่อเจ้าของช่องอนุญาตคำขอ API เท่านั้น |
status.containsSyntheticMedia |
booleanในคำขอ videos.insertหรือ
videos.update พร็อพเพอร์ตี้นี้
ช่วยให้เจ้าของช่องเปิดเผยได้ว่าวิดีโอมีเนื้อหาดัดแปลงหรือ
สังเคราะห์ (A/S) ที่ดูสมจริง ดูข้อมูลเพิ่มเติมเกี่ยวกับ
นโยบายของ
YouTube ที่เกี่ยวข้องกับเนื้อหา A/Sตัวอย่างเนื้อหา 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คำอธิบายวิดีโอที่แปลแล้ว |