Videos

Semua video yang diupload melalui endpoint videos.insert dari project API yang tidak terverifikasi yang dibuat setelah 28 Juli 2020 akan dibatasi untuk mode tampilan pribadi. Untuk mencabut pembatasan ini, setiap project API harus melakukan audit untuk memverifikasi kepatuhan terhadap Persyaratan Layanan. Lihat Histori Revisi API untuk mengetahui detail selengkapnya.

Resource video mewakili video YouTube.

Metode

API ini mendukung metode berikut untuk resource videos:

getRating
Mengambil rating yang diberikan pengguna yang diotorisasi ke daftar video yang ditentukan. Coba sekarang.
list
Menampilkan daftar video yang cocok dengan parameter permintaan API. Coba sekarang.
insert
Mengupload video ke YouTube dan secara opsional menetapkan metadata video.
update
Memperbarui metadata video. Coba sekarang.
hapus
Menghapus video YouTube. Coba sekarang.
rate [tarif]
Menambahkan rating suka atau tidak suka ke video atau menghapus rating dari video. Coba sekarang.
reportAbuse
Melaporkan video karena berisi konten yang menghina. Coba sekarang.

Representasi resource

Struktur JSON berikut menunjukkan format resource videos:

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Properti

Tabel berikut menentukan properti yang muncul di resource ini:

Properti
kind string
Mengidentifikasi jenis resource API. Nilainya akan menjadi 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 video diupload. Misalnya, jika video diupload sebagai video pribadi, lalu diubah menjadi publik di lain waktu, properti ini akan menentukan waktu video diubah menjadi publik.

Ada beberapa kasus khusus:
  • Jika video diupload sebagai video pribadi dan metadata video diambil oleh pemilik channel, nilai properti menentukan tanggal dan waktu video tersebut diupload.
  • Jika video diupload sebagai video tidak publik, nilai properti juga akan menentukan tanggal dan waktu video diupload. Dalam hal ini, siapa pun yang mengetahui ID video unik dapat mengambil metadata video.
Nilai ditentukan dalam format ISO 8601.
snippet.channelId string
ID yang digunakan YouTube untuk mengidentifikasi secara unik channel tempat video diupload.
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 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 referensi yang mengacu pada video, seperti item playlist atau hasil penelusuran – memiliki lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk saluran memiliki lebar 88 piksel dan tinggi 88 piksel.
  • medium – Versi resolusi gambar thumbnail yang lebih tinggi. Untuk video (atau resource yang merujuk ke video), gambar ini memiliki lebar 320 px dan tinggi 180 px. Untuk channel, gambar ini berukuran lebar 240 piksel dan tinggi 240 piksel.
  • high – Gambar thumbnail versi resolusi tinggi. Untuk video (atau referensi yang merujuk ke video), gambar ini memiliki lebar 480 px dan tinggi 360 px. Untuk channel, gambar ini berukuran lebar 800 piksel dan tinggi 800 piksel.
  • standard – Versi gambar thumbnail beresolusi lebih tinggi dibandingkan gambar beresolusi high. Gambar ini tersedia untuk beberapa video dan resource lain yang merujuk ke video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 640 piksel dan tinggi 480 piksel.
  • maxres – Versi gambar thumbnail dengan resolusi tertinggi. Ukuran gambar ini tersedia untuk beberapa video dan referensi lain yang merujuk pada 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 berupa daftar, dan tanda koma di antara item dalam daftar akan dihitung dalam batas.
  • Jika tag berisi spasi, server API akan menangani nilai tag seolah-olah diapit tanda petik, dan tanda petik akan 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 adalah siaran live mendatang/aktif. Atau "none" jika video bukan siaran live 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 akan dilokalkan dan teks yang dilokalkan tersedia dalam bahasa tersebut.
  • Metadata untuk bahasa default akan ditampilkan jika nilai parameter hl tidak ditentukan atau nilai ditentukan, tetapi metadata yang dilokalkan tidak tersedia untuk bahasa yang ditentukan.
Properti 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 tersebut.
contentDetails.duration string
Durasi video. Nilai properti adalah durasi ISO 8601. Misalnya, untuk video yang berdurasi minimal satu menit dan kurang dari satu jam, durasinya dalam format PT#M#S, dengan huruf PT menunjukkan bahwa nilai menentukan jangka waktu, dan huruf M dan S masing-masing merujuk pada durasi dalam menit dan detik. Karakter # sebelum huruf M dan S adalah bilangan bulat yang menentukan jumlah menit (atau detik) video. Misalnya, nilai PT15M33S menunjukkan bahwa video berdurasi 15 menit 33 detik.

Jika video berdurasi minimal satu jam, durasinya akan menggunakan 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 akan dipisahkan, dan format nilainya adalah P#DT#H#M#S. Lihat spesifikasi ISO 8601 untuk mengetahui 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.

Nilai yang valid untuk properti ini adalah:
  • false
  • true
contentDetails.licensedContent boolean
Menunjukkan apakah video tersebut berisi 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 dilihat. 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 dilihat 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) untuk video. 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 untuk anak (selain anak prasekolah) yang berusia di bawah 14 tahun.
  • acbE – E
  • acbG – G
  • acbM – M
  • acbMa15plus – MA15+
  • acbP – Program yang telah diberi klasifikasi P oleh Australian Communications and Media Authority. Program ini ditujukan untuk anak prasekolah.
  • acbPg – PG
  • 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 – T
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
Rating Anatel (Asociación Nacional de Televisión) untuk televisi Cile.

Nilai yang valid untuk properti ini adalah:
  • anatelA – J
  • 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) untuk video.

Nilai yang valid untuk properti ini adalah:
  • bbfc12 – 12
  • bbfc12a – 12A
  • bbfc15 – 15
  • bbfc18 – 18
  • bbfcPg – PG
  • bbfcR18 – R18
  • bbfcU – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
Rating video dari Board of Film and Video Censors 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 (Bundesminotherium für Unterricht, Kunst und Kultur).

Nilai yang valid untuk properti ini adalah:
  • bmukk10 – 10+
  • bmukk12 – 12+
  • bmukk14 – 14 tahun ke atas
  • bmukk16 – 16+
  • 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 di Kanada. Untuk informasi selengkapnya, lihat situs Canadian Broadcast Standards Council.

Nilai yang valid untuk properti ini adalah:
  • catv14plus – 14+
  • catv18plus – 18+
  • catvC – S
  • catvC8 – C8
  • catvG – S
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
Rating video dari Radio-Television and Telecommunications Commission (CRTC) Kanada untuk siaran berbahasa Prancis Kanada. Untuk mengetahui informasi selengkapnya, lihat situs Canadian Broadcast Standards Council.

Nilai yang valid untuk properti ini adalah:
  • catvfr13plus – 13 tahun ke atas
  • catvfr16plus – 16+
  • catvfr18plus – 18+
  • catvfr8plus – 8+
  • catvfrG – G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
Rating Central Board of Film Certification (CBFC - India) untuk 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) untuk video.

Nilai yang valid untuk properti ini adalah:
  • ccc14 – 14+
  • ccc18 – 18+
  • ccc18s – 18+ - contenido pornográfico
  • ccc18v – 18+ - konten berisi kekerasan
  • ccc6 – 6+ - Tidak nyaman untuk menores 7 tahun
  • cccTe – Perkiraan tugas
  • cccUnrated
contentDetails.contentRating.cceRating string
Rating video dari Komisi Klasifikasi Pertunjukan 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 tahun
  • chfilm6 – 6
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
Rating Canadian Home Video Rating System (CHVRS) untuk video.

Nilai yang valid untuk properti ini adalah:
  • chvrs14a – 14A
  • chvrs18a – 18A
  • chvrsE – T
  • chvrsG – S
  • 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
  • cna18plus – 18+
  • cnaAp – Asia
  • cnaUnrated
contentDetails.contentRating.cncRating string
Sistem rating di Prancis - Commission de classification cinematographique

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

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

Nilai yang valid untuk properti ini adalah:
  • cscf12 – 12
  • cscf16 – 16 tahun
  • 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 dari Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - Brazil) dari video ini.

Nilai yang valid untuk properti ini adalah:
  • djctq10 – 10
  • djctq12 – 12
  • djctq14 – 14
  • djctq16 – 16 tahun
  • djctq18 – 18
  • djctqL – L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
Alasan yang menjelaskan mengapa video menerima rating DJCQT (Brasil).
contentDetails.contentRating.ecbmctRating string
Sistem rating di Turki - Evaluation and Classification Board Kementerian Kebudayaan dan Pariwisata

Nilai yang valid untuk properti ini adalah:
  • ecbmct13a – 13A
  • ecbmct13plus – 13 tahun ke atas
  • ecbmct15a – 15A
  • ecbmct15plus – 15+
  • ecbmct18plus – 18+
  • ecbmct7a – 7A
  • ecbmct7plus – 7+
  • ecbmctG – G
  • ecbmctUnrated
  • ecbmct6a – 6A
  • ecbmct6plus – 6+
  • ecbmct10a – 10A
  • ecbmct10plus – 10+
  • ecbmct16plus – 16+
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 – K-16
  • 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 (映倫) video. Eirin adalah sistem rating Jepang.

Nilai yang valid untuk properti ini adalah:
  • eirinG – S
  • 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:
  • fcbm13 – 13
  • fcbm16 – 16 tahun
  • fcbm18 – 18 tahun
  • fcbm18pa – 18PA
  • fcbm18pl – 18PL
  • fcbm18sg – 18SG
  • fcbm18sx – 18SX
  • fcbmP12 – P12
  • fcbmP13 – P13
  • fcbmPg13 – PG13
  • fcbmU – U
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
Rating video dari Office for Film, Newspaper and Article Administration 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. Sebagai gantinya, gunakan properti contentDetails.contentRating.cncRating.

Rating Centre National du cinéma et de l'image animé (Kementerian Kebudayaan Prancis) pada video tersebut.

Nilai yang valid untuk properti ini adalah:
  • fmoc10 – 10
  • fmoc12 – 12
  • fmoc16 – 16 tahun
  • 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-12PG
  • fpb13 – 13
  • fpb16 – 16
  • fpb18 – 18
  • fpb79Pg – 7-9PG
  • fpbA – A
  • fpbPg – PG
  • 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) untuk 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 – T
  • grfilmK – K
  • grfilmK12 – Sekolah dasar dan menengah
  • grfilmK13 – K-13
  • grfilmK15 – K-15
  • grfilmK17 – Sekolah dasar dan menengah
  • grfilmK18 – K-18
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
Rating Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - Spanyol) untuk 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 Irish Film Classification Office (IFCO - Irlandia) untuk video. Lihat situs IFCO untuk mengetahui informasi selengkapnya.

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

Nilai yang valid untuk properti ini adalah:
  • ilfilm12 – 12
  • ilfilm16 – 16
  • ilfilm18 – 18 tahun
  • ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
Rating INCAA (Instituto Nacional de Cine y Artes Audiovisuales - Argentina) untuk 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 – PG
  • 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 Korea Media Rating Board (영상물등급위원회) untuk video. Video tarif KMRB di Korea Selatan.

Nilai yang valid untuk properti ini adalah:
  • kmrb12plus – 12 Syntax 이Syntax tarik람 tarik
  • kmrb15plus – 15세 이상 관람가
  • kmrbAll – 전체관람가
  • kmrbR – 청소년 VPAID람불 Alih
  • 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 – D
  • 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 Media Council for Children and Young People dari Danish Film Institute (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+
  • mcstC13 – C13
  • mcstC16 – C16
  • mcstC18 – C18
  • mcstP – P
  • mcstUnrated
  • mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 – T18
  • mcstK – K
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 – G
  • mdaM18 – M18
  • mdaNc16 – NC16
  • mdaPg – BO
  • 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
  • medietilsynet6 – 6
  • medietilsynet7 – 7
  • medietilsynet9 – 9
  • medietilsynetA – J
  • 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 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) untuk video.

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

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

Nilai yang valid untuk properti ini adalah:
  • mpaaG – G
  • mpaaNc17 – NC-17
  • mpaaPg – BO
  • 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 (Tali Hijau - 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 – S
  • mtrcbPg – PG
  • 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 tahun ke atas
  • nbc18plus – 18+
  • nbc18plusr – 18+R
  • nbcG – G
  • nbcPg – BO
  • nbcPu – PU
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
Rating video dari Bulgarian National Film Center.

Nilai yang valid untuk properti ini adalah:
  • nfrcA – J
  • nfrcB – B
  • nfrcC – S
  • nfrcD – S
  • 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 tahun
  • nfvcbG – G
  • nfvcbPg – PG
  • nfvcbRe – RE
  • 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 tahun ke atas
  • nkclv18plus – 18+
  • nkclv7plus – 7+
  • nkclvU – U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
Rating Office of Film and Literature Classification (OFLC - Selandia Baru) untuk video.

Nilai yang valid untuk properti ini adalah:
  • oflcG – G
  • oflcM – M
  • 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
  • pefilm18 – 18
  • 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 – S
  • resorteviolenciaD – D
  • resorteviolenciaE – T
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
Rating General Directorate of Radio, Television and Cinematography (Meksiko) untuk video.

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

Nilai yang valid untuk properti ini adalah:
  • rteCh – CH
  • rteGa – GA
  • rteMa – MA
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
Rating National Film Registry of the Russia (MKRF - Rusia) dari video ini.

Nilai yang valid untuk properti ini adalah:
  • russia0 – 0+
  • russia12 – 12+
  • russia16 – 16+
  • russia18 – 18+
  • 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
  • smais18 – 18 tahun
  • 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-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 atau tidak. Properti ini hanya dapat dilihat oleh uploader video.
status object
Objek status berisi informasi tentang status upload, pemrosesan, dan privasi video.
status.uploadStatus string
Status video yang diupload.

Nilai yang valid untuk properti ini adalah:
  • 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 publikasi video yang dijadwalkan. Video hanya dapat disetel ke mode ini jika status privasinya adalah pribadi. Nilai ditentukan dalam format ISO 8601. Perhatikan dua poin 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 di masa lalu, video tersebut akan segera dipublikasikan. Dengan demikian, efek menyetel properti status.publishAt ke tanggal dan waktu terdahulu 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 tontonan video dapat dilihat oleh publik. Secara default, statistik tersebut dapat dilihat, dan statistik seperti jumlah penayangan dan rating video akan tetap terlihat oleh publik meskipun nilai properti ini ditetapkan ke false.
status.madeForKids boolean
Nilai ini menunjukkan apakah video ditetapkan sebagai ditujukan untuk anak-anak, dan berisi status "Dibuat untuk Anak-Anak" video saat ini. Misalnya, status dapat ditentukan berdasarkan nilai properti selfDeclaredMadeForKids. Lihat Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya tentang cara menetapkan penonton untuk channel, video, atau siaran Anda.
status.selfDeclaredMadeForKids 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 ditampilkan jika pemilik channel mengizinkan permintaan API.
status.containsSyntheticMedia boolean
Dalam permintaan videos.insert atau videos.update, properti ini memungkinkan pemilik channel mengungkapkan bahwa video berisi konten Dimodifikasi atau Sintetis (A/S) yang realistis. Pelajari lebih lanjut kebijakan YouTube terkait konten A/S.

Contoh konten A/S mencakup video yang:
  • Membuat orang sungguhan terlihat mengatakan atau melakukan sesuatu yang sebenarnya tidak mereka katakan atau lakukan
  • Mengubah rekaman video suatu peristiwa atau tempat yang nyata
  • Menghasilkan adegan yang terlihat realistis yang sebenarnya tidak pernah terjadi
statistics object
Objek statistics berisi statistik tentang video.
statistics.viewCount unsigned long
Berapa kali video telah ditonton.
statistics.likeCount unsigned long
Jumlah pengguna yang menunjukkan bahwa mereka menyukai video tersebut.
statistics.dislikeCount unsigned long
Catatan: Properti statistics.dislikeCount telah ditetapkan ke pribadi mulai 13 Desember 2021. Artinya, properti disertakan dalam respons API hanya jika permintaan API diautentikasi oleh pemilik video. Lihat histori revisi untuk mengetahui informasi selengkapnya.

Jumlah pengguna yang menunjukkan bahwa mereka tidak menyukai video tersebut.
statistics.favoriteCount unsigned long
Catatan: Properti ini tidak digunakan lagi. Penghentian ini berlaku mulai 28 Agustus 2015. Nilai properti kini selalu ditetapkan ke 0.
statistics.commentCount unsigned long
Jumlah komentar untuk video.
paidProductPlacementDetails object
Objek paidProductPlacementDetails berisi informasi tentang penempatan produk berbayar dalam video.
paidProductPlacementDetails.hasPaidProductPlacement boolean
Tetapkan ke true jika konten menggunakan penempatan produk berbayar. Defaultnya adalah false.
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 ditetapkan secara default ke format 4:3.
player.embedHeight long
Tinggi pemutar tersemat yang ditampilkan di properti player.embedHtml. Properti ini hanya ditampilkan jika permintaan menentukan nilai untuk parameter maxHeight dan/atau maxWidth dan rasio aspek video diketahui.
player.embedWidth long
Lebar pemutar tersemat yang ditampilkan di properti player.embedHtml. Properti ini hanya ditampilkan jika permintaan menentukan nilai untuk parameter maxHeight dan/atau maxWidth dan rasio aspek video diketahui.
topicDetails object
Objek topicDetails merangkum informasi tentang topik yang terkait dengan video.

Penting: Lihat definisi properti topicDetails.relevantTopicIds[] dan topicDetails.topicIds[] serta histori revisi untuk mengetahui detail selengkapnya tentang perubahan mendatang terkait ID topik.
topicDetails.topicIds[] list
Penting: Properti ini tidak digunakan lagi mulai 10 November 2016. API tidak lagi menampilkan nilai untuk properti ini, dan topik apa pun yang terkait dengan video kini ditampilkan oleh nilai properti topicDetails.relevantTopicIds[].
topicDetails.relevantTopicIds[] list
Daftar ID topik yang relevan dengan video.

Properti ini tidak digunakan lagi mulai 10 November 2016. API ini akan didukung hingga 10 November 2017.

Penting: Karena Freebase dan Freebase API yang saat ini tidak digunakan lagi, fungsi 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 umum 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 untuk mengetahui detail selengkapnya.

Deskripsi teks 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, 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 mengetahui detail selengkapnya.

Lintang dalam derajat.
recordingDetails.location.longitude double
Properti ini tidak digunakan lagi mulai 1 Juni 2017. Lihat pengumuman penghentian untuk mengetahui 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 ellipsoid referensi, dalam meter.
recordingDetails.recordingDate datetime
Tanggal dan waktu perekaman video. Nilai ditentukan 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 saat file video maupun jenis file lainnya diupload.
fileDetails.fileSize unsigned long
Ukuran file yang diupload dalam byte. Kolom ini ada baik saat file video maupun jenis file lainnya 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 lainnya diupload.

Nilai yang valid untuk properti ini adalah:
  • archive – File adalah file arsip, seperti arsip .zip.
  • audio – File adalah jenis file audio yang dikenal, seperti file .mp3.
  • document – File adalah dokumen atau file teks, seperti dokumen MS Word.
  • image – File adalah file gambar, seperti gambar .jpeg.
  • other – File tersebut adalah jenis file non-video lainnya.
  • project – File ini adalah file proyek video, seperti proyek Microsoft Windows Movie Maker, yang tidak berisi data video sebenarnya.
  • video – File 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 terdapat dalam file video yang diupload. Setiap item dalam daftar berisi metadata mendetail tentang streaming video.
fileDetails.videoStreams[].widthPixels unsigned integer
Lebar konten video yang dienkode dalam piksel. Anda dapat menghitung rasio aspek encoding video sebagai width_pixels / height_pixels.
fileDetails.videoStreams[].heightPixels unsigned integer
Tinggi konten video yang dienkode dalam piksel.
fileDetails.videoStreams[].frameRateFps double
Kecepatan frame streaming video, dalam frame per detik.
fileDetails.videoStreams[].aspectRatio double
Rasio aspek tampilan konten video, yang menentukan rasio aspek tempat video akan ditampilkan.
fileDetails.videoStreams[].codec string
Codec video yang digunakan streaming.
fileDetails.videoStreams[].bitrateBps unsigned long
Kecepatan bit streaming video, dalam bit per detik.
fileDetails.videoStreams[].rotation string
Jumlah yang diperlukan YouTube untuk merotasi konten sumber asli untuk menampilkan video dengan benar.

Nilai yang valid untuk properti ini adalah:
  • clockwise – Video perlu diputar 90 derajat searah jarum jam.
  • counterClockwise – Video perlu diputar 90 derajat berlawanan arah jarum jam.
  • none – Video tidak perlu diputar.
  • other – Video perlu diputar dengan cara lain yang tidak biasa.
  • 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 terdapat dalam file video yang diupload. Setiap item dalam daftar berisi metadata mendetail tentang streaming audio.
fileDetails.audioStreams[].channelCount unsigned integer
Jumlah saluran audio yang dimuat streaming.
fileDetails.audioStreams[].codec string
Codec audio yang digunakan streaming tersebut.
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 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 di objek mengidentifikasi status pemrosesan saat ini dan perkiraan waktu yang tersisa hingga YouTube selesai memproses video. Bagian ini juga menunjukkan apakah berbagai jenis data atau konten, seperti detail file atau gambar thumbnail, tersedia untuk video.

Objek processingProgress dirancang untuk melakukan polling, sehingga video yang diupload dapat melacak progres yang telah dibuat YouTube dalam memproses file video yang diupload. Data ini hanya dapat diambil oleh pemilik video.
processingDetails.processingStatus string
Status pemrosesan video. Nilai ini menunjukkan apakah YouTube dapat memproses video atau 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 dilakukan 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. Jumlah ini 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 perkiraan jumlah bagian 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 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 telah 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 untuk memproses video, peringatan yang menjelaskan masalah pemrosesan video, atau error yang menyebabkan masalah pemrosesan video. Anda dapat mengambil saran ini dengan meminta bagian suggestions dalam permintaan videos.list() Anda.
processingDetails.tagSuggestionsAvailability string
Nilai ini menunjukkan apakah saran kata kunci (tag) tersedia untuk video. Tag dapat ditambahkan ke metadata video untuk memudahkan pengguna lain menemukan video. Anda dapat mengambil saran ini dengan meminta bagian suggestions dalam permintaan videos.list() Anda.
processingDetails.editorSuggestionsAvailability string
Nilai ini menunjukkan apakah saran pengeditan video, yang dapat meningkatkan kualitas video atau pengalaman pemutaran, tersedia untuk video tersebut. Anda dapat mengambil saran ini dengan meminta bagian suggestions dalam permintaan videos.list() Anda.
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 berhasil memproses video yang diupload. Error ini menunjukkan bahwa, terlepas dari status pemrosesan video saat ini, pada akhirnya, status tersebut hampir pasti akan menjadi failed.

Nilai yang valid untuk properti ini adalah:
  • archiveFile – File arsip (misalnya, arsip ZIP).
  • audioFile – File hanya berisi audio (misalnya, file MP3).
  • docFile – Dokumen atau file teks (misalnya, Dokumen MS Word).
  • imageFile – File gambar (misalnya, gambar JPEG).
  • notAVideoFile – File non-video lainnya.
  • projectFile – File project film (mis., Project Microsoft Windows Movie Maker).
suggestions.processingWarnings[] list
Daftar alasan mengapa YouTube mungkin mengalami kesulitan dalam melakukan transcoding video yang diupload atau yang mungkin menyebabkan transcoding yang salah. Peringatan ini dibuat sebelum YouTube benar-benar memproses file video yang diupload. Selain itu, mereka 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 tidak ada.

Nilai yang valid untuk properti ini adalah:
  • hasEditlist – Daftar edit saat ini tidak didukung.
  • inconsistentResolution – Resolusi penampung dan streaming yang bertentangan.
  • problematicAudioCodec – Codec audio yang diketahui menyebabkan masalah digunakan.
  • problematicVideoCodec – Codec video yang diketahui menyebabkan masalah telah digunakan.
  • unknownAudioCodec – Codec audio tidak dikenal, transcoding kemungkinan akan gagal.
  • unknownContainer – Format file tidak dikenal, transcoding kemungkinan akan gagal.
  • unknownVideoCodec – Codec video yang 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, sehingga akan memperlambat pemrosesan.
  • sendBestQualityVideo – Mungkin ada versi video yang berkualitas lebih baik.
suggestions.tagSuggestions[] list
Daftar tag kata kunci yang dapat ditambahkan ke metadata video untuk meningkatkan kemungkinan pengguna menemukan video Anda saat menelusuri atau melakukan penelusuran di YouTube.
suggestions.tagSuggestions[].tag string
Tag kata kunci yang disarankan untuk video.
suggestions.tagSuggestions[].categoryRestricts[] list
Kumpulan kategori video yang relevan dengan tag. 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 diganti dengan kualitas yang lebih baik.
  • videoAutoLevels – Tingkat kecerahan gambar tampak tidak aktif dan dapat diperbaiki.
  • videoCrop – Margin (matte) yang terdeteksi di sekitar gambar dapat dipangkas.
  • videoStabilize – Video tampak goyang dan dapat distabilkan.
liveStreamingDetails object
Objek liveStreamingDetails berisi metadata tentang siaran video live. Objek hanya akan ada di resource video jika video adalah siaran live mendatang, live, atau yang telah selesai.
liveStreamingDetails.actualStartTime datetime
Waktu siaran benar-benar dimulai. Nilai ditentukan dalam format ISO 8601. Nilai ini tidak akan tersedia hingga siaran dimulai.
liveStreamingDetails.actualEndTime datetime
Waktu siaran benar-benar berakhir. Nilai ditentukan dalam format ISO 8601. Nilai ini tidak akan tersedia sampai siaran selesai.
liveStreamingDetails.scheduledStartTime datetime
Waktu siaran dijadwalkan untuk dimulai. Nilai ditentukan dalam format ISO 8601.
liveStreamingDetails.scheduledEndTime datetime
Waktu siaran dijadwalkan untuk berakhir. Nilai ditentukan dalam format ISO 8601. Jika nilainya kosong atau properti tidak ada, siaran dijadwalkan untuk berlanjut tanpa batas waktu.
liveStreamingDetails.concurrentViewers unsigned long
Jumlah penonton yang sedang menonton siaran. Properti dan nilainya akan ada jika siaran memiliki penonton saat ini dan pemilik siaran belum menyembunyikan jumlah penayangan untuk video. Perhatikan bahwa YouTube berhenti melacak jumlah penonton serentak untuk siaran saat siaran berakhir. Jadi, properti ini tidak akan mengidentifikasi jumlah penonton yang menonton video live streaming yang diarsipkan dan telah berakhir.
Jumlah penonton serentak yang ditampilkan YouTube Data API mungkin berbeda dengan jumlah penonton serentak yang telah diproses dan dihapus spamnya yang tersedia melalui YouTube Analytics. Pelajari metrik live streaming lebih lanjut di Pusat Bantuan YouTube.
liveStreamingDetails.activeLiveChatId string
ID live chat yang saat ini aktif dan disertakan ke video ini. Kolom ini hanya diisi jika video merupakan live streaming saat ini dan memiliki live chat. Setelah siaran bertransisi untuk menyelesaikan, kolom ini akan dihapus dan live chat akan ditutup. Untuk siaran persisten, ID live chat tidak akan lagi dikaitkan dengan video ini, tetapi 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.