Videos

Semua video yang diupload melalui endpoint videos.insert dari project API yang belum diverifikasi dan dibuat setelah 28 Juli 2020 akan dibatasi ke mode tonton pribadi. Untuk mencabut pembatasan ini, setiap project API harus diaudit untuk memverifikasi kepatuhan terhadap Persyaratan Layanan. Lihat Histori Revisi API untuk detail selengkapnya.

Resource video merepresentasikan video YouTube.

Metode

API ini mendukung metode berikut untuk resource videos:

getRating
Mengambil rating yang diberikan pengguna yang diberi otorisasi ke daftar video tertentu. 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.
perbarui
Memperbarui metadata video. Coba sekarang.
hapus
Menghapus video YouTube. Coba sekarang.
rate [tarif]
Menambahkan rating suka atau tidak suka pada video atau menghapus rating dari video. Coba sekarang.
reportAbuse
Melaporkan video yang berisi konten yang melanggar. Coba sekarang.

Representasi resource

Struktur JSON berikut menampilkan 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 mendefinisikan properti yang muncul di resource ini:

Properti
kind string
Mengidentifikasi jenis resource API. Nilainya akan berupa 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. Perhatikan bahwa waktu ini mungkin berbeda dengan waktu saat video diupload. Misalnya, jika video diupload sebagai video pribadi, kemudian disetel ke publik di lain waktu, properti ini akan menentukan waktu video dipublikasikan.

Ada beberapa kasus khusus:
  • Jika video diupload sebagai video pribadi dan metadata video diambil oleh pemilik channel, nilai properti akan menentukan tanggal dan waktu video tersebut diupload.
  • Jika video diupload sebagai video tidak publik, nilai properti juga menentukan tanggal dan waktu video diupload. Dalam hal ini, siapa pun yang mengetahui ID video unik dari video dapat mengambil metadata video.
Nilai ini ditentukan dalam format ISO 8601.
snippet.channelId string
ID yang digunakan YouTube untuk mengidentifikasi secara unik channel yang menjadi tujuan upload video.
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:
  • default – Gambar thumbnail default. Thumbnail default untuk video – atau referensi yang merujuk ke video, seperti item playlist atau hasil penelusuran – adalah lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk saluran adalah lebar 88px dan tinggi 88px.
  • medium – Versi gambar thumbnail beresolusi lebih tinggi. Untuk video (atau sumber daya yang merujuk pada video), gambar ini memiliki lebar 320px dan tinggi 180px. Untuk channel, gambar ini memiliki lebar 240px dan tinggi 240px.
  • high – Versi gambar thumbnail beresolusi tinggi. Untuk video (atau sumber daya 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 beresolusi high. Gambar ini tersedia untuk beberapa video dan referensi lain yang merujuk ke video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 640px dan tinggi 480px.
  • maxres – Versi gambar thumbnail dengan resolusi 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 1280px dan tinggi 720px.
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 boleh berisi spasi. Nilai properti memiliki panjang maksimum 500 karakter. Perhatikan aturan berikut mengenai cara penghitungan batas karakter:
  • Nilai properti adalah daftar, dan tanda koma di antara item dalam daftar dihitung terhadap batas.
  • Jika tag berisi spasi, server API akan menangani nilai tag seolah-olah nilai tersebut diapit dalam tanda kutip, dan tanda kutip dihitung terhadap 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 mengupdate bagian snippet dari resource video.
snippet.liveBroadcastContent string
Menunjukkan apakah video adalah live streaming mendatang/aktif. Atau "tidak ada" jika video bukan 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 akan digunakan untuk menampilkan teks yang dilokalkan dan teks yang dilokalkan tersedia dalam bahasa tersebut.
  • 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 pada trek audio default dalam video.
contentDetails object
Objek contentDetails berisi informasi tentang konten video, termasuk durasi video dan indikasi apakah teks tersedia untuk video tersebut atau tidak.
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 menggunakan format PT#M#S, dengan huruf PT menunjukkan bahwa nilai menentukan jangka waktu, sedangkan huruf M dan S masing-masing merujuk pada durasi dalam menit dan detik. Karakter # yang mendahului huruf M dan S adalah bilangan bulat yang menentukan jumlah menit (atau detik) dalam video. Misalnya, nilai PT15M33S menunjukkan bahwa video berdurasi 15 menit 33 detik.

Jika video berdurasi minimal satu jam, durasi video akan menggunakan format PT#H#M#S, dengan # yang mendahului 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:
  • hd
  • sd
contentDetails.caption string
Menunjukkan apakah teks tersedia untuk video atau tidak.

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) ditonton. 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 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) Rating ACMA digunakan untuk mengklasifikasikan program televisi anak-anak.

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

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

Nilai yang valid untuk properti ini adalah:
  • anatelA – A
  • anatelF – F
  • anatelI – Saya
  • 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 – 12A
  • bbfc15 – 15
  • bbfc18 – 18
  • bbfcPg – BO
  • bbfcR18 – R18
  • bbfcU – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
Rating video dari Badan Penyensor Film dan Video Thailand.

Nilai yang valid untuk properti ini adalah:
  • bfvc13 – 13
  • bfvc15 – 15
  • bfvc18 – 18
  • bfvc20 – 20
  • bfvcB – M
  • bfvcE – T
  • bfvcG – S
  • bfvcUnrated
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:
  • bmukk10 – 10+
  • bmukk12 – 12+
  • bmukk14 – 14 tahun ke atas
  • 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 tahun ke atas
  • catv18plus – 18 tahun ke atas
  • catvC – C
  • catvC8 – C8
  • catvG – S
  • catvPg – BO
  • 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 tahun ke atas
  • catvfr16plus – 16 tahun ke atas
  • catvfr18plus – 18 tahun ke atas
  • catvfr8plus – 8+
  • catvfrG – S
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
Rating Central Board of Film Certification (CBFC - India) 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
Rating Consejo de Calificación Cinematográfica (Cile) pada video.

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

Nilai yang valid untuk properti ini adalah:
  • cceM12 – 12
  • cceM14 – 14
  • cceM16 – 16
  • cceM18 – 18
  • 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
  • chfilm18 – 18
  • chfilm6 – 6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
Rating Sistem Rating Video Rumah (CHVRS) Kanada pada video.

Nilai yang valid untuk properti ini adalah:
  • chvrs14a – 14A
  • chvrs18a – 18A
  • chvrsE – T
  • chvrsG – S
  • chvrsPg – BO
  • 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 – T
  • 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
  • cna18plus – 18 tahun ke atas
  • cnaAp – APAC
  • 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
  • cnc18 – 18
  • cncE – T
  • cncT – S
  • cncUnrated
contentDetails.contentRating.csaRating string
Rating video dari Conseil supérieur de l?audiovisuel Prancis, yang memberi rating konten siaran.

Nilai yang valid untuk properti ini adalah:
  • csa10 – 10
  • csa12 – 12
  • csa16 – 16
  • csa18 – 18
  • csaInterdiction – Larangan
  • csaT – S
  • csaUnrated
contentDetails.contentRating.cscfRating string
Rating video dari Commission de ssecurity de laClassification des films (CSCF) di Luksemburg.

Nilai yang valid untuk properti ini adalah:
  • cscf12 – 12
  • cscf16 – 16
  • cscf18 – 18
  • 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
  • czfilm18 – 18
  • czfilmU – U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
Rating video Departamento 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
  • djctq16 – 16
  • djctq18 – 18
  • djctqL – R
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
Alasan yang menjelaskan mengapa video tersebut menerima 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:
  • ecbmct13a – 13A
  • ecbmct13plus – 13 tahun ke atas
  • ecbmct15a – 15A
  • ecbmct15plus – 15+
  • ecbmct18plus – 18 tahun ke atas
  • ecbmct7a – 7A
  • ecbmct7plus – 7+
  • ecbmctG – S
  • ecbmctUnrated
  • ecbmct6a – 6A
  • ecbmct6plus – 6+
  • ecbmct10a – 10A
  • ecbmct10plus – 10+
  • ecbmct16plus – 16 tahun ke atas
contentDetails.contentRating.eefilmRating string
Rating video di Estonia.

Nilai yang valid untuk properti ini adalah:
  • eefilmK12 – Sekolah dasar dan menengah
  • eefilmK14 – Sekolah dasar dan menengah
  • eefilmK16 – Sekolah dasar dan menengah
  • eefilmK6 – Sekolah dasar dan menengah
  • eefilmL – R
  • 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
  • egfilmBn – BN
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
Rating Eirin (映倫) pada video. Eirin adalah sistem rating Jepang.

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

Nilai yang valid untuk properti ini adalah:
  • fcbm13 – 13
  • fcbm16 – 16
  • fcbm18 – 18
  • fcbm18pa – 18PA
  • fcbm18pl – 18PL
  • fcbm18sg – 18SG
  • fcbm18sx – 18SX
  • fcbmP12 – P12
  • fcbmP13 – P13
  • fcbmPg13 – PG13
  • fcbmU – U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
Rating video dari Kantor untuk Film, Surat Kabar, dan Administrasi Artikel Hong Kong.

Nilai yang valid untuk properti ini adalah:
  • fcoI – Saya
  • 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 Centre external du cinéma et de l'image animé (Kementerian Kebudayaan Prancis) video.

Nilai yang valid untuk properti ini adalah:
  • fmoc10 – 10
  • fmoc12 – 12
  • fmoc16 – 16
  • fmoc18 – 18
  • fmocE – T
  • fmocU – U
  • fmocUnrated
contentDetails.contentRating.fpbRating string
Rating video dari Film and Publication Board Afrika Selatan.

Nilai yang valid untuk properti ini adalah:
  • fpb10 – 10
  • fpb1012Pg – 10-12 malam
  • fpb13 – 13
  • fpb16 – 16
  • fpb18 – 18
  • fpb79Pg – 7-9PG
  • fpbA – A
  • fpbPg – BO
  • fpbUnrated
  • fpbX18 – X18
  • fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[] list
Alasan yang menjelaskan mengapa video menerima rating FPB (Afrika Selatan).
contentDetails.contentRating.fskRating string
Rating Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Jerman) dari 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 dalam bahasa Yunani.

Nilai yang valid untuk properti ini adalah:
  • grfilmE – T
  • grfilmK – rb
  • grfilmK12 – Sekolah dasar dan menengah
  • grfilmK13 – Sekolah dasar dan menengah
  • grfilmK15 – Sekolah dasar dan menengah
  • grfilmK17 – Sekolah dasar dan menengah
  • grfilmK18 – Sekolah dasar dan menengah
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
Rating Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - Spanyol) dari video.

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

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

Nilai yang valid untuk properti ini adalah:
  • ilfilm12 – 12
  • ilfilm16 – 16
  • ilfilm18 – 18
  • ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
Rating INCAA (Instituto Nacional de Cine y Artes Audiovisuales - Argentina) 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
  • kfcbG – GE
  • kfcbPg – BO
  • kfcbR – 18
  • kfcbUnrated
contentDetails.contentRating.kijkwijzerRating string
voor de Classificatie van Audiovisuele Media (Belanda).

Nilai yang valid untuk properti ini adalah:
  • kijkwijzer12 – 12
  • kijkwijzer14 – 14
  • kijkwijzer16 – 16
  • kijkwijzer18 – 18
  • kijkwijzer6 – 6
  • kijkwijzer9 – 9
  • kijkwijzerAl – AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
Rating dari Korea Media Rating Board (영行물등]{}위 mengambang회 dalam video. KMRB memberi rating video di Korea Selatan.

Nilai yang valid untuk properti ini adalah:
  • kmrb12plus – 12 ()` 이리 APK람 memadukan
  • kmrb15plus – 15 Chromecast 이 perpaduan APK람 memadukan
  • kmrbAll – 전체 menimpa람 Uni
  • kmrbR – 청소년 Connection람불 AS
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
Rating video dari Lembaga Sensor Film di 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 Film Age-Classification Board Malta.

Nilai yang valid untuk properti ini adalah:
  • mccaa12 – 12
  • mccaa12a – 12A
  • 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
  • mccaaPg – BO
  • mccaaU – U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
Rating video dari Denmark Film Institute (Det Danske Filminstitut) Media Council for Children and Young People.

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
  • mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 – T18
  • mcstK – rb
contentDetails.contentRating.mdaRating string
Rating video dari Media Development Authority (MDA) Singapura dan, khususnya, Board of Film Censors (BFC).

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

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

Nilai yang valid untuk properti ini adalah:
  • meku12 – 12
  • meku16 – 16
  • meku18 – 18
  • 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) pada video.

Nilai yang valid untuk properti ini adalah:
  • moc12 – 12
  • moc15 – 15
  • moc18 – 18
  • moc7 – 7
  • mocBanned – Diblokir
  • mocE – T
  • mocT – S
  • mocUnrated
  • mocX – X
contentDetails.contentRating.moctwRating string
Rating video dari Kementerian Kebudayaan Taiwan (mempelajari),

Nilai yang valid untuk properti ini adalah:
  • moctwG – S
  • moctwP – P
  • moctwPg – BO
  • 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 – S
  • mpaaNc17 – NC-17
  • mpaaPg – BO
  • mpaaPg13 – BO-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 (Tali Hijau - Disetujui untuk semua audiens)
  • mpaatRb – RB (Pita Merah - Direkomendasikan untuk usia 17 tahun ke atas)
contentDetails.contentRating.mtrcbRating string
Rating video dari Movie and Television Review and Classification Board (Filipina).

Nilai yang valid untuk properti ini adalah:
  • mtrcbG – S
  • mtrcbPg – BO
  • mtrcbR13 – R-13
  • mtrcbR16 – R-16
  • mtrcbR18 – R-18
  • mtrcbUnrated
  • mtrcbX – X
contentDetails.contentRating.nbcRating string
Rating video dari Maldives National Bureau of Classification.

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

Nilai yang valid untuk properti ini adalah:
  • nfrcA – A
  • nfrcB – M
  • 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 – 12A
  • nfvcb15 – 15
  • nfvcb18 – 18
  • nfvcbG – S
  • nfvcbPg – BO
  • nfvcbRe – BL
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
Rating video dari Nacionêlais Kino centrs (National Film Centre 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 Office of Film and Literature Classification (OFLC - Selandia Baru) video.

Nilai yang valid untuk properti ini adalah:
  • oflcG – S
  • oflcM – J
  • oflcPg – BO
  • 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
  • pefilm18 – 18
  • pefilmPg – BO
  • pefilmPt – PT
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
Rating video di Venezuela.

Nilai yang valid untuk properti ini adalah:
  • resorteviolenciaA – A
  • resorteviolenciaB – M
  • resorteviolenciaC – C
  • resorteviolenciaD – H
  • resorteviolenciaE – T
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
Rating General Directorate of Radio, Televisi, dan Sinematografi (Meksiko) video.

Nilai yang valid untuk properti ini adalah:
  • rtcA – A
  • rtcAa – AA
  • rtcB – M
  • 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 – Swiss
  • rteGa – GA
  • rteMa – MA
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
Rating National Film Registry of the Rusia Federation (MKRF - Rusia) pada video.

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 – S
  • 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
  • smais16 – 16
  • smais18 – 18
  • smais7 – 7
  • smaisL – R
  • smaisUnrated
contentDetails.contentRating.smsaRating string
Rating video dari Statens medieràd (National Media Council Swedia).

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

Nilai yang valid untuk properti ini adalah:
  • tvpgG – TV-G
  • tvpgMa – TV-MA
  • tvpgPg – TV-BO
  • 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 memberikan gambar thumbnail kustom untuk video. Properti ini hanya dapat dilihat oleh uploader video.
status object
Objek status berisi informasi tentang status privasi, pemrosesan, dan upload 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 video dijadwalkan untuk dipublikasikan. Opsi ini hanya dapat disetel jika status privasi video disetel ke pribadi. Nilai ditentukan dalam format ISO 8601. Perhatikan dua hal tambahan berikut tentang perilaku properti ini:
  • Jika menetapkan nilai properti ini saat memanggil metode videos.update, Anda juga harus menetapkan nilai properti status.privacyStatus ke private meskipun video sudah bersifat pribadi.
  • Jika permintaan Anda menjadwalkan video untuk dipublikasikan pada waktu tertentu sebelumnya, video tersebut akan langsung dipublikasikan. Dengan demikian, efek menetapkan properti status.publishAt ke tanggal dan waktu yang sudah berlalu akan 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 atau tidak.
status.publicStatsViewable boolean
Nilai ini menunjukkan apakah statistik video yang diperluas di halaman tonton video dapat dilihat secara 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 dikelompokkan sebagai ditujukan untuk anak-anak, dan berisi status video saat ini "Dibuat untuk Anak-Anak". Misalnya, status mungkin ditentukan berdasarkan nilai properti selfDeclaredMadeForKids. Buka Pusat Bantuan YouTube untuk mengetahui informasi lebih lanjut mengenai 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 ditonton.
statistics.likeCount unsigned long
Jumlah pengguna yang menunjukkan bahwa mereka menyukai video tersebut.
statistics.dislikeCount unsigned long
Catatan: Properti statistics.dislikeCount dijadikan pribadi mulai 13 Desember 2021. Artinya, properti disertakan dalam respons API hanya jika permintaan API diautentikasi oleh pemilik video. Lihat histori revisi untuk informasi selengkapnya.

Jumlah pengguna yang telah menunjukkan bahwa mereka tidak menyukai video tersebut.
statistics.favoriteCount unsigned long
Catatan: Properti ini tidak digunakan lagi. Penghentian ini berlaku sejak 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 sematan akan diskalakan untuk memenuhi persyaratan maxHeight dan/atau maxWidth.
  • Jika rasio aspek video tidak diketahui, pemutar sematan akan menggunakan format 4:3 secara default.
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 semua 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. 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 sejumlah 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 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 ini 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 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, 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 ditampilkan apakah file video atau file jenis lainnya telah diupload.
fileDetails.fileSize unsigned long
Ukuran file yang diupload dalam byte. Kolom ini ditampilkan apakah file video atau file jenis 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 ada, baik file video atau jenis file lainnya diupload.

Nilai yang valid untuk properti ini adalah:
  • archive – Filenya adalah file arsip, seperti arsip .zip.
  • audio – File adalah jenis file audio yang diketahui, seperti file .mp3.
  • document – File berupa dokumen atau file teks, seperti dokumen MS Word.
  • image – File berupa file gambar, seperti gambar .jpeg.
  • other – File adalah jenis file non-video lain.
  • project – File ini adalah file project video, seperti project Microsoft Windows Movie Maker, yang tidak berisi data video sebenarnya.
  • video – File adalah jenis file video yang diketahui, 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 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 yang akan menampilkan video.
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 video dapat ditampilkan 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 secara 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 dalam 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 pembuatan file video yang diupload. Nilai ditentukan dalam format ISO 8601. Saat ini, format ISO 8601 berikut didukung:
  • Hanya tanggal: YYYY-MM-DD
  • Waktu aktif: YYYY-MM-DDTHH:MM:SS
  • Waktu dengan zona waktu: YYYY-MM-DDTHH:MM:SS+HH:MM
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 tersebut.

Objek processingProgress dirancang untuk dilakukan 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 tersebut masih diproses.

Nilai yang valid untuk properti ini adalah:
  • failed – Pemrosesan video gagal. Lihat ProcessingFailureReason.
  • processing – Video saat ini sedang diproses. Lihat Progres Pemrosesan.
  • succeeded – Video telah berhasil diproses.
  • terminated – Memproses informasi tidak lagi tersedia.
processingDetails.processingProgress object
Objek processingProgress berisi informasi tentang progres yang telah dicapai YouTube dalam memproses video. Nilai ini hanya relevan jika status pemrosesan video adalah processing.
processingDetails.processingProgress.partsTotal unsigned long
Estimasi jumlah total bagian yang perlu diproses untuk video ini. Jumlah ini dapat diperbarui dengan estimasi yang lebih tepat saat YouTube memproses video.
processingDetails.processingProgress.partsProcessed unsigned long
Jumlah bagian video yang telah diproses YouTube. Anda dapat memperkirakan persentase video yang telah diproses oleh YouTube dengan menghitung:
100 * parts_processed / parts_total

Perhatikan bahwa karena estimasi jumlah komponen dapat meningkat tanpa peningkatan yang sesuai pada jumlah bagian yang telah diproses, ada kemungkinan progres yang dihitung dapat menurun secara berkala saat YouTube memproses video.
processingDetails.processingProgress.timeLeftMs unsigned long
Estimasi jumlah waktu, dalam mil per detik, yang harus dihabiskan 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 – 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().
processingDetails.processingIssuesAvailability string
Nilai ini menunjukkan apakah mesin pemrosesan video telah menghasilkan 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 dalam permintaan videos.list().
processingDetails.tagSuggestionsAvailability string
Nilai ini menunjukkan apakah saran kata kunci (tag) tersedia untuk video tersebut. 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 tersebut. 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 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, apa pun status pemrosesan video saat ini, pada akhirnya, status tersebut hampir dipastikan 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 mengalami kesulitan dalam men-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 menunjukkan bahwa pemrosesan video akan gagal, tetapi 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 menyebabkan masalah digunakan.
  • unknownAudioCodec – Codec audio tidak dikenal, transcoding kemungkinan akan gagal.
  • unknownContainer – Format file tidak dikenal, transcoding kemungkinan akan gagal.
  • unknownVideoCodec – Codec video tidak dikenal, transcoding kemungkinan akan 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. Hal ini akan memperlambat pemrosesan.
  • sendBestQualityVideo – Mungkin ada versi video yang lebih baik.
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
Kumpulan kategori video yang tag-nya relevan. Anda dapat menggunakan informasi ini untuk menampilkan saran tag yang sesuai berdasarkan kategori video yang terkait dengan uploader 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:
  • audioQuietAudioSwap – Trek audio tampak senyap dan dapat ditukar dengan yang berkualitas lebih baik.
  • videoAutoLevels – Tingkat kecerahan gambar tampak mati dan dapat diperbaiki.
  • videoCrop – Margin (matte) yang terdeteksi di sekitar gambar dapat dipangkas.
  • videoStabilize – Video tampak goyang dan dapat stabil.
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 saat siaran benar-benar dimulai. Nilai ditentukan dalam format ISO 8601. Nilai ini tidak akan tersedia hingga siaran dimulai.
liveStreamingDetails.actualEndTime datetime
Waktu saat siaran benar-benar berakhir. Nilai ditentukan dalam format ISO 8601. Nilai ini tidak akan tersedia hingga siaran selesai.
liveStreamingDetails.scheduledStartTime datetime
Waktu siaran dijadwalkan untuk dimulai. Nilai ditentukan dalam format ISO 8601.
liveStreamingDetails.scheduledEndTime datetime
Waktu siaran dijadwalkan berakhir. Nilai ditentukan dalam format ISO 8601. Jika nilai kosong atau properti tidak ada, siaran akan dijadwalkan untuk dilanjutkan 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 tidak menyembunyikan jumlah penayangan untuk video tersebut. Perhatikan bahwa YouTube berhenti melacak jumlah penonton serentak untuk suatu siaran saat siaran berakhir. Jadi, properti ini tidak akan mengidentifikasi jumlah penonton yang menonton arsip video live streaming yang sudah berakhir.
Jumlah penonton serentak yang ditampilkan YouTube Data API mungkin berbeda dengan jumlah penonton serentak yang sudah diproses dan bukan spam yang tersedia melalui YouTube Analytics. Pelajari lebih lanjut metrik live streaming di Pusat Bantuan YouTube.
liveStreamingDetails.activeLiveChatId string
ID live chat yang saat ini aktif terlampir pada video ini. Kolom ini hanya diisi jika video tersebut saat ini merupakan live streaming yang memiliki live chat. Setelah transisi siaran untuk melengkapi kolom ini akan dihapus dan live chat akan ditutup. Untuk siaran persisten, ID live chat tidak akan dikaitkan lagi 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.