Videos

Semua video yang diupload melalui endpoint videos.insert dari project API yang belum diverifikasi yang dibuat setelah 28 Juli 2020 akan dibatasi ke mode tampilan 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 mendukung metode berikut untuk resource videos:

getRating
Mengambil rating yang diberikan oleh pengguna resmi ke daftar video yang ditentukan. Coba sekarang.
list
Menampilkan daftar video yang cocok dengan parameter permintaan API. Coba sekarang.
masukkan
Mengupload video ke YouTube dan, jika ingin, menetapkan metadata video.
perbarui
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.
laporkanPenyalahgunaan
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 adalah youtube#video.
etag etag
Etag resource 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. Perlu diperhatikan bahwa waktu ini mungkin berbeda dengan waktu upload video. Misalnya, jika video diupload sebagai video pribadi kemudian disetel menjadi publik di lain waktu, properti ini akan menentukan waktu video menjadi publik.

Ada beberapa kasus khusus:
  • Jika video diupload sebagai video pribadi dan metadata video diambil oleh pemilik channel, nilai properti akan menentukan tanggal dan waktu saat video diupload.
  • Jika video diupload sebagai video tidak publik, nilai properti juga menentukan tanggal dan waktu saat video diupload. Dalam hal ini, siapa saja yang mengetahui ID video unik dari video tersebut dapat mengambil metadata video.
Nilai ditentukan dalam format ISO 8601.
snippet.channelId string
ID yang digunakan YouTube untuk mengidentifikasi channel tempat video diupload 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 ini 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 di 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:
  • default – Gambar thumbnail default. Thumbnail default untuk video – atau resource yang merujuk pada video, seperti item playlist atau hasil penelusuran – memiliki lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk channel adalah lebar 88 piksel dan tinggi 88 piksel.
  • medium – Versi gambar thumbnail yang beresolusi lebih tinggi. Untuk video (atau resource yang merujuk ke video), gambar ini memiliki lebar 320px dan tinggi 180px. Untuk channel, gambar ini memiliki lebar 240px dan tinggi 240px.
  • high – Versi thumbnail dengan resolusi tinggi. Untuk video (atau resource yang merujuk pada video), gambar ini memiliki lebar 480px dan tinggi 360px. Untuk channel, gambar ini memiliki lebar 800 piksel dan tinggi 800 piksel.
  • standard – Versi gambar thumbnail beresolusi lebih tinggi daripada gambar resolusi high. Gambar ini tersedia untuk beberapa video dan resource lain yang mengacu pada video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 640 piksel dan tinggi 480 piksel.
  • maxres – Versi gambar thumbnail tertinggi. Ukuran gambar ini tersedia untuk beberapa video dan resource lain yang merujuk ke video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 1280 piksel dan tinggi 720 piksel.
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 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 terkait cara penghitungan batas karakter:
  • Nilai properti adalah daftar, dan koma di antara item dalam daftar akan dihitung terhadap batas.
  • Jika tag berisi spasi, server API akan menangani nilai tag seolah-olah diberi tanda kutip, dan tanda kutip diperhitungkan dalam batas karakter. Jadi, untuk tujuan batas karakter, tag Foo-Baz berisi tujuh karakter, tetapi tag Foo Baz berisi sembilan karakter.
snippet.categoryId string
Kategori 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 string
Menunjukkan apakah video merupakan live streaming yang akan datang/aktif. Atau, "tidak ada" jika video bukan merupakan live streaming mendatang/aktif.

Nilai yang valid untuk properti ini adalah:
  • live
  • none
  • upcoming
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.
  • Teks yang dilokalkan ditampilkan dalam cuplikan resource jika permintaan videos.list menggunakan parameter hl untuk menentukan bahasa yang teksnya harus dilokalkan dan teks yang dilokalkan tersedia dalam bahasa itu.
  • Metadata untuk bahasa default ditampilkan jika nilai parameter hl tidak ditentukan atau nilai ditentukan, tetapi metadata yang dilokalkan tidak tersedia untuk bahasa yang ditentukan.
Properti ini berisi nilai hanya baca. Gunakan objek 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 digunakan 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 adalah durasi ISO 8601. Misalnya, untuk video yang berdurasi minimal satu menit dan berdurasi kurang dari satu jam, durasinya dalam format PT#M#S, dengan huruf PT menunjukkan bahwa nilai menentukan periode waktu, dan huruf M serta S masing-masing 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 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 video berdurasi minimal satu hari, huruf P dan T dipisahkan, dan format nilainya adalah P#DT#H#M#S. Harap baca 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:
  • hd
  • sd
contentDetails.caption string
Menunjukkan apakah teks tersedia untuk video tersebut.

Nilai yang valid untuk properti ini adalah:
  • false
  • true
contentDetails.licensedContent boolean
Menunjukkan apakah video mewakili konten berlisensi, yang berarti konten tersebut 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 ini 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 negara tidak tercantum dalam nilainya, video akan diblokir agar tidak muncul di negara tersebut. Jika properti ini ada dan berisi daftar kosong, video tersebut 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 dilihat di negara tersebut. Jika properti ini ada dan berisi daftar kosong, video dapat ditonton di semua negara.
contentDetails.contentRating object
Menentukan rating yang diterima video berdasarkan berbagai skema rating.
contentDetails.contentRating.acbRating string
Rating Australian Classification Board (ACB) atau Australian Communications and Media Authority (ACMA) video. Rating ACMA digunakan untuk mengklasifikasikan program televisi anak.

Nilai yang valid untuk properti ini adalah:
  • acbC – Program yang telah diberi klasifikasi C oleh Australian Communications and Media Authority. Program ini ditujukan untuk anak-anak (selain anak prasekolah) yang berusia di bawah 14 tahun.
  • acbE – E
  • acbG – G
  • acbM – J
  • acbMa15plus – MA15+
  • acbP – Program yang telah diberi klasifikasi P oleh Australian Communications and Media Authority. Program ini ditujukan untuk anak-anak prasekolah.
  • acbPg – PG
  • acbR18plus – R18+
  • acbUnrated
contentDetails.contentRating.agcomRating string
Rating video dari Autorità per le Garanzie nelle Comunicazioni Italia (AGCOM).

Nilai yang valid untuk properti ini adalah:
  • agcomT – T
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
Rating Anatel (Asociación Nacional de Televisión) video untuk televisi Chili.

Nilai yang valid untuk properti ini adalah:
  • anatelA – A
  • anatelF – F
  • anatelI – I
  • anatelI10 – I-10
  • anatelI12 – I-12
  • anatelI7 – I-7
  • anatelR – R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
Rating British Board of Film Classification (BBFC) video.

Nilai yang valid untuk properti ini adalah:
  • bbfc12 - 12
  • bbfc12a – 12 A
  • bbfc15 - 15
  • bbfc18 - 18 tahun
  • bbfcPg – PG
  • bbfcR18 – R18
  • bbfcU – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
Rating video dari Dewan Film dan Sensor Video Thailand.

Nilai yang valid untuk properti ini adalah:
  • bfvc13 - 13
  • bfvc15 - 15
  • bfvc18 - 18 tahun
  • bfvc20 - 20
  • bfvcB – B
  • bfvcE – E
  • bfvcG – G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
Rating video dari Dewan Klasifikasi Media Austria (Bundesministerium für Unterricht, Kunst und Kultur).

Nilai yang valid untuk properti ini adalah:
  • bmukk10 – 10+
  • bmukk12 – 12+
  • bmukk14 – 14+
  • bmukk16 – 16 tahun ke atas
  • bmukk6 – 6+
  • bmukk8 – 8+
  • bmukkAa – Tidak dibatasi
  • bmukkUnrated
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 adalah:
  • catv14plus – 14+
  • catv18plus – 18 tahun ke atas
  • catvC – C
  • catvC8 – C8
  • catvG – G
  • catvPg – PG
  • catvUnrated
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 adalah:
  • catvfr13plus – 13+
  • catvfr16plus – 16 tahun ke atas
  • catvfr18plus – 18 tahun ke atas
  • catvfr8plus – 8+
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
Rating Central Board of Film (CBFC - India) dari video.

Nilai yang valid untuk properti ini adalah:
  • cbfcA – A
  • cbfcS – S
  • cbfcU – U
  • cbfcUnrated
  • cbfcUA – U/A
  • cbfcUA7plus – U/A
  • cbfcUA13plus – U/A
  • cbfcUA16plus – U/A
contentDetails.contentRating.cccRating string
Video Consejo de Calificación Cinematográfica (Chile) video.

Nilai yang valid untuk properti ini adalah:
  • ccc14 – 14+
  • ccc18 – 18 tahun ke atas
  • ccc18s – 18 tahun ke atas - contenido pornográfico
  • ccc18v – 18 tahun ke atas - contenido excesivamente kekerasano
  • ccc6 – 6+ - Ketidaknyamanan para menores de 7 años
  • cccTe – Edotador daftar tugas
  • cccUnrated
contentDetails.contentRating.cceRating string
Rating video dari Comissão de Classificação de Espect îculos dari Portugal.

Nilai yang valid untuk properti ini adalah:
  • cceM12 - 12
  • cceM14 - 14 tahun
  • cceM16 - 16 tahun
  • cceM18 - 18 tahun
  • cceM4 - 4
  • cceM6 - 6
  • cceUnrated
contentDetails.contentRating.chfilmRating string
Rating video di Swiss.

Nilai yang valid untuk properti ini adalah:
  • chfilm0 - 0
  • chfilm12 - 12
  • chfilm16 - 16 tahun
  • chfilm18 - 18 tahun
  • chfilm6 - 6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
Rating Sistem Rating Video (CHVRS) Kanada.

Nilai yang valid untuk properti ini adalah:
  • chvrs14a – 14 A
  • chvrs18a – 18 A
  • chvrsE – E
  • chvrsG – G
  • chvrsPg – PG
  • chvrsR – R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
Rating video dari Commission de Contrôle des Films (Belgia).

Nilai yang valid untuk properti ini adalah:
  • cicfE – E
  • cicfKntEna – KNT/ENA
  • cicfKtEa – KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
Rating video dari CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) Rumania.

Nilai yang valid untuk properti ini adalah:
  • cna12 - 12
  • cna15 - 15
  • cna18 - 18 tahun
  • cna18plus – 18 tahun ke atas
  • cnaAp – AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
Sistem rating di Prancis - Commission deClassification Cinematographique

Nilai yang valid untuk properti ini adalah:
  • cnc10 - 10
  • cnc12 - 12
  • cnc16 - 16 tahun
  • cnc18 - 18 tahun
  • cncE – E
  • cncT – T
  • cncUnrated
contentDetails.contentRating.csaRating string
Rating video dari Conseil Prancis supérieur de l?audiovisuel, yang memberi rating konten siaran.

Nilai yang valid untuk properti ini adalah:
  • csa10 - 10
  • csa12 - 12
  • csa16 - 16 tahun
  • csa18 - 18 tahun
  • csaInterdiction – Interdiksi
  • csaT – T
  • csaUnrated
contentDetails.contentRating.cscfRating string
Rating video dari Commission s pengawasan de laClassification des films (CSCF) Luksemburg.

Nilai yang valid untuk properti ini adalah:
  • cscf12 - 12
  • cscf16 - 16 tahun
  • cscf18 - 18 tahun
  • cscf6 - 6
  • cscf9 - 9
  • cscfA – A
  • cscfAl – AL
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
Rating video di Republik Ceko.

Nilai yang valid untuk properti ini adalah:
  • czfilm12 - 12
  • czfilm14 - 14 tahun
  • czfilm18 - 18 tahun
  • czfilmU – U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
Video Dismissamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brasil).

Nilai yang valid untuk properti ini adalah:
  • djctq10 - 10
  • djctq12 - 12
  • djctq14 - 14 tahun
  • djctq16 - 16 tahun
  • djctq18 - 18 tahun
  • djctqL – L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
Alasan yang menyebabkan video tersebut mendapatkan rating DJCQT (Brasil).
contentDetails.contentRating.ecbmctRating string
Sistem rating di Turki - Dewan Evaluasi dan Klasifikasi dari Kementerian Kebudayaan dan Pariwisata

Nilai yang valid untuk properti ini adalah:
  • ecbmct13a – 13 A
  • ecbmct13plus – 13+
  • ecbmct15a – 15 A
  • ecbmct15plus – 15 tahun ke atas
  • ecbmct18plus – 18 tahun ke atas
  • ecbmct7a – 7 A
  • ecbmct7plus – 7+
  • ecbmctG – G
  • ecbmctUnrated
  • ecbmct6a – 6 A
  • ecbmct6plus – 6+
  • ecbmct10a – 10 A
  • ecbmct10plus – 10+
  • ecbmct16plus – 16 tahun ke atas
contentDetails.contentRating.eefilmRating string
Rating video di Estonia.

Nilai yang valid untuk properti ini adalah:
  • eefilmK12 – K-12
  • eefilmK14 – K-14
  • eefilmK16 – K-16
  • eefilmK6 – K-6
  • eefilmL – L
  • eefilmMs12 – MS-12
  • eefilmMs6 – MS-6
  • eefilmPere – Pere
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
Rating video di Mesir.

Nilai yang valid untuk properti ini adalah:
  • egfilm18 - 18 tahun
  • egfilmBn – BN
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
Rating Eirin (映倫) video. Eirin adalah sistem rating Jepang.

Nilai yang valid untuk properti ini adalah:
  • eirinG – G
  • eirinPg12 – PG-12
  • eirinR15plus – R15+
  • eirinR18plus – R18+
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
Rating video dari Film Censorship Board Malaysia.

Nilai yang valid untuk properti ini adalah:
  • fcbm18 - 18 tahun
  • fcbm18pa – 18 PA
  • fcbm18pl – 18 PL
  • fcbm18sg – 18 SG
  • fcbm18sx – 18 SX
  • fcbmP13 – P13
  • fcbmPg13 – PG13
  • fcbmU – U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
Rating video dari Kantor untuk Film, Koran, dan Artikel Artikel Hong Kong.

Nilai yang valid untuk properti ini adalah:
  • fcoI – I
  • fcoIi – II
  • fcoIia – IIA
  • fcoIib – IIB
  • fcoIii – III
  • fcoUnrated
contentDetails.contentRating.fmocRating string
Properti ini tidak digunakan lagi mulai 2 November 2015. Gunakan properti contentDetails.contentRating.cncRating sebagai gantinya.

Rating Video Centre cinéma et de l'image animé (Kementerian Kebudayaan Prancis) video.

Nilai yang valid untuk properti ini adalah:
  • fmoc10 - 10
  • fmoc12 - 12
  • fmoc16 - 16 tahun
  • fmoc18 - 18 tahun
  • fmocE – E
  • fmocU – U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
Rating video dari Film dan Dewan Publikasi Afrika Selatan.

Nilai yang valid untuk properti ini adalah:
  • fpb10 - 10
  • fpb1012Pg – 10-12 PG
  • fpb13 - 13
  • fpb16 - 16 tahun
  • fpb18 - 18 tahun
  • fpb79Pg – 7 - PG
  • fpbA – A
  • fpbPg – PG
  • fpbUnrated
  • fpbX18 – X18
  • fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[] list
Alasan yang menyebabkan video tersebut mendapatkan rating FPB (Afrika Selatan).
contentDetails.contentRating.fskRating string
Video Frei Willige Selbstkontrolle der Filmwirtschaft (FSK - Jerman) video.

Nilai yang valid untuk properti ini adalah:
  • fsk0 – FSK 0
  • fsk12 – FSK 12
  • fsk16 – FSK 16
  • fsk18 – FSK 18
  • fsk6 – FSK 6
  • fskUnrated
contentDetails.contentRating.grfilmRating string
Rating video di Yunani.

Nilai yang valid untuk properti ini adalah:
  • grfilmE – E
  • grfilmK – K
  • grfilmK12 – K-12
  • grfilmK13 – K-13
  • grfilmK15 – K-15
  • grfilmK17 – K-17
  • grfilmK18 – K-18
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
Rating Instituto de la Cinematographía y de las Artes Audiovisuales (ICAA - Spanyol) video.

Nilai yang valid untuk properti ini adalah:
  • icaa12 - 12
  • icaa13 - 13
  • icaa16 - 16 tahun
  • icaa18 - 18 tahun
  • icaa7 - 7
  • icaaApta – APTA
  • icaaUnrated
  • icaaX – X
contentDetails.contentRating.ifcoRating string
Rating Kantor Klasifikasi Film Irlandia (IFCO - Irlandia) video. Lihat situs IFCO untuk mengetahui informasi selengkapnya.

Nilai yang valid untuk properti ini adalah:
  • ifco12 - 12
  • ifco12a – 12 A
  • ifco15 - 15
  • ifco15a – 15 A
  • ifco16 - 16 tahun
  • ifco18 - 18 tahun
  • ifcoG – G
  • ifcoPg – PG
  • ifcoUnrated
contentDetails.contentRating.ilfilmRating string
Rating video di Israel.

Nilai yang valid untuk properti ini adalah:
  • ilfilm12 - 12
  • ilfilm16 - 16 tahun
  • ilfilm18 - 18 tahun
  • ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
Rating VisualAA (Instituto Nacional de Cine y Artes - Argentina) pada video.

Nilai yang valid untuk properti ini adalah:
  • incaaAtp – ATP (Apta para todo publico)
  • incaaC – X (Solo apta para mayores de 18 años, de exhibición condicionada)
  • incaaSam13 – 13 (Solo apta para mayores de 13 años)
  • incaaSam16 – 16 (Solo apta para mayores de 16 años)
  • incaaSam18 – 18 (Solo apta para mayores de 18 años)
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
Rating video dari Kenya Film Classification Board.

Nilai yang valid untuk properti ini adalah:
  • kfcb16plus - 16 tahun
  • kfcbG – GE
  • kfcbPg – PG
  • kfcbR - 18 tahun
  • kfcbUnrated
contentDetails.contentRating.kijkwijzerRating string
voor de Classificatie van Audiovisuele Media (Belanda).

Nilai yang valid untuk properti ini adalah:
  • kijkwijzer12 - 12
  • kijkwijzer16 - 16 tahun
  • kijkwijzer18 - 18 tahun
  • kijkwijzer6 - 6
  • kijkwijzer9 - 9
  • kijkwijzerAl – AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
Rating Korea Media Rating Board (영苯물등苯위이회) video tersebut. KMRB memberikan rating video di Korea Selatan.

Nilai yang valid untuk properti ini adalah:
  • kmrb12plus – 12서 이서 상람미
  • kmrb15plus – 15미 이상 상람미
  • kmrbAll – 전체苯람미
  • kmrbR – 청소년 관람불미
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
Rating video dari Lembaga Sensor Film Indonesia.

Nilai yang valid untuk properti ini adalah:
  • lsf13 - 13
  • lsf17 - 17
  • lsf21 - 21
  • lsfA – A
  • lsfBo – BO
  • lsfD – H
  • lsfR – R
  • lsfSu – SU
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
Rating video dari Dewan Klasifikasi Usia Film Malta.

Nilai yang valid untuk properti ini adalah:
  • mccaa12 - 12
  • mccaa12a – 12 A
  • mccaa14 – 14 - rating ini dihapus dari struktur klasifikasi baru yang diperkenalkan pada tahun 2013.
  • mccaa15 - 15
  • mccaa16 – 16 - rating ini dihapus dari struktur klasifikasi baru yang diperkenalkan pada tahun 2013.
  • mccaa18 - 18 tahun
  • mccaaPg – PG
  • mccaaU – U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
Rating video dari Dewan Film Anak-Anak dan Pemuda dari Institut Film Denmark (Det Danske Filminstitut).

Nilai yang valid untuk properti ini adalah:
  • mccyp11 - 11
  • mccyp15 - 15
  • mccyp7 - 7
  • mccypA – A
  • mccypUnrated
contentDetails.contentRating.mcstRating string
Sistem rating video untuk Vietnam - MCST

Nilai yang valid untuk properti ini adalah:
  • mcst0 - 0
  • mcst16plus – 16 tahun ke atas
  • mcstC13 – C13
  • mcstC16 – C16
  • mcstC18 – C18
  • mcstP – P
  • mcstUnrated
contentDetails.contentRating.mdaRating string
Rating video dari Media Development Authority (MDA) Singapura dan, khususnya, adalah Board of Film Censors (BFC).

Nilai yang valid untuk properti ini adalah:
  • mdaG – G
  • mdaM18 – M18
  • mdaNc16 – NC16
  • mdaPg – PG
  • mdaPg13 – PG13
  • mdaR21 – R21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
Rating video dari Medietilsynet, Otoritas Media Norwegia.

Nilai yang valid untuk properti ini adalah:
  • medietilsynet11 - 11
  • medietilsynet12 - 12
  • medietilsynet15 - 15
  • medietilsynet18 - 18 tahun
  • medietilsynet6 - 6
  • medietilsynet7 - 7
  • medietilsynet9 - 9
  • medietilsynetA – A
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating string
Rating video dari Kansallinen Audiovisuaalinen Instituutti dari Finlandia (National Audiovisual Institute).

Nilai yang valid untuk properti ini adalah:
  • meku12 - 12
  • meku16 - 16 tahun
  • meku18 - 18 tahun
  • meku7 - 7
  • mekuS – S
  • mekuUnrated
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:
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
Rating Ministerio de Cultura (Kolombia) video.

Nilai yang valid untuk properti ini adalah:
  • moc12 - 12
  • moc15 - 15
  • moc18 - 18 tahun
  • moc7 - 7
  • mocBanned – Diblokir
  • mocE – E
  • mocT – T
  • mocUnrated
  • mocX – X
contentDetails.contentRating.moctwRating string
Rating video dari Ministry of Culture Taiwan (文化部).

Nilai yang valid untuk properti ini adalah:
  • moctwG – G
  • moctwP – P
  • moctwPg – PG
  • moctwR – R
  • moctwR12 – R-12
  • moctwR15 – R-15
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
Rating Motion Picture Association of America (MPAA) video.

Nilai yang valid untuk properti ini adalah:
  • mpaaG – G
  • mpaaNc17 – NC-17
  • mpaaPg – PG
  • mpaaPg13 – PG-13
  • mpaaR – R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
Rating Motion Picture Association of America untuk cuplikan dan pratinjau film.

Nilai yang valid untuk properti ini adalah:
  • mpaatGb – GB (Green Band - Disetujui untuk semua audiens)
  • mpaatRb – RB (Red Band - Direkomendasikan untuk usia 17+)
contentDetails.contentRating.mtrcbRating string
Rating video dari Movie and Television Review and Classification Board (Filipina).

Nilai yang valid untuk properti ini adalah:
  • mtrcbG – G
  • mtrcbPg – PG
  • mtrcbR13 – R-13
  • mtrcbR16 – R-16
  • mtrcbR18 – R-18
  • mtrcbUnrated
  • mtrcbX – X
contentDetails.contentRating.nbcRating string
Rating video dari Biro Klasifikasi Nasional Maladewa.

Nilai yang valid untuk properti ini adalah:
  • nbc12plus – 12+
  • nbc15plus – 15 tahun ke atas
  • nbc18plus – 18 tahun ke atas
  • nbc18plusr – 18+ R
  • nbcG – G
  • nbcPg – PG
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
Rating video dari Bulgarian National Film Center.

Nilai yang valid untuk properti ini adalah:
  • nfrcA – A
  • nfrcB – B
  • nfrcC – C
  • nfrcD – H
  • nfrcUnrated
  • nfrcX – X
contentDetails.contentRating.nfvcbRating string
Rating video dari National Film and Video Censors Board Nigeria.

Nilai yang valid untuk properti ini adalah:
  • nfvcb12 - 12
  • nfvcb12a – 12 A
  • nfvcb15 - 15
  • nfvcb18 - 18 tahun
  • nfvcbG – G
  • nfvcbPg – PG
  • nfvcbRe – RE
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
Rating video dari Nacionãlais Kino centr (National Film Center of Latvia).

Nilai yang valid untuk properti ini adalah:
  • nkclv12plus – 12+
  • nkclv18plus – 18 tahun ke atas
  • nkclv7plus – 7+
  • nkclvU – U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
Rating Klasifikasi Film dan Klasifikasi Sastra (OFLC - Selandia Baru).

Nilai yang valid untuk properti ini adalah:
  • oflcG – G
  • oflcM – J
  • oflcPg – PG
  • oflcR13 - R13
  • oflcR15 – R15
  • oflcR16 – R16
  • oflcR18 – R18
  • oflcRp13 – RP13
  • oflcRp16 – RP16
  • oflcUnrated
contentDetails.contentRating.pefilmRating string
Rating video di Peru.

Nilai yang valid untuk properti ini adalah:
  • pefilm14 - 14 tahun
  • pefilm18 - 18 tahun
  • pefilmPg – PG
  • pefilmPt – PT
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
Rating video di Venezuela.

Nilai yang valid untuk properti ini adalah:
  • resorteviolenciaA – A
  • resorteviolenciaB – B
  • resorteviolenciaC – C
  • resorteviolenciaD – H
  • resorteviolenciaE – E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
Rating Direktorat Umum Radio, Televisi, dan Sinematografi (Meksiko) video tersebut.

Nilai yang valid untuk properti ini adalah:
  • rtcA – A
  • rtcAa – AA
  • rtcB – B
  • rtcB15 – B15
  • rtcC – C
  • rtcD – H
  • rtcUnrated
contentDetails.contentRating.rteRating string
Rating video dari Raidió Teilifís Éireann Irlandia.

Nilai yang valid untuk properti ini adalah:
  • rteCh – CH
  • rteGa – GA
  • rteMa – D
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
Video National Film Registry of the Russian Federation (MKRF - Russian).

Nilai yang valid untuk properti ini adalah:
  • russia0 – 0+
  • russia12 – 12+
  • russia16 – 16 tahun ke atas
  • russia18 – 18 tahun ke atas
  • russia6 – 6+
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
Rating video di Slovakia.

Nilai yang valid untuk properti ini adalah:
  • skfilmG – G
  • skfilmP2 – P2
  • skfilmP5 – P5
  • skfilmP8 – P8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
Rating video di Islandia.

Nilai yang valid untuk properti ini adalah:
  • smais12 - 12
  • smais14 - 14 tahun
  • smais16 - 16 tahun
  • smais18 - 18 tahun
  • smais7 - 7
  • smaisL – L
  • smaisUnrated
contentDetails.contentRating.smsaRating string
Rating video dari Statens medieråd (Sweden's National Media Council).

Nilai yang valid untuk properti ini adalah:
  • smsa11 - 11
  • smsa15 - 15
  • smsa7 - 7
  • smsaA – Semua usia
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
Rating Pedoman Orang Tua TV (TVPG) video.

Nilai yang valid untuk properti ini adalah:
  • tvpgG – TV-G
  • tvpgMa – TV-MA
  • tvpgPg – TV-PG
  • tvpgUnrated
  • tvpgY – TV-Y
  • tvpgY7 – TV-Y7
  • tvpgY7Fv – TV-Y7-FV
  • pg14 – TV-14
contentDetails.contentRating.ytRating string
Rating yang digunakan YouTube untuk mengidentifikasi konten yang dikenai pembatasan usia.

Nilai yang valid untuk properti ini adalah:
  • ytAgeRestricted
contentDetails.projection string
Menentukan format proyeksi video.

Nilai yang valid untuk properti ini adalah:
  • 360
  • rectangular
contentDetails.hasCustomThumbnail boolean
Menunjukkan apakah uploader video telah menyediakan gambar thumbnail kustom untuk video. 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:
  • deleted
  • failed
  • processed
  • rejected
  • uploaded
status.failureReason string
Nilai ini menjelaskan alasan video gagal diupload. Properti ini hanya ada jika properti uploadStatus menunjukkan bahwa upload gagal.

Nilai yang valid untuk properti ini adalah:
  • codec
  • conversion
  • emptyFile
  • invalidFile
  • tooSmall
  • uploadAborted
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:
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
Status privasi video.

Nilai yang valid untuk properti ini adalah:
  • private
  • public
  • unlisted
status.publishAt datetime
Tanggal dan waktu saat video dijadwalkan untuk dipublikasikan. Setelan ini hanya dapat disetel jika status privasi video disetel ke pribadi. Nilai ditetapkan dalam format ISO 8601. Perhatikan dua poin tambahan berikut tentang perilaku properti ini:
  • Jika Anda menetapkan nilai properti ini saat memanggil metode videos.update, Anda juga harus menetapkan nilai properti status.privacyStatus ke private meskipun video sudah disetel ke pribadi.
  • Jika permintaan Anda menjadwalkan video untuk dipublikasikan pada waktu tertentu, video tersebut akan segera dipublikasikan. Dengan demikian, efek dari menetapkan properti status.publishAt ke tanggal dan waktu yang lalu sama dengan mengubah privacyStatus video dari private menjadi public.
status.license string
Lisensi video.

Nilai yang valid untuk properti ini adalah:
  • creativeCommon
  • youtube
status.embeddable boolean
Nilai ini menunjukkan apakah video dapat disematkan di situs lain.
status.publicStatsViewable boolean
Nilai ini menunjukkan apakah statistik video yang diperluas di halaman tonton video dapat dilihat oleh publik atau tidak. Secara default, statistik tersebut dapat dilihat, dan statistik seperti jumlah penayangan dan rating video akan tetap terlihat secara 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. Misalnya, status dapat ditentukan berdasarkan nilai properti selfDeclaredMadeForKids. Buka 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 menetapkan video sebagai ditujukan untuk anak-anak. Dalam permintaan videos.list, nilai properti hanya dikembalikan jika pemilik saluran mengizinkan permintaan API.
statistics object
Objek statistics berisi statistik tentang video.
statistics.viewCount unsigned long
Frekuensi video ditonton.
statistics.likeCount unsigned long
Jumlah pengguna yang telah menunjukkan bahwa mereka menyukai video tersebut.
statistics.dislikeCount unsigned long
Catatan: Properti statistics.dislikeCount telah dijadikan pribadi per 13 Desember 2021. Artinya, properti disertakan dalam respons API hanya jika permintaan API diautentikasi oleh pemilik video. Lihat histori peninjauan untuk informasi selengkapnya.

Jumlah pengguna yang telah menunjukkan bahwa mereka tidak menyukai video.
statistics.favoriteCount unsigned long
Catatan: Properti ini tidak digunakan lagi. Penghentian ini 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.
  • Jika permintaan API untuk mengambil resource menentukan nilai untuk parameter maxHeight dan/atau maxWidth, ukuran pemutar tersemat akan diskalakan untuk memenuhi persyaratan maxHeight dan/atau maxWidth.
  • Jika rasio lebar tinggi video tidak diketahui, pemutar tersemat akan menggunakan format 4:3 secara default.
player.embedHeight long
Tinggi pemutar tersemat yang ditampilkan dalam properti player.embedHtml. Properti ini hanya ditampilkan jika permintaan menentukan nilai untuk parameter maxHeight dan/atau maxWidth dan rasio lebar tinggi video diketahui.
player.embedWidth long
Lebar pemutar sematan yang ditampilkan dalam properti player.embedHtml. Properti ini hanya ditampilkan jika permintaan menentukan nilai untuk parameter maxHeight dan/atau maxWidth dan rasio lebar tinggi video diketahui.
topicDetails object
Objek topicDetails mengenkapsulasi informasi tentang topik yang terkait dengan video.

Penting: Lihat definisi properti topicDetails.relevantTopicIds[] dan topicDetails.topicIds[] serta histori peninjauan untuk mengetahui detail selengkapnya tentang perubahan mendatang yang terkait dengan ID topik.
topicDetails.topicIds[] list
Penting: Properti ini tidak digunakan lagi mulai 10 November 2016. API tidak lagi menampilkan nilai untuk properti ini, dan setiap topik 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. API ini akan didukung hingga 10 November 2017.

Penting: Karena penghentian Freebase dan Freebase API, ID topik mulai berfungsi secara berbeda mulai 27 Februari 2017. Pada saat itu, YouTube mulai menampilkan sekumpulan kecil ID topik yang diseleksi.

topicDetails.topicCategories[] list
Daftar URL Wikipedia yang memberikan deskripsi tingkat tinggi tentang konten video.
recordingDetails object
Objek recordingDetails mengenkapsulasi informasi tentang lokasi, tanggal, dan alamat tempat video direkam.
recordingDetails.locationDescription string
Properti ini tidak digunakan lagi mulai 1 Juni 2017. Lihat pengumuman penghentian penggunaan untuk detail selengkapnya.

Deskripsi teks tentang 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 tersebut. Nilai dapat diedit, dapat ditelusuri di video publik, dan mungkin ditampilkan kepada pengguna untuk video publik.
recordingDetails.location.latitude double
Properti ini tidak digunakan lagi mulai 1 Juni 2017. Lihat pengumuman penghentian penggunaan untuk detail selengkapnya.

Lintang dalam derajat.
recordingDetails.location.longitude double
Properti ini tidak digunakan lagi mulai 1 Juni 2017. Lihat pengumuman penghentian penggunaan untuk detail selengkapnya.

Bujur dalam derajat.
recordingDetails.location.altitude double
Properti ini tidak digunakan lagi mulai 9 Juli 2018. Lihat pengumuman penghentian penggunaan untuk detail selengkapnya.

Ketinggian di atas ellipsoid referensi, dalam meter.
recordingDetails.recordingDate datetime
Tanggal dan waktu saat video direkam. Nilai ditetapkan dalam format ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).
fileDetails object
Objek fileDetails mengenkapsulasi informasi tentang file video yang diupload ke YouTube, termasuk resolusi, durasi, codec audio dan video, kecepatan bit 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 string
Nama file yang diupload. Kolom ini ada baik file video atau jenis file lain telah diupload.
fileDetails.fileSize unsigned long
Ukuran file yang diupload dalam byte. Kolom ini ada baik file video atau jenis file lain telah diupload.
fileDetails.fileType string
Jenis file yang diupload seperti yang terdeteksi oleh mesin pemrosesan video YouTube. Saat ini, YouTube hanya memproses file video, tetapi kolom ini ada baik file video maupun jenis file lain diupload.

Nilai yang valid untuk properti ini adalah:
  • archive – Filenya adalah file arsip, seperti arsip .zip.
  • audio – File adalah jenis file audio yang dikenal, seperti file .mp3.
  • document – Filenya berupa dokumen atau file teks, seperti dokumen MS Word.
  • image – Filenya adalah file gambar, seperti gambar .jpeg.
  • other – File merupakan jenis file non-video lainnya.
  • project – Filenya adalah file project video, seperti project Microsoft Windows Movie Maker, yang tidak berisi data video aktual.
  • video – Filenya adalah jenis file video yang dikenal, seperti file .mp4.
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 lebar tinggi 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 lebar tinggi tampilan konten video, yang menentukan rasio lebar tinggi 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 dibutuhkan YouTube untuk merotasi konten sumber asli agar dapat menampilkan video dengan benar.

Nilai yang valid untuk properti ini adalah:
  • clockwise – Video harus diputar 90 derajat searah jarum jam.
  • counterClockwise – Video harus diputar 90 derajat berlawanan arah jarum jam.
  • none – Video tidak perlu diputar.
  • other – Video perlu diputar dengan cara lain yang tidak umum.
  • upsideDown – Video harus diputar terbalik.
fileDetails.videoStreams[].vendor string
Nilai yang mengidentifikasi vendor video secara unik. Biasanya, nilainya adalah kode vendor empat huruf.
fileDetails.audioStreams[] list
Daftar streaming audio yang ada di file video yang diupload. Setiap item dalam daftar berisi metadata mendetail tentang streaming audio.
fileDetails.audioStreams[].channelCount unsigned integer
Jumlah channel 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 empat huruf.
fileDetails.durationMs unsigned long
Durasi video yang diupload dalam milidetik.
fileDetails.bitrateBps unsigned long
Kecepatan bit gabungan (video dan audio) file video yang diupload dalam bit per detik.
fileDetails.creationTime string
Tanggal dan waktu saat file video yang diupload dibuat. Nilai ditetapkan dalam format ISO 8601. Saat ini, format ISO 8601 berikut didukung:
  • Hanya tanggal: YYYY-MM-DD
  • Waktu Naif: YYYY-MM-DDTHH:MM:SS
  • Waktu dengan zona waktu: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
Objek processingDetails mengenkapsulasi informasi tentang progres YouTube dalam memproses file video yang diupload. Properti dalam objek mengidentifikasi status pemrosesan saat ini dan estimasi 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 polling agar 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 apakah video masih diproses.

Nilai yang valid untuk properti ini adalah:
  • failed – Pemrosesan video gagal. Lihat ProcessingFailureReason.
  • processing – Video sedang diproses. Lihat ProcessingProgress.
  • succeeded – Video berhasil diproses.
  • terminated – Informasi pemrosesan tidak lagi tersedia.
processingDetails.processingProgress object
Objek processingProgress berisi informasi tentang progres yang telah dicapai YouTube dalam memproses video. Nilai benar-benar hanya relevan jika status pemrosesan video adalah processing.
processingDetails.processingProgress.partsTotal unsigned long
Estimasi jumlah total bagian yang perlu diproses untuk video. Jumlah tersebut dapat diperbarui dengan estimasi yang lebih akurat saat YouTube memproses video.
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 yang sesuai dalam jumlah bagian yang telah diproses, ada kemungkinan bahwa progres yang dihitung dapat menurun secara berkala saat YouTube memproses video.
processingDetails.processingProgress.timeLeftMs unsigned long
Estimasi jumlah waktu, dalam milidetik, yang diperlukan YouTube untuk menyelesaikan pemrosesan video.
processingDetails.processingFailureReason string
Alasan YouTube gagal memproses video. Properti ini hanya akan memiliki nilai jika nilai properti processingStatus adalah failed.

Nilai yang valid untuk properti ini adalah:
  • other – Beberapa komponen pemrosesan lainnya gagal.
  • streamingFailed – Video tidak dapat dikirim ke streamer.
  • transcodeFailed – Proses transcoding konten gagal.
  • uploadFailed – Pengiriman file gagal.
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 menghasilkan 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().
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 dalam permintaan videos.list().
processingDetails.editorSuggestionsAvailability string
Nilai ini menunjukkan apakah saran pengeditan video, yang dapat meningkatkan kualitas video atau pengalaman pemutaran, tersedia untuk video. Anda dapat mengambil saran ini dengan meminta bagian suggestions dalam permintaan videos.list().
processingDetails.thumbnailsAvailability string
Nilai ini menunjukkan apakah gambar thumbnail telah dibuat untuk video.
suggestions object
Objek suggestions mengenkapsulasi 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 dengan sukses. Error ini menunjukkan bahwa, terlepas dari status pemrosesan video saat ini, status tersebut hampir pasti akan menjadi failed.

Nilai yang valid untuk properti ini adalah:
  • archiveFile – File arsip (misalnya, arsip ZIP).
  • audioFile – File hanya berisi audio (misalnya, file MP3).
  • docFile – File dokumen atau teks (misalnya, MS Word).
  • imageFile – File gambar (misalnya, gambar JPEG).
  • notAVideoFile – File non-video lainnya.
  • projectFile – File project film (misalnya, Microsoft Windows Movie Maker).
suggestions.processingWarnings[] list
Daftar alasan mengapa YouTube mungkin kesulitan melakukan transcoding video yang diupload atau yang dapat menyebabkan transcoding yang salah. Peringatan ini dibuat sebelum YouTube benar-benar memproses file video yang diupload. Selain itu, identifikasi masalah yang tidak selalu menunjukkan bahwa pemrosesan video akan gagal, tetapi yang masih dapat menyebabkan masalah seperti masalah sinkronisasi, artefak video, atau trek audio yang hilang.

Nilai yang valid untuk properti ini adalah:
  • hasEditlist – Daftar edit saat ini tidak didukung.
  • inconsistentResolution – Penampung dan resolusi streaming yang bertentangan.
  • problematicAudioCodec – Codec audio yang diketahui menyebabkan masalah digunakan.
  • problematicVideoCodec – Codec video yang diketahui dapat menyebabkan masalah digunakan.
  • unknownAudioCodec – Codec audio tidak dikenal, transcoding mungkin gagal.
  • unknownContainer – Format file tidak dikenal, proses transcoding mungkin gagal.
  • unknownVideoCodec – Codec video tidak dikenal, transcoding mungkin gagal.
suggestions.processingHints[] list
Daftar saran yang dapat meningkatkan kemampuan YouTube untuk memproses video.

Nilai yang valid untuk properti ini adalah:
  • nonStreamableMov – File MP4 tidak dapat di-streaming, yang akan memperlambat pemrosesan.
  • sendBestQualityVideo – Mungkin ada versi video yang lebih berkualitas.
suggestions.tagSuggestions[] list
Daftar tag kata kunci yang dapat ditambahkan ke metadata video untuk meningkatkan kemungkinan pengguna menemukan video Anda saat melakukan penelusuran atau menjelajah di YouTube.
suggestions.tagSuggestions[].tag string
Tag kata kunci yang disarankan untuk video.
suggestions.tagSuggestions[].categoryRestricts[] list
Kumpulan kategori video yang relevan dengan tag yang dimaksud. Anda dapat menggunakan informasi ini untuk menampilkan saran tag yang sesuai berdasarkan kategori video yang dikaitkan oleh uploader video dengan video tersebut. 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 video yang diupload.

Nilai yang valid untuk properti ini adalah:
  • audioQuietAudioSwap – Trek audio tampak senyap dan dapat ditukar dengan kualitas yang lebih baik.
  • videoAutoLevels – Tingkat kecerahan gambar tampak nonaktif dan dapat dikoreksi.
  • videoCrop – Margin (matte) yang terdeteksi di sekitar gambar dapat dipangkas.
  • videoStabilize – Video terlihat goyang dan dapat distabilkan.
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 selesai.
liveStreamingDetails.actualStartTime datetime
Waktu saat siaran benar-benar dimulai. Nilai ditetapkan dalam format ISO 8601. Nilai ini tidak akan tersedia hingga siaran dimulai.
liveStreamingDetails.actualEndTime datetime
Waktu saat siaran benar-benar berakhir. Nilai ditetapkan dalam format ISO 8601. Nilai ini tidak akan tersedia hingga siaran berakhir.
liveStreamingDetails.scheduledStartTime datetime
Waktu siaran dijadwalkan untuk dimulai. Nilai ditetapkan dalam format ISO 8601.
liveStreamingDetails.scheduledEndTime datetime
Waktu siaran dijadwalkan untuk berakhir. Nilai ditetapkan dalam format ISO 8601. Jika nilainya kosong atau properti tidak ada, siaran akan dijadwalkan untuk berlanjut tanpa batas.
liveStreamingDetails.concurrentViewers unsigned long
Jumlah penonton yang sedang menonton siaran. Properti dan nilainya akan ada jika siaran memiliki penonton saat ini dan pemilik siaran tidak menyembunyikan jumlah penayangan untuk video. Perlu diperhatikan bahwa YouTube berhenti melacak jumlah penonton serentak untuk siaran saat siaran berakhir. Jadi, properti ini tidak akan mengidentifikasi jumlah penonton yang menonton arsip video live streaming yang telah berakhir.
liveStreamingDetails.activeLiveChatId string
ID live chat yang saat ini aktif dan dilampirkan ke video ini. Kolom ini hanya diisi jika video merupakan siaran live yang memiliki live chat. Setelah transisi siaran selesai, kolom ini akan dihapus dan live chat ditutup. Untuk siaran persisten, ID live chat tersebut tidak akan lagi terikat dengan video ini, melainkan ke 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.