Semua video yang diupload melalui endpoint
videos.insert
dari project API yang belum diverifikasi yang dibuat setelah 28 Juli 2020 akan dibatasi ke mode tontonan pribadi. Untuk mencabut pembatasan ini, setiap project API harus
melakukan audit untuk memverifikasi
kepatuhan terhadap Persyaratan
Layanan. Lihat Histori Revisi API untuk detail selengkapnya.
Resource video
mewakili video YouTube.
Metode
API ini mendukung metode berikut untuk resource videos
:
- getRating
- Mengambil rating yang diberikan pengguna yang diberi otorisasi ke daftar video yang ditentukan. Coba sekarang.
- list
- Menampilkan daftar video yang cocok dengan parameter permintaan API. Coba sekarang.
- sisipkan
- Mengupload video ke YouTube dan secara opsional menyetel metadata video.
- pembaruan
- Memperbarui metadata video. Coba sekarang.
- hapus
- Menghapus video YouTube. Coba sekarang.
- tarif
- Menambahkan rating suka atau tidak suka ke video, atau menghapus rating dari video. Coba sekarang.
- reportAbuse
- Melaporkan 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 }, "statistics": { "viewCount": string, "likeCount": string, "dislikeCount": string, "favoriteCount": string, "commentCount": string }, "player": { "embedHtml": string, "embedHeight": long, "embedWidth": long }, "topicDetails": { "topicIds": [ string ], "relevantTopicIds": [ string ], "topicCategories": [ string ] }, "recordingDetails": { "recordingDate": datetime }, "fileDetails": { "fileName": string, "fileSize": unsigned long, "fileType": string, "container": string, "videoStreams": [ { "widthPixels": unsigned integer, "heightPixels": unsigned integer, "frameRateFps": double, "aspectRatio": double, "codec": string, "bitrateBps": unsigned long, "rotation": string, "vendor": string } ], "audioStreams": [ { "channelCount": unsigned integer, "codec": string, "bitrateBps": unsigned long, "vendor": string } ], "durationMs": unsigned long, "bitrateBps": unsigned long, "creationTime": string }, "processingDetails": { "processingStatus": string, "processingProgress": { "partsTotal": unsigned long, "partsProcessed": unsigned long, "timeLeftMs": unsigned long }, "processingFailureReason": string, "fileDetailsAvailability": string, "processingIssuesAvailability": string, "tagSuggestionsAvailability": string, "editorSuggestionsAvailability": string, "thumbnailsAvailability": string }, "suggestions": { "processingErrors": [ string ], "processingWarnings": [ string ], "processingHints": [ string ], "tagSuggestions": [ { "tag": string, "categoryRestricts": [ string ] } ], "editorSuggestions": [ string ] }, "liveStreamingDetails": { "actualStartTime": datetime, "actualEndTime": datetime, "scheduledStartTime": datetime, "scheduledEndTime": datetime, "concurrentViewers": unsigned long, "activeLiveChatId": string }, "localizations": { (key): { "title": string, "description": string } } }
Properti
Tabel berikut menentukan properti yang muncul di resource ini:
Properti | |
---|---|
kind |
string Mengidentifikasi jenis resource API. Nilainya akan berupa youtube#video . |
etag |
etag Etag referensi ini. |
id |
string ID yang digunakan YouTube untuk mengidentifikasi video secara unik. |
snippet |
object Objek snippet berisi detail dasar tentang video, seperti judul, deskripsi, dan kategorinya. |
snippet.publishedAt |
datetime Tanggal dan waktu video dipublikasikan. Perhatikan bahwa waktu ini mungkin berbeda dengan waktu video diupload. Misalnya, jika video diupload sebagai video pribadi, kemudian dipublikasikan di lain waktu, properti ini akan menentukan kapan video tersebut dipublikasikan. Ada beberapa kasus khusus:
|
snippet.channelId |
string ID yang digunakan YouTube untuk mengidentifikasi channel yang menjadi tujuan upload video secara unik. |
snippet.title |
string Judul 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 memanggil metode videos.update dan memperbarui bagian snippet dari resource video . |
snippet.description |
string Deskripsi video. Nilai properti memiliki panjang maksimum 5.000 byte dan dapat berisi semua karakter UTF-8 yang valid, kecuali < dan >. |
snippet.thumbnails |
object Peta 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) |
object Nilai kunci yang valid adalah:
|
snippet.thumbnails.(key).url |
string URL gambar. |
snippet.thumbnails.(key).width |
unsigned integer Lebar gambar. |
snippet.thumbnails.(key).height |
unsigned integer Tinggi gambar. |
snippet.channelTitle |
string Judul channel untuk channel tempat video tersebut berada. |
snippet.tags[] |
list Daftar tag kata kunci yang terkait dengan video. Tag dapat berisi spasi. Nilai properti memiliki panjang maksimum 500 karakter. Perhatikan aturan berikut mengenai cara penghitungan batas karakter:
|
snippet.categoryId |
string Kategori video YouTube yang terkait dengan video tersebut. Anda harus menetapkan nilai untuk properti ini jika memanggil metode videos.update dan memperbarui bagian snippet dari resource video . |
snippet.liveBroadcastContent |
string Menunjukkan apakah video adalah live streaming mendatang/aktif. Atau "tidak ada" jika video bukan merupakan live streaming mendatang/aktif. Nilai yang valid untuk properti ini adalah:
|
snippet.defaultLanguage |
string Bahasa teks di properti snippet.title dan snippet.description resource video . |
snippet.localized |
object Objek 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 |
string Judul video yang dilokalkan. |
snippet.localized.description |
string Deskripsi video yang dilokalkan. |
snippet.defaultAudioLanguage |
string Properti default_audio_language menentukan bahasa yang diucapkan dalam trek audio default video. |
contentDetails |
object Objek contentDetails berisi informasi tentang konten video, termasuk durasi video dan indikasi apakah teks tersedia untuk video. |
contentDetails.duration |
string Durasi video. Nilai properti berupa durasi ISO 8601. Misalnya, untuk video yang berdurasi minimal satu menit dan kurang dari satu jam, durasinya menggunakan format PT#M#S , dengan huruf PT menunjukkan bahwa nilai menentukan periode waktu, dan huruf M dan S merujuk pada durasi dalam menit dan detik. Karakter # sebelum huruf M dan S adalah bilangan bulat yang menentukan jumlah menit (atau detik) video. Misalnya, nilai PT15M33S menunjukkan bahwa video berdurasi 15 menit 33 detik.Jika video berdurasi minimal satu jam, durasinya menggunakan format PT#H#M#S , dengan # sebelum huruf H menentukan durasi video dalam jam dan semua detail lainnya sama dengan yang dijelaskan di atas. Jika video berdurasi minimal satu hari, huruf P dan T akan dipisahkan, dan format nilainya adalah P#DT#H#M#S . Lihat spesifikasi ISO 8601 untuk detail selengkapnya. |
contentDetails.dimension |
string Menunjukkan apakah video tersedia dalam 3D atau 2D. |
contentDetails.definition |
string Menunjukkan apakah video tersedia dalam definisi tinggi ( HD ) atau hanya dalam definisi standar.Nilai yang valid untuk properti ini adalah:
|
contentDetails.caption |
string Menunjukkan apakah teks tersedia untuk video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.licensedContent |
boolean Menunjukkan apakah video mewakili konten berlisensi, yang berarti konten diupload ke channel yang ditautkan ke partner konten YouTube lalu diklaim oleh partner tersebut. |
contentDetails.regionRestriction |
object Objek regionRestriction berisi informasi tentang negara tempat video dapat (atau tidak) dapat dilihat. Objek akan berisi properti contentDetails.regionRestriction.allowed atau properti contentDetails.regionRestriction.blocked . |
contentDetails.regionRestriction.allowed[] |
list Daftar 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[] |
list Daftar kode wilayah yang mengidentifikasi negara tempat video diblokir. Jika properti ini ada dan negara tidak tercantum dalam nilainya, video dapat ditonton di negara tersebut. Jika properti ini ada dan berisi daftar kosong, video dapat dilihat di semua negara. |
contentDetails.contentRating |
object Menentukan rating yang diterima video dalam berbagai skema rating. |
contentDetails.contentRating.acbRating |
string Rating Australian Classification Board (ACB) atau Australian Communications and Media Authority (ACMA) pada video. Rating ACMA digunakan untuk mengklasifikasikan program televisi anak-anak. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.agcomRating |
string Rating video dari Autorità per le Garanzie nelle Comunicazioni (AGCOM) Italia. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.anatelRating |
string Rating Anatel (Asociación Nacional de Televisión) video untuk televisi Cile. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.bbfcRating |
string Rating British Board of Film Classification (BBFC) video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.bfvcRating |
string Rating video dari Dewan Sensor Film dan Video Thailand. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.bmukkRating |
string Rating video dari Austrian Board of Media Classification (Bundesministerium für Unterricht, Kunst und Kultur). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.catvRating |
string Sistem rating untuk TV Kanada - Sistem Klasifikasi TV Kanada. Rating video dari Canadian Radio-Television and Telecommunications Commission (CRTC) untuk siaran berbahasa Inggris Kanada. Untuk informasi selengkapnya, lihat situs Canadian Broadcast Standards Council. Nilai yang valid untuk properti ini:
|
contentDetails.contentRating.catvfrRating |
string Rating video dari Canadian Radio-Television and Telecommunications Commission (CRTC) untuk siaran berbahasa Prancis Kanada. Untuk informasi selengkapnya, lihat situs Canadian Broadcast Standards Council. Nilai yang valid untuk properti ini:
|
contentDetails.contentRating.cbfcRating |
string Rating Central Board of Film Certification (CBFC - India) video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.cccRating |
string Rating Consejo de Calificación Cinematográfica (Cile) video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.cceRating |
string Rating video dari Comissão de Classificação de Espect Áculos Portugal. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.chfilmRating |
string Rating video di Swiss. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.chvrsRating |
string Rating Sistem Rating Video Rumah (CHVRS) Kanada untuk video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.cicfRating |
string Rating video dari Commission de Contrôle des Films (Belgia). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.cnaRating |
string Rating video dari CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) Rumania. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.cncRating |
string Sistem rating di Prancis - Commission deClassification Cinematographique Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.csaRating |
string Rating video dari Conseil supérieur de l?audiovisuel Prancis, yang menilai konten siaran. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.cscfRating |
string Rating video dari Commission de surveillance de la classification des films (CSCF) Luksemburg. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.czfilmRating |
string Rating video di Republik Ceko. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.djctqRating |
string Rating Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brasil) video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.djctqRatingReasons[] |
list Alasan-alasan yang menjelaskan mengapa video ini mendapatkan rating DJCQT (Brasil). |
contentDetails.contentRating.ecbmctRating |
string Sistem rating di Turki - Evaluation and Classification Board of the Ministry of Culture and Tourism Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.eefilmRating |
string Rating video di Estonia. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.egfilmRating |
string Rating video di Mesir. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.eirinRating |
string Rating Eirin (映倫) video. Eirin adalah sistem rating Jepang. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.fcbmRating |
string Rating video dari Malaysia's Film Censorship Board. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.fcoRating |
string Rating video dari Office for Film, Newspaper and Article Administration Hong Kong. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.fmocRating |
string Properti ini tidak digunakan lagi mulai 2 November 2015. Gunakan properti contentDetails.contentRating.cncRating sebagai gantinya.Rating Centre nasional du cinéma et de l'image animé (Kementerian Kebudayaan Prancis) pada video ini. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.fpbRating |
string Rating video dari Film and Publication Board Afrika Selatan. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.fpbRatingReasons[] |
list Alasan yang menjelaskan mengapa video mendapatkan rating FPB (Afrika Selatan). |
contentDetails.contentRating.fskRating |
string Rating Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Jerman) dari video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.grfilmRating |
string Rating video di Yunani. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.icaaRating |
string Rating Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - Spanyol). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.ifcoRating |
string Rating Irish Film Classification Office (IFCO - Irlandia) video. Lihat situs IFCO untuk mendapatkan informasi selengkapnya. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.ilfilmRating |
string Rating video di Israel. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.incaaRating |
string Rating INCAA (Instituto Nacional de Cine y Artes Audiovisuales - Argentina) video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.kfcbRating |
string Rating video dari Kenya Film Classification Board. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.kijkwijzerRating |
string voor de Classificatie van Audiovisuele Media (Belanda). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.kmrbRating |
string Rating Korea Media Rating Board (영 diterjemahkan물등의위cpm회) video. Tarif KMRB untuk video di Korea Selatan. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.lsfRating |
string Rating video dari Lembaga Sensor Film Indonesia. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mccaaRating |
string Rating video dari Film Age-Classification Board Malta. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mccypRating |
string Rating video dari Denmark Film Institute's (Det Danske Filminstitut) Media Council for Children and Young People. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mcstRating |
string Sistem rating video untuk Vietnam - MCST Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mdaRating |
string Rating video dari Media Development Authority (MDA) Singapura dan khususnya, Dewan Sensor Film (BFC) Singapura. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.medietilsynetRating |
string Rating video dari Medietilsynet, Norwegian Media Authority. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mekuRating |
string Rating video dari Kansallinen Audiovisuaalinen Instituutti (National Audiovisual Institute) Finlandia. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mibacRating |
string Rating video dari Ministero dei Beni e delle Attività Culturali e del Turismo (Italia). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mocRating |
string Rating Ministerio de Cultura (Kolombia) pada video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.moctwRating |
string Rating video dari Kementerian Kebudayaan Taiwan (BATASkur部). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mpaaRating |
string Rating Motion Picture Association of America (MPAA) video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mpaatRating |
string Rating Motion Picture Association of America untuk pratinjau dan cuplikan film. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.mtrcbRating |
string Rating video dari Movie and Television Review and Classification Board (Filipina). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.nbcRating |
string Rating video dari Maldives National Bureau of Classification. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.nfrcRating |
string Rating video dari Bulgarian National Film Center. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.nfvcbRating |
string Rating video dari National Film and Video Censors Board Nigeria. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.nkclvRating |
string Rating video dari centrs Nacionàlais Kino (National Film Centre of Latvia). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.oflcRating |
string Rating Office of Film and Literature Classification (OFLC - New Zealand) video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.pefilmRating |
string Rating video di Peru. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.resorteviolenciaRating |
string Rating video di Venezuela. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.rtcRating |
string Rating General Directorate of Radio, Television and Cinematography (Meksiko) video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.rteRating |
string Rating video dari Raidió Teilifís Éireann Irlandia. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.russiaRating |
string Rating National Film Registry of the Russian Federation (MKRF - Rusia) video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.skfilmRating |
string Rating video di Slovakia. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.smaisRating |
string Rating video di Islandia. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.smsaRating |
string Rating video dari Statens medieråd (National Media Council Swedia). Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.tvpgRating |
string Rating Panduan Orang Tua TV (TVPG) dari video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.contentRating.ytRating |
string Rating yang digunakan YouTube untuk mengidentifikasi konten yang dikenai pembatasan usia. Nilai yang valid untuk properti ini adalah:
|
contentDetails.projection |
string Menentukan format proyeksi video. Nilai yang valid untuk properti ini adalah:
|
contentDetails.hasCustomThumbnail |
boolean Menunjukkan apakah uploader video telah memberikan gambar thumbnail kustom untuk video atau tidak. Properti ini hanya dapat dilihat oleh uploader video. |
status |
object Objek status berisi informasi tentang status upload, pemrosesan, dan privasi video. |
status.uploadStatus |
string Status video yang diupload. Nilai yang valid untuk properti ini adalah:
|
status.failureReason |
string Nilai ini menjelaskan penyebab video gagal diupload. Properti ini hanya ada jika properti uploadStatus menunjukkan bahwa upload gagal.Nilai yang valid untuk properti ini adalah:
|
status.rejectionReason |
string Nilai 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 |
string Status privasi video. Nilai yang valid untuk properti ini adalah:
|
status.publishAt |
datetime Tanggal dan waktu video dijadwalkan untuk dipublikasikan. Kebijakan ini hanya dapat disetel jika status privasi video adalah pribadi. Nilai ini ditentukan dalam format ISO 8601. Perhatikan dua poin tambahan berikut tentang perilaku properti ini:
|
status.license |
string Lisensi video. Nilai yang valid untuk properti ini adalah:
|
status.embeddable |
boolean Nilai ini menunjukkan apakah video dapat disematkan di situs lain atau tidak. |
status.publicStatsViewable |
boolean Nilai 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 |
boolean Nilai ini menunjukkan apakah video ditetapkan sebagai ditujukan untuk anak-anak, dan berisi status "Dibuat untuk Anak-Anak" saat ini dari video. Misalnya, status mungkin 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 |
boolean Dalam permintaan videos.insert atau
videos.update , properti ini
memungkinkan pemilik channel untuk menetapkan video sebagai ditujukan untuk anak-anak. Dalam permintaan videos.list , nilai properti hanya ditampilkan jika pemilik saluran mengizinkan permintaan API. |
statistics |
object Objek statistics berisi statistik tentang video. |
statistics.viewCount |
unsigned long Berapa kali video telah ditonton. |
statistics.likeCount |
unsigned long Jumlah pengguna yang menunjukkan bahwa mereka menyukai video tersebut. |
statistics.dislikeCount |
unsigned long Catatan: Properti
statistics.dislikeCount telah
disetel sebagai pribadi mulai 13 Desember 2021. Artinya, properti akan disertakan dalam respons API hanya jika permintaan API diautentikasi oleh pemilik video. Lihat
histori revisi untuk informasi selengkapnya.Jumlah pengguna yang menunjukkan bahwa mereka tidak menyukai video tersebut. |
statistics.favoriteCount |
unsigned long Catatan: Properti ini sudah tidak digunakan lagi. Penghentian tersebut berlaku mulai 28 Agustus 2015. Nilai properti sekarang selalu ditetapkan ke 0 . |
statistics.commentCount |
unsigned long Jumlah komentar untuk video. |
player |
object Objek player berisi informasi yang akan Anda gunakan untuk memutar video di pemutar tersemat. |
player.embedHtml |
string Tag <iframe> yang menyematkan pemutar yang memutar video.
|
player.embedHeight |
long Tinggi pemutar sematan yang ditampilkan di properti player.embedHtml . Properti ini hanya ditampilkan jika permintaan menentukan nilai untuk parameter maxHeight dan/atau maxWidth serta rasio aspek video diketahui. |
player.embedWidth |
long Lebar pemutar sematan yang ditampilkan di properti player.embedHtml . Properti ini hanya ditampilkan jika permintaan menentukan nilai untuk parameter maxHeight dan/atau maxWidth serta rasio aspek video diketahui. |
topicDetails |
object Objek 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[] |
list Penting: Properti ini tidak digunakan lagi mulai 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[] |
list Daftar 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 Freebase dan Freebase API, ID topik mulai berfungsi secara berbeda sejak 27 Februari 2017. Pada saat itu, YouTube mulai menampilkan serangkaian kecil ID topik yang diseleksi. |
topicDetails.topicCategories[] |
list Daftar URL Wikipedia yang memberikan deskripsi tingkat tinggi tentang konten video. |
recordingDetails |
object Objek recordingDetails merangkum informasi tentang lokasi, tanggal, dan alamat tempat video direkam. |
recordingDetails.locationDescription |
string Properti ini tidak digunakan lagi mulai 1 Juni 2017. Lihat pengumuman penghentian untuk detail selengkapnya. Deskripsi teks untuk lokasi tempat video direkam. |
recordingDetails.location |
object Informasi geolokasi yang terkait dengan video. Perhatikan bahwa nilai properti turunan mengidentifikasi lokasi yang ingin dikaitkan oleh pemilik video dengan video. Nilai dapat diedit, dapat ditelusuri di video publik, dan dapat ditampilkan kepada pengguna untuk video publik. |
recordingDetails.location.latitude |
double Properti ini tidak digunakan lagi mulai 1 Juni 2017. Lihat pengumuman penghentian untuk detail selengkapnya. Lintang dalam derajat. |
recordingDetails.location.longitude |
double Properti ini tidak digunakan lagi mulai 1 Juni 2017. Lihat pengumuman penghentian untuk detail selengkapnya. Bujur dalam derajat. |
recordingDetails.location.altitude |
double Properti ini tidak digunakan lagi mulai 9 Juli 2018. Lihat pengumuman penghentian untuk detail selengkapnya. Ketinggian di atas elipsoid referensi, dalam meter. |
recordingDetails.recordingDate |
datetime Tanggal dan waktu video direkam. Nilai ditentukan dalam format ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ ). |
fileDetails |
object Objek fileDetails merangkum informasi tentang file video yang diupload ke YouTube, termasuk resolusi file, durasi, codec audio dan video, kecepatan bit streaming, serta lainnya. Data ini hanya dapat diambil oleh pemilik video.Objek fileDetails hanya akan ditampilkan jika properti processingDetails.fileAvailability memiliki nilai available . |
fileDetails.fileName |
string Nama file yang diupload. Bidang ini menunjukkan apakah file video atau jenis file lainnya telah diupload. |
fileDetails.fileSize |
unsigned long Ukuran file yang diupload dalam byte. Bidang ini menunjukkan apakah file video atau jenis file lainnya telah diupload. |
fileDetails.fileType |
string Jenis file yang diupload sebagaimana yang terdeteksi oleh mesin pemrosesan video YouTube. Saat ini, YouTube hanya memproses file video, tetapi kolom ini berisi file video atau jenis file lainnya yang telah diupload. Nilai yang valid untuk properti ini adalah:
|
fileDetails.container |
string Format penampung file video yang diupload. |
fileDetails.videoStreams[] |
list Daftar streaming video yang ada dalam file video yang diupload. Setiap item dalam daftar berisi metadata mendetail tentang streaming video. |
fileDetails.videoStreams[].widthPixels |
unsigned integer Lebar konten video yang dienkode dalam piksel. Anda dapat menghitung rasio aspek encoding video sebagai width_pixels / height_pixels . |
fileDetails.videoStreams[].heightPixels |
unsigned integer Tinggi konten video yang dienkode dalam piksel. |
fileDetails.videoStreams[].frameRateFps |
double Kecepatan frame streaming video, dalam frame per detik. |
fileDetails.videoStreams[].aspectRatio |
double Rasio aspek tampilan konten video, yang menentukan rasio aspek tempat video harus ditampilkan. |
fileDetails.videoStreams[].codec |
string Codec video yang digunakan streaming. |
fileDetails.videoStreams[].bitrateBps |
unsigned long Kecepatan bit streaming video, dalam bit per detik. |
fileDetails.videoStreams[].rotation |
string Jumlah yang diperlukan YouTube untuk merotasi konten sumber asli agar dapat menampilkan video dengan benar. Nilai yang valid untuk properti ini adalah:
|
fileDetails.videoStreams[].vendor |
string Nilai yang mengidentifikasi vendor video secara unik. Biasanya, nilainya adalah kode vendor yang terdiri dari empat huruf. |
fileDetails.audioStreams[] |
list Daftar streaming audio yang ada dalam file video yang diupload. Setiap item dalam daftar berisi metadata mendetail tentang streaming audio. |
fileDetails.audioStreams[].channelCount |
unsigned integer Jumlah saluran audio yang ada dalam streaming. |
fileDetails.audioStreams[].codec |
string Codec audio yang digunakan streaming. |
fileDetails.audioStreams[].bitrateBps |
unsigned long Kecepatan bit streaming audio, dalam bit per detik. |
fileDetails.audioStreams[].vendor |
string Nilai yang mengidentifikasi vendor video secara unik. Biasanya, nilainya adalah kode vendor yang terdiri dari empat huruf. |
fileDetails.durationMs |
unsigned long Durasi video yang diupload dalam milidetik. |
fileDetails.bitrateBps |
unsigned long Kecepatan bit gabungan (video dan audio) dari file video yang diupload dalam bit per detik. |
fileDetails.creationTime |
string Tanggal dan waktu file video yang diupload dibuat. Nilai ini ditentukan dalam format ISO 8601. Saat ini, format ISO 8601 berikut didukung:
|
processingDetails |
object Objek 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.Objek processingProgress dirancang untuk di-polling sehingga video yang diupload dapat melacak progres yang telah dibuat YouTube dalam memproses file video yang diupload. Data ini hanya dapat diambil oleh pemilik video. |
processingDetails.processingStatus |
string Status pemrosesan video. Nilai ini menunjukkan apakah YouTube dapat memproses video atau video masih diproses. Nilai yang valid untuk properti ini adalah:
|
processingDetails.processingProgress |
object Objek processingProgress berisi informasi tentang progres yang telah dicapai YouTube dalam memproses video. Nilai ini benar-benar hanya relevan jika status pemrosesan video adalah processing . |
processingDetails.processingProgress.partsTotal |
unsigned long Perkiraan jumlah total bagian yang perlu diproses untuk video. Jumlah tersebut mungkin diperbarui dengan perkiraan yang lebih tepat saat YouTube memproses video tersebut. |
processingDetails.processingProgress.partsProcessed |
unsigned long Jumlah bagian video yang telah diproses YouTube. Anda dapat memperkirakan persentase video yang telah diproses YouTube dengan menghitung: 100 * parts_processed / parts_total Perhatikan bahwa karena estimasi jumlah bagian dapat meningkat tanpa peningkatan jumlah bagian yang telah diproses, kemungkinan progres yang dihitung dapat menurun secara berkala saat YouTube memproses video. |
processingDetails.processingProgress.timeLeftMs |
unsigned long Estimasi jumlah waktu, dalam mildetik, yang diperlukan YouTube untuk menyelesaikan pemrosesan video. |
processingDetails.processingFailureReason |
string Alasan YouTube gagal memproses video tersebut. Properti ini hanya akan memiliki nilai jika nilai properti processingStatus adalah failed .Nilai yang valid untuk properti ini adalah:
|
processingDetails.fileDetailsAvailability |
string Nilai 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 |
string Nilai ini menunjukkan apakah mesin pemrosesan video telah memberikan saran yang dapat meningkatkan kemampuan YouTube dalam memproses video, peringatan yang menjelaskan masalah pemrosesan video, atau error yang menyebabkan masalah pemrosesan video. Anda dapat mengambil saran ini dengan meminta bagian suggestions pada permintaan videos.list() Anda. |
processingDetails.tagSuggestionsAvailability |
string Nilai 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 pada permintaan videos.list() Anda. |
processingDetails.editorSuggestionsAvailability |
string Nilai 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 pada permintaan videos.list() Anda. |
processingDetails.thumbnailsAvailability |
string Nilai ini menunjukkan apakah gambar thumbnail telah dibuat untuk video atau belum. |
suggestions |
object Objek 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[] |
list Daftar error yang akan mencegah YouTube memproses video yang diupload. Error ini menunjukkan bahwa, terlepas dari status pemrosesan video saat ini, pada akhirnya, status tersebut hampir dipastikan akan menjadi failed .Nilai yang valid untuk properti ini adalah:
|
suggestions.processingWarnings[] |
list Daftar alasan mengapa YouTube mengalami kesulitan dalam melakukan transcoding video yang diupload atau yang dapat mengakibatkan kesalahan transcoding. Peringatan ini dibuat sebelum YouTube benar-benar memproses file video yang diupload. Selain itu, pengujian ini mengidentifikasi masalah yang tidak selalu mengindikasikan bahwa pemrosesan video akan gagal, tetapi tindakan tersebut masih mungkin menyebabkan masalah seperti masalah sinkronisasi, artefak video, atau trek audio yang tidak ada. Nilai yang valid untuk properti ini adalah:
|
suggestions.processingHints[] |
list Daftar saran yang dapat meningkatkan kemampuan YouTube untuk memproses video. Nilai yang valid untuk properti ini adalah:
|
suggestions.tagSuggestions[] |
list Daftar tag kata kunci yang dapat ditambahkan ke metadata video untuk meningkatkan kemungkinan pengguna akan menemukan video Anda saat menelusuri atau menjelajah di YouTube. |
suggestions.tagSuggestions[].tag |
string Tag kata kunci yang disarankan untuk video. |
suggestions.tagSuggestions[].categoryRestricts[] |
list Serangkaian kategori video yang tag-nya relevan. Anda dapat menggunakan informasi ini untuk menampilkan saran tag yang sesuai berdasarkan kategori video yang dikaitkan oleh uploader video dengan video. Secara default, saran tag relevan untuk semua kategori jika tidak ada batasan yang ditentukan untuk kata kunci. |
suggestions.editorSuggestions[] |
list Daftar operasi pengeditan video yang dapat meningkatkan kualitas video atau pengalaman pemutaran dari video yang diupload. Nilai yang valid untuk properti ini adalah:
|
liveStreamingDetails |
object Objek liveStreamingDetails berisi metadata tentang siaran video live. Objek hanya akan ada di resource video jika video merupakan live streaming yang akan datang, live, atau sudah selesai. |
liveStreamingDetails.actualStartTime |
datetime Waktu siaran benar-benar dimulai. Nilai ini ditentukan dalam format ISO 8601. Nilai ini tidak akan tersedia hingga siaran dimulai. |
liveStreamingDetails.actualEndTime |
datetime Waktu siaran benar-benar berakhir. Nilai ini ditentukan dalam format ISO 8601. Nilai ini tidak akan tersedia hingga siaran selesai. |
liveStreamingDetails.scheduledStartTime |
datetime Waktu siaran dijadwalkan untuk dimulai. Nilai ini ditentukan dalam format ISO 8601. |
liveStreamingDetails.scheduledEndTime |
datetime Waktu siaran dijadwalkan untuk berakhir. Nilai ini ditentukan dalam format ISO 8601. Jika nilai kosong atau properti tidak ada, siaran akan dijadwalkan untuk berlanjut tanpa batas. |
liveStreamingDetails.concurrentViewers |
unsigned long Jumlah penonton yang saat ini menonton siaran. Properti dan nilainya akan ada jika siaran memiliki penonton saat ini dan pemilik siaran belum menyembunyikan jumlah penayangan untuk video. Perhatikan bahwa YouTube akan berhenti melacak jumlah penonton serentak untuk siaran ketika siaran berakhir. Jadi, properti ini tidak akan mengidentifikasi jumlah penonton yang menonton video live streaming yang diarsipkan yang sudah berakhir. Jumlah penonton serentak yang ditampilkan YouTube Data API mungkin berbeda dari jumlah penonton serentak yang telah diproses dan dijadikan bukan spam yang tersedia melalui YouTube Analytics. Pelajari lebih lanjut metrik live streaming di Pusat Bantuan YouTube.
|
liveStreamingDetails.activeLiveChatId |
string ID live chat yang sedang aktif yang dilampirkan pada video ini. Kolom ini hanya diisi jika video merupakan live streaming yang saat ini memiliki live chat. Setelah transisi siaran untuk menyelesaikan kolom ini akan dihapus dan live chat akan ditutup. Untuk siaran terus-menerus, ID live chat tidak akan lagi dikaitkan dengan video ini, melainkan dengan video baru yang ditampilkan di halaman persisten. |
localizations |
object Objek localizations berisi terjemahan metadata video. |
localizations.(key) |
object Bahasa teks yang dilokalkan yang terkait dengan nilai kunci. Nilainya adalah string yang berisi kode bahasa BCP-47. |
localizations.(key).title |
string Judul video yang dilokalkan. |
localizations.(key).description |
string Deskripsi video yang dilokalkan. |