videos.insert
dari project API yang tidak terverifikasi yang dibuat setelah 28 Juli 2020 akan dibatasi ke mode
penayangan pribadi. Untuk mencabut batasan ini, setiap project API harus
menjalani audit untuk memverifikasi
kepatuhan terhadap Persyaratan
Layanan. Lihat Histori Revisi API untuk mengetahui detail selengkapnya.
Resource video mewakili video YouTube.
Metode
API ini mendukung metode berikut untuk resource videos:
- getRating
- Mengambil rating yang diberikan pengguna yang berwenang ke daftar video tertentu. Coba sekarang.
- list
- Menampilkan daftar video yang cocok dengan parameter permintaan API. Coba sekarang.
- batchGetStats
- Mengambil daftar statistik video yang cocok dengan parameter permintaan API. Coba sekarang.
- insert
- Mengupload video ke YouTube dan secara opsional menyetel metadata video.
- update
- Memperbarui metadata video. Coba sekarang.
- hapus
- Menghapus video YouTube. Coba sekarang.
- rate
- Menambahkan rating suka atau tidak suka ke video atau menghapus rating dari video. Coba sekarang.
- reportAbuse
- Laporkan video yang berisi konten yang melanggar. Coba sekarang.
Representasi resource
Struktur JSON berikut menunjukkan format resource 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
}
}
}Properti
Tabel berikut menentukan properti yang muncul di resource ini:
| Properti | |
|---|---|
kind |
stringMengidentifikasi jenis resource API. Nilainya adalah youtube#video. |
etag |
etagETag resource ini. |
id |
stringID yang digunakan YouTube untuk mengidentifikasi video secara unik. |
snippet |
objectObjek snippet berisi detail dasar tentang video, seperti judul, deskripsi, dan kategorinya. |
snippet.publishedAt |
datetimeTanggal dan waktu video dipublikasikan. Perhatikan bahwa waktu ini mungkin berbeda dengan waktu video diupload. Misalnya, jika video diupload sebagai video pribadi, lalu diubah menjadi publik di lain waktu, properti ini akan menentukan waktu video tersebut diubah menjadi publik. Ada beberapa kasus khusus:
|
snippet.channelId |
stringID yang digunakan YouTube untuk mengidentifikasi secara unik channel tempat video diupload. |
snippet.title |
stringJudul video. Nilai properti memiliki panjang maksimum 100 karakter dan dapat berisi semua karakter UTF-8 yang valid, kecuali < dan >. Anda harus menetapkan nilai untuk properti ini jika Anda memanggil metode videos.update dan memperbarui bagian snippet dari resource video. |
snippet.description |
stringDeskripsi video. Nilai properti memiliki panjang maksimum 5.000 byte dan dapat berisi semua karakter UTF-8 yang valid kecuali < dan >. |
snippet.thumbnails |
objectPeta gambar thumbnail yang terkait dengan video. Untuk setiap objek dalam peta, kuncinya adalah nama gambar thumbnail, dan nilainya adalah objek yang berisi informasi lain tentang thumbnail. |
snippet.thumbnails.(key) |
objectNilai kunci yang valid adalah:
|
snippet.thumbnails.(key).url |
stringURL gambar. |
snippet.thumbnails.(key).width |
unsigned integerLebar gambar. |
snippet.thumbnails.(key).height |
unsigned integerTinggi gambar. |
snippet.channelTitle |
stringJudul channel yang memiliki video tersebut. |
snippet.tags[] |
listDaftar tag kata kunci yang terkait dengan video. Tag dapat berisi spasi. Nilai properti memiliki panjang maksimum 500 karakter. Perhatikan aturan berikut terkait cara penghitungan batas karakter:
|
snippet.categoryId |
stringKategori video YouTube yang terkait dengan video. Anda harus menetapkan nilai untuk properti ini jika memanggil metode videos.update dan memperbarui bagian snippet dari resource video. |
snippet.liveBroadcastContent |
stringMenunjukkan apakah video adalah siaran live streaming mendatang/aktif. Nilainya adalah Nilai yang valid untuk properti ini adalah:
|
snippet.defaultLanguage |
stringBahasa teks dalam properti snippet.title dan snippet.description resource video. |
snippet.localized |
objectObjek snippet.localized berisi judul dan deskripsi yang dilokalkan untuk video atau judul dalam bahasa default untuk metadata video.
localizations untuk menambahkan, memperbarui, atau menghapus judul yang dilokalkan. |
snippet.localized.title |
stringJudul video yang dilokalkan. |
snippet.localized.description |
stringDeskripsi video yang dilokalkan. |
snippet.defaultAudioLanguage |
stringProperti default_audio_language menentukan bahasa yang digunakan dalam trek audio default video. |
contentDetails |
objectObjek contentDetails berisi informasi tentang konten video, termasuk durasi video dan indikasi apakah teks tersedia untuk video tersebut. |
contentDetails.duration |
stringDurasi video. Nilai properti adalah durasi ISO 8601. Misalnya, untuk video yang berdurasi minimal satu menit dan kurang dari satu jam, durasinya dalam format PT#M#S, dengan huruf PT menunjukkan bahwa nilai tersebut menentukan jangka waktu, dan huruf M dan S masing-masing merujuk pada durasi dalam menit dan detik. Karakter # sebelum huruf M dan S adalah bilangan bulat yang menentukan durasi video dalam menit (atau detik). Misalnya, nilai PT15M33S menunjukkan bahwa durasi video adalah 15 menit 33 detik.Jika video berdurasi minimal satu jam, durasinya dalam format PT#H#M#S, dengan # sebelum huruf H menentukan durasi video dalam jam dan semua detail lainnya sama seperti yang dijelaskan di atas. Jika durasi video minimal satu hari, huruf P dan T akan dipisahkan, dan format nilainya adalah P#DT#H#M#S. Lihat spesifikasi ISO 8601 untuk mengetahui detail selengkapnya. |
contentDetails.dimension |
stringMenunjukkan apakah video tersedia dalam 3D atau 2D. |
contentDetails.definition |
stringMenunjukkan apakah video tersedia dalam definisi tinggi ( HD) atau hanya dalam definisi standar.Nilai yang valid untuk properti ini adalah:
|
contentDetails.caption |
stringMenunjukkan apakah teks tersedia untuk video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.licensedContent |
booleanMenunjukkan apakah video tersebut menampilkan konten berlisensi, yang berarti bahwa konten tersebut diupload ke channel yang ditautkan ke partner konten YouTube, lalu diklaim oleh partner tersebut. |
contentDetails.regionRestriction |
objectObjek regionRestriction berisi informasi tentang negara tempat video dapat (atau tidak dapat) ditonton. Objek akan berisi properti contentDetails.regionRestriction.allowed atau properti contentDetails.regionRestriction.blocked. |
contentDetails.regionRestriction.allowed[] |
listDaftar kode wilayah yang mengidentifikasi negara tempat video dapat ditonton. Jika properti ini ada dan suatu negara tidak tercantum dalam nilainya, video tersebut akan diblokir agar tidak muncul di negara tersebut. Jika properti ini ada dan berisi daftar kosong, video akan diblokir di semua negara. |
contentDetails.regionRestriction.blocked[] |
listDaftar kode wilayah yang mengidentifikasi negara tempat video diblokir. Jika properti ini ada dan suatu negara tidak tercantum dalam nilainya, video tersebut dapat dilihat di negara tersebut. Jika properti ini ada dan berisi daftar kosong, video dapat dilihat di semua negara. |
contentDetails.contentRating |
objectMenentukan rating yang diterima video berdasarkan berbagai skema rating. |
contentDetails.contentRating.acbRating |
stringRating video dari Australian Classification Board (ACB) atau Australian Communications and Media Authority (ACMA). Rating ACMA digunakan untuk mengklasifikasikan program televisi anak-anak. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.agcomRating |
stringRating video dari Autorità per le Garanzie nelle Comunicazioni (AGCOM) Italia. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.anatelRating |
stringRating Anatel (Asociación Nacional de Televisión) video untuk televisi Cile. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.bbfcRating |
stringRating British Board of Film Classification (BBFC) video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.bfvcRating |
stringRating video dari Lembaga Sensor Film dan Video Thailand. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.bmukkRating |
stringRating video dari Lembaga Klasifikasi Media Austria (Bundesministerium für Unterricht, Kunst und Kultur). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.catvRating |
stringSistem rating untuk TV Kanada - Sistem Klasifikasi TV Kanada Rating video dari Canadian Radio-Television and Telecommunications Commission (CRTC) untuk siaran berbahasa Inggris Kanada. Untuk mengetahui informasi selengkapnya, lihat situs Canadian Broadcast Standards Council. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.catvfrRating |
stringRating video dari Canadian Radio-Television and Telecommunications Commission (CRTC) untuk siaran berbahasa Prancis di Kanada. Untuk mengetahui informasi selengkapnya, lihat situs Canadian Broadcast Standards Council. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.cbfcRating |
stringRating video dari Central Board of Film Certification (CBFC - India). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.cccRating |
stringRating Consejo de Calificación Cinematográfica (Cile) video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.cceRating |
stringRating video dari Comissão de Classificação de Espect´culos di Portugal. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.chfilmRating |
stringRating video di Swiss. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.chvrsRating |
stringRating Sistem Rating Video Rumahan Kanada (CHVRS) video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.cicfRating |
stringRating video dari Commission de Contrôle des Films (Belgia). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.cnaRating |
stringRating video dari CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) Rumania. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.cncRating |
stringSistem rating di Prancis - Commission de classification cinematographique Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.csaRating |
stringRating video dari Conseil supérieur de l'audiovisuel Prancis, yang menilai konten siaran. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.cscfRating |
stringRating video dari Commission de surveillance de la classification des films (CSCF) Luksemburg. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.czfilmRating |
stringRating video di Republik Ceko. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.djctqRating |
stringRating Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brasil) video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.djctqRatingReasons[] |
listAlasan yang menjelaskan mengapa video menerima rating DJCQT (Brasil). |
contentDetails.contentRating.ecbmctRating |
stringSistem rating di Turkiye - Dewan Evaluasi dan Klasifikasi Kementerian Kebudayaan dan Pariwisata Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.eefilmRating |
stringRating video di Estonia. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.egfilmRating |
stringRating video di Mesir. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.eirinRating |
stringRating Eirin (映倫) video. Eirin adalah sistem rating Jepang. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.fcbmRating |
stringRating video dari Lembaga Sensor Film Malaysia. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.fcoRating |
stringRating video dari Office for Film, Newspaper and Article Administration di Hong Kong. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.fmocRating |
stringProperti ini tidak digunakan lagi mulai 2 November 2015. Gunakan properti contentDetails.contentRating.cncRating sebagai gantinya.Rating Centre national du cinéma et de l'image animé (Kementerian Kebudayaan Prancis) untuk video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.fpbRating |
stringRating video dari Film and Publication Board Afrika Selatan. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.fpbRatingReasons[] |
listAlasan yang menjelaskan mengapa video menerima rating FPB (Afrika Selatan). |
contentDetails.contentRating.fskRating |
stringRating Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Jerman) video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.grfilmRating |
stringRating video di Yunani. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.icaaRating |
stringRating Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - Spanyol) video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.ifcoRating |
stringRating video dari Irish Film Classification Office (IFCO - Irlandia). Lihat situs IFCO untuk mengetahui informasi selengkapnya. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.ilfilmRating |
stringRating video di Israel. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.incaaRating |
stringRating INCAA (Instituto Nacional de Cine y Artes Audiovisuales - Argentina) video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.kfcbRating |
stringRating video dari Kenya Film Classification Board. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.kijkwijzerRating |
stringvoor de Classificatie van Audiovisuele Media (Belanda). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.kmrbRating |
stringRating video dari Korea Media Rating Board (영상물등급위원회). KMRB memberi rating pada video di Korea Selatan. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.lsfRating |
stringRating video dari Lembaga Sensor Film Indonesia. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mccaaRating |
stringRating video dari Malta Film Age-Classification Board. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mccypRating |
stringRating video dari Media Council for Children and Young People (Det Danske Filminstitut) di Danish Film Institute. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mcstRating |
stringSistem rating video untuk Vietnam - MCST Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mdaRating |
stringRating video dari Media Development Authority (MDA) Singapura dan, khususnya, Board of Film Censors (BFC). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.medietilsynetRating |
stringRating video dari Medietilsynet, Otoritas Media Norwegia. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mekuRating |
stringRating video dari Kansallinen Audiovisuaalinen Instituutti (National Audiovisual Institute) di Finlandia. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mibacRating |
stringRating video dari Ministero dei Beni e delle Attività Culturali e del Turismo (Italia). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mocRating |
stringRating video dari Ministerio de Cultura (Kolombia). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.moctwRating |
stringRating video dari Kementerian Kebudayaan (文化部) Taiwan. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mpaaRating |
stringRating Motion Picture Association of America (MPAA) video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mpaatRating |
stringRating Motion Picture Association of America untuk cuplikan dan pratinjau film. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mtrcbRating |
stringRating video dari Movie and Television Review and Classification Board (Filipina). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.nbcRating |
stringRating video dari Biro Klasifikasi Nasional Maladewa. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.nfrcRating |
stringRating video dari Bulgarian National Film Center. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.nfvcbRating |
stringRating video dari National Film and Video Censors Board Nigeria. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.nkclvRating |
stringRating video dari Nacionãlais Kino centrs (National Film Centre of Latvia). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.oflcRating |
stringRating video dari Office of Film and Literature Classification (OFLC - Selandia Baru). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.pefilmRating |
stringRating video di Peru. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.resorteviolenciaRating |
stringRating video di Venezuela. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.rtcRating |
stringRating video dari General Directorate of Radio, Television and Cinematography (Meksiko). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.rteRating |
stringRating video dari Raidió Teilifís Éireann di Irlandia. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.russiaRating |
stringRating National Film Registry of the Russian Federation (MKRF - Rusia) video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.skfilmRating |
stringRating video di Slovakia. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.smaisRating |
stringRating video di Islandia. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.smsaRating |
stringRating video dari Statens medieråd (Dewan Media Nasional Swedia). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.tvpgRating |
stringRating TV Parental Guidelines (TVPG) video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.ytRating |
stringRating yang digunakan YouTube untuk mengidentifikasi konten yang dikenai pembatasan usia. Nilai yang valid untuk properti ini adalah:
|
contentDetails.projection |
stringMenentukan format proyeksi video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.hasCustomThumbnail |
booleanMenunjukkan apakah uploader video telah memberikan gambar thumbnail kustom untuk video tersebut. Properti ini hanya dapat dilihat oleh uploader video. |
status |
objectObjek status berisi informasi tentang status upload, pemrosesan, dan privasi video. |
status.uploadStatus |
stringStatus video yang diupload. Nilai yang valid untuk properti ini adalah:
|
status.failureReason |
stringNilai ini menjelaskan alasan video gagal diupload. Properti ini hanya ada jika properti uploadStatus menunjukkan bahwa upload gagal.Nilai yang valid untuk properti ini adalah:
|
status.rejectionReason |
stringNilai ini menjelaskan alasan YouTube menolak video yang diupload. Properti ini hanya ada jika properti uploadStatus menunjukkan bahwa upload ditolak.Nilai yang valid untuk properti ini adalah:
|
status.privacyStatus |
stringStatus privasi video. Nilai yang valid untuk properti ini adalah:
|
status.publishAt |
datetimeTanggal dan waktu video dijadwalkan untuk dipublikasikan. Setelan ini hanya dapat ditetapkan jika status privasi video adalah pribadi. Nilai ditentukan dalam format ISO 8601. Perhatikan dua poin tambahan berikut tentang perilaku properti ini:
|
status.license |
stringLisensi video. Nilai yang valid untuk properti ini adalah:
|
status.embeddable |
booleanNilai ini menunjukkan apakah video dapat disematkan di situs lain. |
status.publicStatsViewable |
booleanNilai ini menunjukkan apakah statistik video yang diperluas di halaman tonton video dapat dilihat oleh publik. Secara default, statistik tersebut dapat dilihat, dan statistik seperti jumlah penayangan dan rating video akan tetap terlihat oleh publik meskipun nilai properti ini ditetapkan ke false. |
status.madeForKids |
booleanNilai ini menunjukkan apakah video ditetapkan sebagai ditujukan untuk anak-anak, dan berisi status "Dibuat untuk Anak-Anak" video saat ini. Misalnya, status dapat ditentukan berdasarkan nilai properti selfDeclaredMadeForKids. Lihat
Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya tentang cara menetapkan penonton untuk channel, video, atau siaran Anda.
|
status.selfDeclaredMadeForKids |
booleanDalam permintaan videos.insert atau
videos.update, properti
ini memungkinkan pemilik channel menetapkan video sebagai video yang ditujukan untuk anak-anak. Dalam permintaan
videos.list, nilai
properti hanya ditampilkan jika pemilik channel mengizinkan permintaan API. |
status.containsSyntheticMedia |
booleanDalam permintaan videos.insert atau
videos.update, properti ini
memungkinkan pemilik channel mengungkapkan bahwa video berisi konten Sintetis atau
Dimodifikasi (S/M) yang tampak realistis. Pelajari lebih lanjut
kebijakan YouTube
terkait konten A/S.Contoh konten A/S mencakup video yang:
|
statistics |
objectObjek statistics berisi statistik tentang video. |
statistics.viewCount |
unsigned longFrekuensi video ditonton. Mulai 31 Maret 2025, untuk Shorts, viewCount akan menampilkan berapa kali video Shorts mulai diputar atau diputar ulang, tanpa persyaratan waktu tonton minimum. |
statistics.likeCount |
unsigned longJumlah pengguna yang menunjukkan bahwa mereka menyukai video. |
statistics.dislikeCount |
unsigned longCatatan: Properti
statistics.dislikeCount telah disetel ke pribadi mulai 13 Desember 2021. Artinya, properti tersebut disertakan dalam respons API hanya jika permintaan API diautentikasi oleh pemilik video. Lihat histori revisi untuk mengetahui informasi selengkapnya.Jumlah pengguna yang menunjukkan bahwa mereka tidak menyukai video. |
statistics.favoriteCount |
unsigned longCatatan: Properti ini tidak digunakan lagi. Penghentian ini berlaku mulai 28 Agustus 2015. Nilai properti sekarang selalu ditetapkan ke 0. |
statistics.commentCount |
unsigned longJumlah komentar untuk video. |
paidProductPlacementDetails |
objectObjek paidProductPlacementDetails berisi informasi tentang penempatan produk berbayar dalam video. |
paidProductPlacementDetails.hasPaidProductPlacement |
booleanSetel ke true jika konten menggunakan penempatan produk berbayar. Defaultnya adalah false. |
player |
objectObjek player berisi informasi yang akan Anda gunakan untuk memutar video di pemutar tersemat. |
player.embedHtml |
stringTag <iframe> yang menyematkan pemutar yang memutar video.
|
player.embedHeight |
longTinggi pemutar yang disematkan yang ditampilkan dalam properti player.embedHtml. Properti ini hanya ditampilkan jika permintaan menentukan nilai untuk parameter maxHeight dan/atau maxWidth dan rasio aspek video diketahui. |
player.embedWidth |
longLebar pemutar tersemat yang ditampilkan dalam properti player.embedHtml. Properti ini hanya ditampilkan jika permintaan menentukan nilai untuk parameter maxHeight dan/atau maxWidth dan rasio aspek video diketahui. |
topicDetails |
objectObjek topicDetails merangkum informasi tentang topik yang terkait dengan video.Penting: Lihat definisi properti topicDetails.relevantTopicIds[] dan topicDetails.topicIds[] serta histori revisi untuk mengetahui detail selengkapnya tentang perubahan mendatang terkait ID topik. |
topicDetails.topicIds[] |
listPenting: Properti ini telah dihentikan sejak 10 November 2016. API tidak lagi menampilkan nilai untuk properti ini, dan topik apa pun yang terkait dengan video kini ditampilkan oleh nilai properti topicDetails.relevantTopicIds[]. |
topicDetails.relevantTopicIds[] |
listDaftar ID topik yang relevan dengan video. Properti ini tidak digunakan lagi mulai 10 November 2016. Fitur ini akan didukung hingga 10 November 2017. Penting: Karena penghentian penggunaan Freebase dan Freebase API, ID topik mulai berfungsi secara berbeda mulai 27 Februari 2017. Pada saat itu, YouTube mulai menampilkan sekumpulan kecil ID topik pilihan. |
topicDetails.topicCategories[] |
listDaftar URL Wikipedia yang memberikan deskripsi tingkat tinggi tentang konten video. |
recordingDetails |
objectObjek recordingDetails merangkum informasi tentang lokasi, tanggal, dan alamat tempat video direkam. |
recordingDetails.locationDescription |
stringProperti ini tidak digunakan lagi mulai 1 Juni 2017. Lihat pengumuman penghentian penggunaan untuk mengetahui detail selengkapnya. Deskripsi teks lokasi tempat video direkam. |
recordingDetails.location |
objectInformasi geolokasi yang terkait dengan video. Perhatikan bahwa nilai properti turunan mengidentifikasi lokasi yang ingin dikaitkan pemilik video dengan video tersebut. Nilai ini dapat diedit, ditelusuri di video publik, dan mungkin ditampilkan kepada pengguna untuk video publik. |
recordingDetails.location.latitude |
doubleProperti ini tidak digunakan lagi mulai 1 Juni 2017. Lihat pengumuman penghentian penggunaan untuk mengetahui detail selengkapnya. Lintang dalam derajat. |
recordingDetails.location.longitude |
doubleProperti ini tidak digunakan lagi mulai 1 Juni 2017. Lihat pengumuman penghentian penggunaan untuk mengetahui detail selengkapnya. Bujur dalam derajat. |
recordingDetails.location.altitude |
doubleProperti ini tidak digunakan lagi mulai 9 Juli 2018. Lihat pengumuman penghentian penggunaan untuk mengetahui detail selengkapnya. Ketinggian di atas elipsoid referensi, dalam meter. |
recordingDetails.recordingDate |
datetimeTanggal dan waktu saat video direkam. Nilai ditentukan dalam format ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ). |
fileDetails |
objectObjek fileDetails merangkum informasi tentang file video yang diupload ke YouTube, termasuk resolusi, durasi, codec audio dan video, bitrate streaming, dan lainnya. Data ini hanya dapat diambil oleh pemilik video.Objek fileDetails hanya akan ditampilkan jika properti processingDetails.fileAvailability memiliki nilai available. |
fileDetails.fileName |
stringNama file yang diupload. Kolom ini ada terlepas dari apakah file video atau jenis file lain diupload. |
fileDetails.fileSize |
unsigned longUkuran file yang diupload dalam byte. Kolom ini ada terlepas dari apakah file video atau jenis file lain diupload. |
fileDetails.fileType |
stringJenis file yang diupload seperti yang terdeteksi oleh mesin pemrosesan video YouTube. Saat ini, YouTube hanya memproses file video, tetapi kolom ini ada terlepas dari apakah file video atau jenis file lain yang diupload. Nilai yang valid untuk properti ini adalah:
|
fileDetails.container |
stringFormat penampung file video yang diupload. |
fileDetails.videoStreams[] |
listDaftar aliran video yang terdapat dalam file video yang diupload. Setiap item dalam daftar berisi metadata mendetail tentang streaming video. |
fileDetails.videoStreams[].widthPixels |
unsigned integerLebar konten video yang dienkode dalam piksel. Anda dapat menghitung rasio aspek encoding video sebagai width_pixels / height_pixels. |
fileDetails.videoStreams[].heightPixels |
unsigned integerTinggi konten video yang dienkode dalam piksel. |
fileDetails.videoStreams[].frameRateFps |
doubleKecepatan frame streaming video, dalam frame per detik. |
fileDetails.videoStreams[].aspectRatio |
doubleRasio aspek tampilan konten video, yang menentukan rasio aspek yang harus digunakan untuk menampilkan video. |
fileDetails.videoStreams[].codec |
stringCodec video yang digunakan streaming. |
fileDetails.videoStreams[].bitrateBps |
unsigned longKecepatan bit streaming video, dalam bit per detik. |
fileDetails.videoStreams[].rotation |
stringJumlah yang diperlukan YouTube untuk memutar konten sumber asli agar video ditampilkan dengan benar. Nilai yang valid untuk properti ini adalah:
|
fileDetails.videoStreams[].vendor |
stringNilai yang secara unik mengidentifikasi vendor video. Biasanya, nilainya adalah kode vendor empat huruf. |
fileDetails.audioStreams[] |
listDaftar aliran audio yang terdapat dalam file video yang diupload. Setiap item dalam daftar berisi metadata mendetail tentang aliran audio. |
fileDetails.audioStreams[].channelCount |
unsigned integerJumlah saluran audio yang berisi streaming. |
fileDetails.audioStreams[].codec |
stringCodec audio yang digunakan streaming. |
fileDetails.audioStreams[].bitrateBps |
unsigned longKecepatan bit streaming audio, dalam bit per detik. |
fileDetails.audioStreams[].vendor |
stringNilai yang secara unik mengidentifikasi vendor video. Biasanya, nilainya adalah kode vendor empat huruf. |
fileDetails.durationMs |
unsigned longDurasi video yang diupload dalam milidetik. |
fileDetails.bitrateBps |
unsigned longKecepatan bit gabungan (video dan audio) file video yang diupload dalam bit per detik. |
fileDetails.creationTime |
stringTanggal dan waktu saat file video yang diupload dibuat. Nilai ditentukan dalam format ISO 8601. Saat ini, format ISO 8601 berikut didukung:
|
processingDetails |
objectObjek processingDetails merangkum informasi tentang progres YouTube dalam memproses file video yang diupload. Properti dalam objek mengidentifikasi status pemrosesan saat ini dan perkiraan waktu yang tersisa hingga YouTube selesai memproses video. Bagian ini juga menunjukkan apakah berbagai jenis data atau konten, seperti detail file atau gambar thumbnail, tersedia untuk video tersebut.Objek processingProgress dirancang untuk di-polling sehingga video yang diupload dapat melacak progres yang telah dilakukan YouTube dalam memproses file video yang diupload. Data ini hanya dapat diambil oleh pemilik video. |
processingDetails.processingStatus |
stringStatus pemrosesan video. Nilai ini menunjukkan apakah YouTube dapat memproses video atau apakah video masih diproses. Nilai yang valid untuk properti ini adalah:
|
processingDetails.processingProgress |
objectObjek processingProgress berisi informasi tentang progres yang telah dicapai YouTube dalam memproses video. Nilai hanya relevan jika status pemrosesan video adalah processing. |
processingDetails.processingProgress.partsTotal |
unsigned longPerkiraan jumlah total bagian yang perlu diproses untuk video. Jumlah ini dapat diperbarui dengan estimasi yang lebih akurat saat YouTube memproses video. |
processingDetails.processingProgress.partsProcessed |
unsigned longJumlah bagian video yang telah diproses oleh YouTube. Anda dapat memperkirakan persentase video yang telah diproses oleh YouTube dengan menghitung: 100 * parts_processed / parts_totalPerhatikan bahwa karena perkiraan jumlah bagian dapat meningkat tanpa peningkatan yang sesuai dalam jumlah bagian yang telah diproses, ada kemungkinan bahwa progres yang dihitung dapat berkurang secara berkala saat YouTube memproses video. |
processingDetails.processingProgress.timeLeftMs |
unsigned longEstimasi jumlah waktu, dalam milidetik, yang dibutuhkan YouTube untuk menyelesaikan pemrosesan video. |
processingDetails.processingFailureReason |
stringAlasan YouTube gagal memproses video. Properti ini hanya akan memiliki nilai jika nilai properti processingStatus adalah failed.Nilai yang valid untuk properti ini adalah:
|
processingDetails.fileDetailsAvailability |
stringNilai ini menunjukkan apakah detail file tersedia untuk video yang diupload. Anda dapat mengambil detail file video dengan meminta bagian fileDetails dalam permintaan videos.list() Anda. |
processingDetails.processingIssuesAvailability |
stringNilai ini menunjukkan apakah mesin pemrosesan video telah membuat saran yang dapat meningkatkan kemampuan YouTube untuk memproses video, peringatan yang menjelaskan masalah pemrosesan video, atau error yang menyebabkan masalah pemrosesan video. Anda dapat mengambil saran ini dengan meminta bagian suggestions dalam permintaan videos.list() Anda. |
processingDetails.tagSuggestionsAvailability |
stringNilai ini menunjukkan apakah saran kata kunci (tag) tersedia untuk video. Tag dapat ditambahkan ke metadata video untuk memudahkan pengguna lain menemukan video tersebut. Anda dapat mengambil saran ini dengan meminta bagian suggestions dalam permintaan videos.list() Anda. |
processingDetails.editorSuggestionsAvailability |
stringNilai ini menunjukkan apakah saran pengeditan video, yang dapat meningkatkan kualitas video atau pengalaman pemutaran, tersedia untuk video tersebut. Anda dapat mengambil saran ini dengan meminta bagian suggestions dalam permintaan videos.list() Anda. |
processingDetails.thumbnailsAvailability |
stringNilai ini menunjukkan apakah gambar thumbnail telah dibuat untuk video. |
suggestions |
objectObjek suggestions merangkum saran yang mengidentifikasi peluang untuk meningkatkan kualitas video atau metadata untuk video yang diupload. Data ini hanya dapat diambil oleh pemilik video. Objek suggestions hanya akan ditampilkan jika properti processingDetails.tagSuggestionsAvailability atau properti processingDetails.editorSuggestionsAvailability memiliki nilai available. |
suggestions.processingErrors[] |
listDaftar error yang akan mencegah YouTube berhasil memproses video yang diupload. Error ini menunjukkan bahwa, terlepas dari status pemrosesan video saat ini, pada akhirnya, status tersebut hampir pasti akan menjadi failed.Nilai yang valid untuk properti ini adalah:
|
suggestions.processingWarnings[] |
listDaftar alasan mengapa YouTube mungkin mengalami kesulitan mentranskode video yang diupload atau yang dapat menyebabkan kesalahan transkode. Peringatan ini dibuat sebelum YouTube benar-benar memproses file video yang diupload. Selain itu, masalah yang diidentifikasi tidak selalu menunjukkan bahwa pemrosesan video akan gagal, tetapi masih dapat menyebabkan masalah seperti masalah sinkronisasi, artefak video, atau trek audio yang tidak ada. Nilai yang valid untuk properti ini adalah:
|
suggestions.processingHints[] |
listDaftar saran yang dapat meningkatkan kemampuan YouTube dalam memproses video. Nilai yang valid untuk properti ini adalah:
|
suggestions.tagSuggestions[] |
listDaftar tag kata kunci yang dapat ditambahkan ke metadata video untuk meningkatkan kemungkinan pengguna akan menemukan video Anda saat menelusuri atau menjelajahi YouTube. |
suggestions.tagSuggestions[].tag |
stringTag kata kunci yang disarankan untuk video. |
suggestions.tagSuggestions[].categoryRestricts[] |
listKumpulan kategori video yang relevan dengan tag. Anda dapat menggunakan informasi ini untuk menampilkan saran tag yang sesuai berdasarkan kategori video yang dikaitkan pengupload video dengan video tersebut. Secara default, saran tag relevan untuk semua kategori jika tidak ada batasan yang ditentukan untuk kata kunci. |
suggestions.editorSuggestions[] |
listDaftar operasi pengeditan video yang dapat meningkatkan kualitas video atau pengalaman pemutaran video yang diupload. Nilai yang valid untuk properti ini adalah:
|
liveStreamingDetails |
objectObjek liveStreamingDetails berisi metadata tentang siaran video live. Objek hanya akan ada di resource video jika video adalah live streaming mendatang, live streaming, atau live streaming selesai. |
liveStreamingDetails.actualStartTime |
datetimeWaktu siaran benar-benar dimulai. Nilai ditentukan dalam format ISO 8601. Nilai ini tidak akan tersedia hingga siaran dimulai. |
liveStreamingDetails.actualEndTime |
datetimeWaktu saat siaran benar-benar berakhir. Nilai ditentukan dalam format ISO 8601. Nilai ini tidak akan tersedia hingga siaran berakhir. |
liveStreamingDetails.scheduledStartTime |
datetimeWaktu siaran dijadwalkan untuk dimulai. Nilai ditentukan dalam format ISO 8601. |
liveStreamingDetails.scheduledEndTime |
datetimeWaktu siaran dijadwalkan berakhir. Nilai ditentukan dalam format ISO 8601. Jika nilainya kosong atau properti tidak ada, siaran dijadwalkan untuk berlanjut tanpa batas. |
liveStreamingDetails.concurrentViewers |
unsigned longJumlah penonton yang saat ini menonton siaran. Properti dan nilainya akan ada jika siaran memiliki penonton saat ini dan pemilik siaran belum menyembunyikan jumlah penayangan video. Perhatikan bahwa YouTube berhenti melacak jumlah penonton serentak untuk siaran setelah siaran berakhir. Jadi, properti ini tidak akan mengidentifikasi jumlah penonton yang menonton video arsip live streaming yang sudah berakhir. Jumlah penonton serentak yang ditampilkan oleh YouTube Data API mungkin berbeda dengan jumlah penonton serentak yang telah diproses dan bebas spam yang tersedia melalui YouTube Analytics. Pelajari lebih lanjut metrik live streaming di Pusat Bantuan YouTube.
|
liveStreamingDetails.activeLiveChatId |
stringID live chat yang saat ini aktif dan terlampir pada video ini. Kolom ini hanya diisi jika video adalah live streaming yang sedang berlangsung dan memiliki live chat. Setelah siaran beralih ke selesai, kolom ini akan dihapus dan live chat ditutup. Untuk siaran persisten, ID live chat tidak akan lagi dikaitkan dengan video ini, melainkan dengan video baru yang ditampilkan di halaman persisten. |
localizations |
objectObjek localizations berisi terjemahan metadata video. |
localizations.(key) |
objectBahasa teks yang dilokalkan yang terkait dengan nilai kunci. Nilainya adalah string yang berisi kode bahasa BCP-47. |
localizations.(key).title |
stringJudul video yang dilokalkan. |
localizations.(key).description |
stringDeskripsi video yang dilokalkan. |