Halaman ini diterjemahkan oleh Cloud Translation API.

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.

Lihat ID topik yang didukung mulai 15 Februari 2017

Topik
Topik musik
/m/04rlf	Musik (topik orang tua)
/m/02mscn	musik rohani Kristen
/m/0ggq0m	Musik klasik
/m/01lyv	Negara
/m/02lkt	Musik elektronik
/m/0glt670	Musik hip hop
/m/05rwpb	Musik independen
/m/03_d0	Jazz
/m/028sqc	Musik Asia
/m/0g293	Musik Amerika Latin
/m/064t9	Musik pop
/m/06cqb	Reggae
/m/06j6l	Rhythm and blues
/m/06by7	Musik rock
/m/0gywn	Musik soul
Topik game
/m/0bzvm2	Game (topik induk)
/m/025zzc	Game aksi
/m/02ntfj	Game petualangan aksi
/m/0b1vjn	Game kasual
/m/02hygl	Video game musik
/m/04q1x3q	Video game teka-teki
/m/01sjng	Video game balapan
/m/0403l3g	Video game RPG
/m/021bp2	Video game simulasi
/m/022dc6	Game olahraga
/m/03hf_rm	Video game strategi
Topik olahraga
/m/06ntj	Olahraga (topik induk)
/m/0jm_	Sepak bola Amerika
/m/018jz	Bisbol
/m/018w8	Bola Basket
/m/01cgz	Tinju
/m/09xp_	Kriket
/m/02vx4	Sepak Bola
/m/037hz	Golf
/m/03tmr	Hoki es
/m/01h7lh	Seni bela diri campuran
/m/0410tth	Motorsport
/m/07bs0	Tenis
/m/07_53	Bola Voli
Topik hiburan
/m/02jjt	Hiburan (topik induk)
/m/09kqc	Humor
/m/02vxn	Film
/m/05qjc	Seni pertunjukan
/m/066wd	Gulat profesional
/m/0f2f9	Acara TV
Topik gaya hidup
/m/019_rr	Gaya hidup (topik induk)
/m/032tl	Mode
/m/027x7n	Kebugaran
/m/02wbm	Makanan
/m/03glg	Hobi
/m/068hy	Hewan peliharaan
/m/041xxh	Daya tarik fisik [Kecantikan]
/m/07c1v	Teknologi
/m/07bxq	Pariwisata
/m/07yv9	Kendaraan
Topik masyarakat
/m/098wr	Masyarakat (topik induk)
/m/09s1f	Bisnis
/m/0kt51	Kesehatan
/m/01h6rj	Militer
/m/05qt0	Politik
/m/06bvp	Agama
Topik lainnya
/m/01k8wb	Informasi

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.