Videos

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

Resource video mewakili video YouTube.

Metode

API ini mendukung metode berikut untuk resource videos:

getRating
Mengambil rating yang diberikan pengguna yang diberi otorisasi ke daftar video yang ditentukan. Coba sekarang.
list
Menampilkan daftar video yang cocok dengan parameter permintaan API. Coba sekarang.
sisipkan
Mengupload video ke YouTube dan secara opsional menyetel metadata video.
pembaruan
Memperbarui metadata video. Coba sekarang.
hapus
Menghapus video YouTube. Coba sekarang.
tarif
Menambahkan rating suka atau tidak suka ke video, atau menghapus rating dari video. Coba sekarang.
reportAbuse
Melaporkan video yang berisi konten yang melanggar. Coba sekarang.

Representasi resource

Struktur JSON berikut menunjukkan format resource videos:

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

Properti

Tabel berikut menentukan properti yang muncul di resource ini:

Properti
kind string
Mengidentifikasi jenis resource API. Nilainya akan berupa youtube#video.
etag etag
Etag referensi ini.
id string
ID yang digunakan YouTube untuk mengidentifikasi video secara unik.
snippet object
Objek snippet berisi detail dasar tentang video, seperti judul, deskripsi, dan kategorinya.
snippet.publishedAt datetime
Tanggal dan waktu video dipublikasikan. Perhatikan bahwa waktu ini mungkin berbeda dengan waktu video diupload. Misalnya, jika video diupload sebagai video pribadi, kemudian dipublikasikan di lain waktu, properti ini akan menentukan kapan video tersebut dipublikasikan.

Ada beberapa kasus khusus:
  • Jika video diupload sebagai video pribadi dan metadata video diambil oleh pemilik channel, nilai properti akan menentukan tanggal dan waktu video diupload.
  • Jika video diupload sebagai video tidak publik, nilai properti juga menentukan tanggal dan waktu video tersebut diupload. Dalam hal ini, siapa pun yang mengetahui ID video unik dari video tersebut dapat mengambil metadata video.
Nilai ini ditentukan dalam format ISO 8601.
snippet.channelId string
ID yang digunakan YouTube untuk mengidentifikasi channel yang menjadi tujuan upload video secara unik.
snippet.title string
Judul video. Nilai properti memiliki panjang maksimum 100 karakter dan dapat berisi semua karakter UTF-8 yang valid, kecuali < dan >. Anda harus menetapkan nilai untuk properti ini jika memanggil metode videos.update dan memperbarui bagian snippet dari resource video.
snippet.description string
Deskripsi video. Nilai properti memiliki panjang maksimum 5.000 byte dan dapat berisi semua karakter UTF-8 yang valid, kecuali < dan >.
snippet.thumbnails object
Peta gambar thumbnail yang terkait dengan video. Untuk setiap objek dalam peta, kuncinya adalah nama gambar thumbnail, dan nilainya adalah objek yang berisi informasi lain tentang thumbnail.
snippet.thumbnails.(key) object
Nilai kunci yang valid adalah:
  • default – Gambar thumbnail default. Thumbnail default untuk video – atau resource yang merujuk ke video, misalnya item playlist atau hasil penelusuran – memiliki lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk saluran adalah lebar 88 piksel dan tinggi 88 piksel.
  • medium – Versi gambar thumbnail beresolusi lebih tinggi. Untuk video (atau sumber daya yang merujuk ke video), gambar ini memiliki lebar 320 px dan tinggi 180 px. Untuk channel, gambar ini memiliki lebar 240 piksel dan tinggi 240 piksel.
  • high – Versi gambar thumbnail beresolusi tinggi. Untuk video (atau sumber daya yang merujuk ke video), gambar ini memiliki lebar 480 px dan tinggi 360 px. Untuk channel, gambar ini memiliki lebar 800 piksel dan tinggi 800 piksel.
  • standard – Versi gambar thumbnail beresolusi lebih tinggi daripada gambar resolusi high. Gambar ini tersedia untuk beberapa video dan referensi lain yang merujuk ke video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 640px dan tinggi 480px.
  • maxres – Versi gambar thumbnail beresolusi tertinggi. Ukuran gambar ini tersedia untuk beberapa video dan sumber daya lain yang merujuk ke video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 1280px dan tinggi 720px.
snippet.thumbnails.(key).url string
URL gambar.
snippet.thumbnails.(key).width unsigned integer
Lebar gambar.
snippet.thumbnails.(key).height unsigned integer
Tinggi gambar.
snippet.channelTitle string
Judul channel untuk channel tempat video tersebut berada.
snippet.tags[] list
Daftar tag kata kunci yang terkait dengan video. Tag dapat berisi spasi. Nilai properti memiliki panjang maksimum 500 karakter. Perhatikan aturan berikut mengenai cara penghitungan batas karakter:
  • Nilai properti berupa daftar, dan tanda koma di antara item dalam daftar dihitung terhadap batas.
  • Jika tag berisi spasi, server API akan menangani nilai tag seolah-olah nilai tersebut dikemas dalam tanda kutip, dan tanda kutip dihitung terhadap batas karakter. Jadi, untuk tujuan batas karakter, tag Foo-Baz berisi tujuh karakter, tetapi tag Foo Baz berisi sembilan karakter.
snippet.categoryId string
Kategori video YouTube yang terkait dengan video tersebut. Anda harus menetapkan nilai untuk properti ini jika memanggil metode videos.update dan memperbarui bagian snippet dari resource video.
snippet.liveBroadcastContent string
Menunjukkan apakah video adalah live streaming mendatang/aktif. Atau "tidak ada" jika video bukan merupakan live streaming mendatang/aktif.

Nilai yang valid untuk properti ini adalah:
  • live
  • none
  • upcoming
snippet.defaultLanguage string
Bahasa teks di properti snippet.title dan snippet.description resource video.
snippet.localized object
Objek snippet.localized berisi judul dan deskripsi yang dilokalkan untuk video atau judul dalam bahasa default untuk metadata video.
  • Teks yang dilokalkan ditampilkan dalam cuplikan resource jika permintaan videos.list menggunakan parameter hl untuk menentukan bahasa yang akan digunakan untuk menampilkan teks yang dilokalkan dan teks yang dilokalkan tersedia dalam bahasa tersebut.
  • Metadata untuk bahasa default ditampilkan jika nilai parameter hl tidak ditentukan atau nilai ditentukan, tetapi metadata yang dilokalkan tidak tersedia untuk bahasa yang ditentukan.
Properti 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 diucapkan dalam trek audio default video.
contentDetails object
Objek contentDetails berisi informasi tentang konten video, termasuk durasi video dan indikasi apakah teks tersedia untuk video.
contentDetails.duration string
Durasi video. Nilai properti berupa durasi ISO 8601. Misalnya, untuk video yang berdurasi minimal satu menit dan kurang dari satu jam, durasinya menggunakan format PT#M#S, dengan huruf PT menunjukkan bahwa nilai menentukan periode waktu, dan huruf M dan S merujuk pada durasi dalam menit dan detik. Karakter # sebelum huruf M dan S adalah bilangan bulat yang menentukan jumlah menit (atau detik) video. Misalnya, nilai PT15M33S menunjukkan bahwa video berdurasi 15 menit 33 detik.

Jika video berdurasi minimal satu jam, durasinya menggunakan format PT#H#M#S, dengan # sebelum huruf H menentukan durasi video dalam jam dan semua detail lainnya sama dengan yang dijelaskan di atas. Jika video berdurasi minimal satu hari, huruf P dan T akan dipisahkan, dan format nilainya adalah P#DT#H#M#S. Lihat spesifikasi ISO 8601 untuk detail selengkapnya.
contentDetails.dimension string
Menunjukkan apakah video tersedia dalam 3D atau 2D.
contentDetails.definition string
Menunjukkan apakah video tersedia dalam definisi tinggi (HD) atau hanya dalam definisi standar.

Nilai yang valid untuk properti ini adalah:
  • 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 mewakili konten berlisensi, yang berarti konten diupload ke channel yang ditautkan ke partner konten YouTube lalu diklaim oleh partner tersebut.
contentDetails.regionRestriction object
Objek regionRestriction berisi informasi tentang negara tempat video dapat (atau tidak) dapat dilihat. Objek akan berisi properti contentDetails.regionRestriction.allowed atau properti contentDetails.regionRestriction.blocked.
contentDetails.regionRestriction.allowed[] list
Daftar kode wilayah yang mengidentifikasi negara tempat video dapat ditonton. Jika properti ini ada dan suatu negara tidak tercantum dalam nilainya, video tersebut akan diblokir agar tidak muncul di negara tersebut. Jika properti ini ada dan berisi daftar kosong, video akan diblokir di semua negara.
contentDetails.regionRestriction.blocked[] list
Daftar kode wilayah yang mengidentifikasi negara tempat video diblokir. Jika properti ini ada dan negara tidak tercantum dalam nilainya, video dapat ditonton di negara tersebut. Jika properti ini ada dan berisi daftar kosong, video dapat dilihat di semua negara.
contentDetails.contentRating object
Menentukan rating yang diterima video dalam berbagai skema rating.
contentDetails.contentRating.acbRating string
Rating Australian Classification Board (ACB) atau Australian Communications and Media Authority (ACMA) pada video. Rating ACMA digunakan untuk mengklasifikasikan program televisi anak-anak.

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

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

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

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

Nilai yang valid untuk properti ini adalah:
  • bfvc13 – 13 tahun
  • bfvc15 – 15
  • bfvc18 – 18 tahun
  • bfvc20 – 20
  • bfvcB – M
  • bfvcE – T
  • bfvcG – H
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
Rating video dari Austrian Board of Media Classification (Bundesministerium für Unterricht, Kunst und Kultur).

Nilai yang valid untuk properti ini adalah:
  • bmukk10 – 10+
  • bmukk12 – 12 tahun ke atas
  • bmukk14 – 14 tahun ke atas
  • bmukk16 – 16 tahun ke atas
  • bmukk6 – 6+
  • bmukk8 – 8+
  • bmukkAa – Tidak dibatasi
  • bmukkUnrated
contentDetails.contentRating.catvRating string
Sistem rating untuk TV Kanada - Sistem Klasifikasi TV Kanada. Rating video dari Canadian Radio-Television and Telecommunications Commission (CRTC) untuk siaran berbahasa Inggris Kanada. Untuk informasi selengkapnya, lihat situs Canadian Broadcast Standards Council.

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

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

Nilai yang valid untuk properti ini adalah:
  • cbfcA – A
  • cbfcS – S
  • cbfcU – P
  • 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) video.

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

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

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

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

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

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

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

Nilai yang valid untuk properti ini adalah:
  • csa10 – 10
  • csa12 – 12 tahun
  • csa16 – 16 tahun
  • csa18 – 18 tahun
  • 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 tahun
  • cscf16 – 16 tahun
  • cscf18 – 18 tahun
  • cscf6 – 6
  • cscf9 – 9
  • cscfA – A
  • cscfAl – AL
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
Rating video di Republik Ceko.

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

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

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

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

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

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

Nilai yang valid untuk properti ini adalah:
  • fcbm13 – 13 tahun
  • fcbm16 – 16 tahun
  • fcbm18 – 18 tahun
  • fcbm18pa – 18PA
  • fcbm18pl – 18PL
  • fcbm18sg – 18SG
  • fcbm18sx – 18 DT
  • fcbmP12 – P12
  • fcbmP13 – P13
  • fcbmPg13 – PG13
  • fcbmU – P
  • 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. Gunakan properti contentDetails.contentRating.cncRating sebagai gantinya.

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

Nilai yang valid untuk properti ini adalah:
  • fmoc10 – 10
  • fmoc12 – 12 tahun
  • fmoc16 – 16 tahun
  • fmoc18 – 18 tahun
  • fmocE – T
  • fmocU – P
  • 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 tahun
  • fpb16 – 16 tahun
  • fpb18 – 18 tahun
  • fpb79Pg – 7-9PG
  • fpbA – A
  • fpbPg – BO
  • fpbUnrated
  • fpbX18 – X18
  • fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[] list
Alasan yang menjelaskan mengapa video mendapatkan rating FPB (Afrika Selatan).
contentDetails.contentRating.fskRating string
Rating Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - Jerman) dari video.

Nilai yang valid untuk properti ini adalah:
  • 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 – rb
  • grfilmK12 – Sekolah dasar dan menengah
  • grfilmK13 – Sekolah dasar dan menengah
  • grfilmK15 – Sekolah dasar dan menengah
  • grfilmK17 – Sekolah dasar dan menengah
  • grfilmK18 – Sekolah dasar dan menengah
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
Rating Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - Spanyol).

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

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

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

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

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

Nilai yang valid untuk properti ini adalah:
  • kijkwijzer12 – 12 tahun
  • kijkwijzer14 – 14 tahun
  • kijkwijzer16 – 16 tahun
  • kijkwijzer18 – 18 tahun
  • kijkwijzer6 – 6
  • kijkwijzer9 – 9
  • kijkwijzerAl – AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
Rating Korea Media Rating Board (영 diterjemahkan물등의위cpm회) video. Tarif KMRB untuk video di Korea Selatan.

Nilai yang valid untuk properti ini adalah:
  • kmrb12plus – 12 FCM 이리 관람가
  • kmrb15plus – 15 FCM 이MAPS 관람가
  • kmrbAll – SECOND체 Insights람가
  • kmrbR – 청소년 Connect람불 penjelajahan
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
Rating video dari Lembaga Sensor Film Indonesia.

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

Nilai yang valid untuk properti ini adalah:
  • mccaa12 – 12 tahun
  • mccaa12a – 12A
  • mccaa14 – 14 - rating ini telah dihapus dari struktur klasifikasi baru yang diperkenalkan pada tahun 2013.
  • mccaa15 – 15
  • mccaa16 – 16 - rating ini telah dihapus dari struktur klasifikasi baru yang diperkenalkan pada tahun 2013.
  • mccaa18 – 18 tahun
  • mccaaPg – BO
  • mccaaU – P
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
Rating video dari Denmark Film Institute's (Det Danske Filminstitut) Media Council for Children and Young People.

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

Nilai yang valid untuk properti ini adalah:
  • mcst0 – 0
  • mcst16plus – 16 tahun ke atas
  • mcstC13 – C13
  • mcstC16 – C16
  • mcstC18 – C18
  • mcstP – P
  • mcstUnrated
  • mcstT13 – T13
  • mcstT16 – T16
  • mcstT18 – T18
  • mcstK – rb
contentDetails.contentRating.mdaRating string
Rating video dari Media Development Authority (MDA) Singapura dan khususnya, Dewan Sensor Film (BFC) Singapura.

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

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

Nilai yang valid untuk properti ini adalah:
  • meku12 – 12 tahun
  • meku16 – 16 tahun
  • meku18 – 18 tahun
  • meku7 – 7
  • mekuS – S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
Rating video dari Ministero dei Beni e delle Attività Culturali e del Turismo (Italia).

Nilai yang valid untuk properti ini adalah:
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
Rating Ministerio de Cultura (Kolombia) pada video.

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

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

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

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

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

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

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

Nilai yang valid untuk properti ini adalah:
  • nfvcb12 – 12 tahun
  • nfvcb12a – 12A
  • nfvcb15 – 15
  • nfvcb18 – 18 tahun
  • nfvcbG – H
  • nfvcbPg – BO
  • nfvcbRe – BL
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
Rating video dari centrs Nacionàlais Kino (National Film Centre of Latvia).

Nilai yang valid untuk properti ini adalah:
  • nkclv12plus – 12 tahun ke atas
  • nkclv18plus – 18 tahun ke atas
  • nkclv7plus – 7+
  • nkclvU – P
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
Rating Office of Film and Literature Classification (OFLC - New Zealand) video.

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

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

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

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

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

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

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

Nilai yang valid untuk properti ini adalah:
  • smais12 – 12 tahun
  • smais14 – 14 tahun
  • smais16 – 16 tahun
  • smais18 – 18 tahun
  • smais7 – 7
  • smaisL – L
  • 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 TV (TVPG) dari 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 memberikan gambar thumbnail kustom untuk video atau tidak. Properti ini hanya dapat dilihat oleh uploader video.
status object
Objek status berisi informasi tentang status upload, pemrosesan, dan privasi video.
status.uploadStatus string
Status video yang diupload.

Nilai yang valid untuk properti ini adalah:
  • deleted
  • failed
  • processed
  • rejected
  • uploaded
status.failureReason string
Nilai ini menjelaskan penyebab video gagal diupload. Properti ini hanya ada jika properti uploadStatus menunjukkan bahwa upload gagal.

Nilai yang valid untuk properti ini adalah:
  • codec
  • conversion
  • emptyFile
  • invalidFile
  • tooSmall
  • uploadAborted
status.rejectionReason string
Nilai ini menjelaskan alasan YouTube menolak video yang diupload. Properti ini hanya ada jika properti uploadStatus menunjukkan bahwa upload ditolak.

Nilai yang valid untuk properti ini adalah:
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
Status privasi video.

Nilai yang valid untuk properti ini adalah:
  • private
  • public
  • unlisted
status.publishAt datetime
Tanggal dan waktu video dijadwalkan untuk dipublikasikan. Kebijakan ini hanya dapat disetel jika status privasi video adalah pribadi. Nilai ini ditentukan dalam format ISO 8601. Perhatikan dua poin tambahan berikut tentang perilaku properti ini:
  • 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 yang telah berlalu, video tersebut akan segera dipublikasikan. Dengan demikian, efek menetapkan properti status.publishAt ke tanggal dan waktu yang lalu sama dengan mengubah privacyStatus video dari private ke public.
status.license string
Lisensi video.

Nilai yang valid untuk properti ini adalah:
  • creativeCommon
  • youtube
status.embeddable boolean
Nilai ini menunjukkan apakah video dapat disematkan di situs lain atau tidak.
status.publicStatsViewable boolean
Nilai ini menunjukkan apakah statistik video yang diperluas di halaman tonton video dapat dilihat oleh publik. Secara default, statistik tersebut dapat dilihat, dan statistik seperti jumlah penayangan dan rating video akan tetap terlihat oleh publik meskipun nilai properti ini ditetapkan ke false.
status.madeForKids boolean
Nilai ini menunjukkan apakah video ditetapkan sebagai ditujukan untuk anak-anak, dan berisi status "Dibuat untuk Anak-Anak" saat ini dari video. Misalnya, status mungkin ditentukan berdasarkan nilai properti selfDeclaredMadeForKids. Lihat Pusat Bantuan YouTube untuk mengetahui informasi selengkapnya tentang cara menetapkan penonton untuk channel, video, atau siaran Anda.
status.selfDeclaredMadeForKids boolean
Dalam permintaan videos.insert atau videos.update, properti ini memungkinkan pemilik channel untuk menetapkan video sebagai ditujukan untuk anak-anak. Dalam permintaan videos.list, nilai properti hanya ditampilkan jika pemilik saluran mengizinkan permintaan API.
statistics object
Objek statistics berisi statistik tentang video.
statistics.viewCount unsigned long
Berapa kali video telah ditonton.
statistics.likeCount unsigned long
Jumlah pengguna yang menunjukkan bahwa mereka menyukai video tersebut.
statistics.dislikeCount unsigned long
Catatan: Properti statistics.dislikeCount telah disetel sebagai pribadi mulai 13 Desember 2021. Artinya, properti akan disertakan dalam respons API hanya jika permintaan API diautentikasi oleh pemilik video. Lihat histori revisi untuk informasi selengkapnya.

Jumlah pengguna yang menunjukkan bahwa mereka tidak menyukai video tersebut.
statistics.favoriteCount unsigned long
Catatan: Properti ini sudah tidak digunakan lagi. Penghentian tersebut berlaku mulai 28 Agustus 2015. Nilai properti sekarang selalu ditetapkan ke 0.
statistics.commentCount unsigned long
Jumlah komentar untuk video.
player object
Objek player berisi informasi yang akan Anda gunakan untuk memutar video di pemutar tersemat.
player.embedHtml string
Tag <iframe> yang menyematkan pemutar yang memutar video.
  • Jika permintaan API untuk mengambil resource menetapkan nilai untuk parameter maxHeight dan/atau maxWidth, ukuran pemutar tersemat akan diskalakan untuk memenuhi persyaratan maxHeight dan/atau maxWidth.
  • Jika rasio aspek video tidak diketahui, pemutar sematan akan disetel secara default ke format 4:3.
player.embedHeight long
Tinggi pemutar sematan yang ditampilkan di properti player.embedHtml. Properti ini hanya ditampilkan jika permintaan menentukan nilai untuk parameter maxHeight dan/atau maxWidth serta rasio aspek video diketahui.
player.embedWidth long
Lebar pemutar sematan yang ditampilkan di properti player.embedHtml. Properti ini hanya ditampilkan jika permintaan menentukan nilai untuk parameter maxHeight dan/atau maxWidth serta rasio aspek video diketahui.
topicDetails object
Objek topicDetails merangkum informasi tentang topik yang terkait dengan video.

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

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

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

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

Deskripsi teks untuk lokasi tempat video direkam.
recordingDetails.location object
Informasi geolokasi yang terkait dengan video. Perhatikan bahwa nilai properti turunan mengidentifikasi lokasi yang ingin dikaitkan oleh pemilik video dengan video. Nilai dapat diedit, dapat ditelusuri di video publik, dan dapat ditampilkan kepada pengguna untuk video publik.
recordingDetails.location.latitude double
Properti ini tidak digunakan lagi mulai 1 Juni 2017. Lihat pengumuman penghentian untuk detail selengkapnya.

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

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

Ketinggian di atas elipsoid referensi, dalam meter.
recordingDetails.recordingDate datetime
Tanggal dan waktu video direkam. Nilai ditentukan dalam format ISO 8601 (YYYY-MM-DDThh:mm:ss.sssZ).
fileDetails object
Objek fileDetails merangkum informasi tentang file video yang diupload ke YouTube, termasuk resolusi file, durasi, codec audio dan video, kecepatan bit streaming, serta lainnya. Data ini hanya dapat diambil oleh pemilik video.

Objek fileDetails hanya akan ditampilkan jika properti processingDetails.fileAvailability memiliki nilai available.
fileDetails.fileName string
Nama file yang diupload. Bidang ini menunjukkan apakah file video atau jenis file lainnya telah diupload.
fileDetails.fileSize unsigned long
Ukuran file yang diupload dalam byte. Bidang ini menunjukkan apakah file video atau jenis file lainnya telah diupload.
fileDetails.fileType string
Jenis file yang diupload sebagaimana yang terdeteksi oleh mesin pemrosesan video YouTube. Saat ini, YouTube hanya memproses file video, tetapi kolom ini berisi file video atau jenis file lainnya yang telah diupload.

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

Nilai yang valid untuk properti ini adalah:
  • 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 mudah.
  • upsideDown – Video perlu diputar secara terbalik.
fileDetails.videoStreams[].vendor string
Nilai yang mengidentifikasi vendor video secara unik. Biasanya, nilainya adalah kode vendor yang terdiri dari empat huruf.
fileDetails.audioStreams[] list
Daftar streaming audio yang ada dalam file video yang diupload. Setiap item dalam daftar berisi metadata mendetail tentang streaming audio.
fileDetails.audioStreams[].channelCount unsigned integer
Jumlah saluran audio yang ada dalam streaming.
fileDetails.audioStreams[].codec string
Codec audio yang digunakan streaming.
fileDetails.audioStreams[].bitrateBps unsigned long
Kecepatan bit streaming audio, dalam bit per detik.
fileDetails.audioStreams[].vendor string
Nilai yang mengidentifikasi vendor video secara unik. Biasanya, nilainya adalah kode vendor yang terdiri dari empat huruf.
fileDetails.durationMs unsigned long
Durasi video yang diupload dalam milidetik.
fileDetails.bitrateBps unsigned long
Kecepatan bit gabungan (video dan audio) dari file video yang diupload dalam bit per detik.
fileDetails.creationTime string
Tanggal dan waktu file video yang diupload dibuat. Nilai ini ditentukan dalam format ISO 8601. Saat ini, format ISO 8601 berikut didukung:
  • 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 merangkum informasi tentang progres YouTube dalam memproses file video yang diupload. Properti dalam objek mengidentifikasi status pemrosesan saat ini dan perkiraan waktu yang tersisa hingga YouTube selesai memproses video. Bagian ini juga menunjukkan apakah berbagai jenis data atau konten, seperti detail file atau gambar thumbnail, tersedia untuk video.

Objek processingProgress dirancang untuk di-polling sehingga video yang diupload dapat melacak progres yang telah dibuat YouTube dalam memproses file video yang diupload. Data ini hanya dapat diambil oleh pemilik video.
processingDetails.processingStatus string
Status pemrosesan video. Nilai ini menunjukkan apakah YouTube dapat memproses video atau video masih diproses.

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

Perhatikan bahwa karena estimasi jumlah bagian dapat meningkat tanpa peningkatan jumlah bagian yang telah diproses, kemungkinan progres yang dihitung dapat menurun secara berkala saat YouTube memproses video.
processingDetails.processingProgress.timeLeftMs unsigned long
Estimasi jumlah waktu, dalam mildetik, yang diperlukan YouTube untuk menyelesaikan pemrosesan video.
processingDetails.processingFailureReason string
Alasan YouTube gagal memproses video tersebut. Properti ini hanya akan memiliki nilai jika nilai properti processingStatus adalah failed.

Nilai yang valid untuk properti ini adalah:
  • other – Beberapa komponen pemrosesan lainnya gagal.
  • streamingFailed – Video tidak dapat dikirim ke streamer.
  • transcodeFailed – Transcoding konten gagal.
  • uploadFailed – Pengiriman file gagal.
processingDetails.fileDetailsAvailability string
Nilai ini menunjukkan apakah detail file tersedia untuk video yang diupload. Anda dapat mengambil detail file video dengan meminta bagian fileDetails dalam permintaan videos.list() Anda.
processingDetails.processingIssuesAvailability string
Nilai ini menunjukkan apakah mesin pemrosesan video telah memberikan saran yang dapat meningkatkan kemampuan YouTube dalam memproses video, peringatan yang menjelaskan masalah pemrosesan video, atau error yang menyebabkan masalah pemrosesan video. Anda dapat mengambil saran ini dengan meminta bagian suggestions pada permintaan videos.list() Anda.
processingDetails.tagSuggestionsAvailability string
Nilai ini menunjukkan apakah saran kata kunci (tag) tersedia untuk video. Tag dapat ditambahkan ke metadata video untuk memudahkan pengguna lain menemukan video tersebut. Anda dapat mengambil saran ini dengan meminta bagian suggestions pada permintaan videos.list() Anda.
processingDetails.editorSuggestionsAvailability string
Nilai ini menunjukkan apakah saran pengeditan video, yang dapat meningkatkan kualitas video atau pengalaman pemutaran, tersedia untuk video tersebut. Anda dapat mengambil saran ini dengan meminta bagian suggestions pada permintaan videos.list() Anda.
processingDetails.thumbnailsAvailability string
Nilai ini menunjukkan apakah gambar thumbnail telah dibuat untuk video atau belum.
suggestions object
Objek suggestions merangkum saran yang mengidentifikasi peluang untuk meningkatkan kualitas video atau metadata untuk video yang diupload. Data ini hanya dapat diambil oleh pemilik video.

Objek suggestions hanya akan ditampilkan jika properti processingDetails.tagSuggestionsAvailability atau properti processingDetails.editorSuggestionsAvailability memiliki nilai available.
suggestions.processingErrors[] list
Daftar error yang akan mencegah YouTube memproses video yang diupload. Error ini menunjukkan bahwa, terlepas dari status pemrosesan video saat ini, pada akhirnya, status tersebut hampir dipastikan akan menjadi failed.

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

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

Nilai yang valid untuk properti ini adalah:
  • nonStreamableMov – File MP4 tidak dapat di-streaming, hal ini akan memperlambat pemrosesan.
  • sendBestQualityVideo – Mungkin ada versi video dengan kualitas yang lebih baik.
suggestions.tagSuggestions[] list
Daftar tag kata kunci yang dapat ditambahkan ke metadata video untuk meningkatkan kemungkinan pengguna akan menemukan video Anda saat menelusuri atau menjelajah di YouTube.
suggestions.tagSuggestions[].tag string
Tag kata kunci yang disarankan untuk video.
suggestions.tagSuggestions[].categoryRestricts[] list
Serangkaian kategori video yang tag-nya relevan. Anda dapat menggunakan informasi ini untuk menampilkan saran tag yang sesuai berdasarkan kategori video yang dikaitkan oleh uploader video dengan video. Secara default, saran tag relevan untuk semua kategori jika tidak ada batasan yang ditentukan untuk kata kunci.
suggestions.editorSuggestions[] list
Daftar operasi pengeditan video yang dapat meningkatkan kualitas video atau pengalaman pemutaran dari video yang diupload.

Nilai yang valid untuk properti ini adalah:
  • audioQuietAudioSwap – Trek audio tampak senyap dan dapat ditukar dengan yang berkualitas lebih baik.
  • videoAutoLevels – Tingkat kecerahan gambar tampak nonaktif 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 merupakan live streaming yang akan datang, live, atau sudah selesai.
liveStreamingDetails.actualStartTime datetime
Waktu siaran benar-benar dimulai. Nilai ini ditentukan dalam format ISO 8601. Nilai ini tidak akan tersedia hingga siaran dimulai.
liveStreamingDetails.actualEndTime datetime
Waktu siaran benar-benar berakhir. Nilai ini ditentukan dalam format ISO 8601. Nilai ini tidak akan tersedia hingga siaran selesai.
liveStreamingDetails.scheduledStartTime datetime
Waktu siaran dijadwalkan untuk dimulai. Nilai ini ditentukan dalam format ISO 8601.
liveStreamingDetails.scheduledEndTime datetime
Waktu siaran dijadwalkan untuk berakhir. Nilai ini ditentukan dalam format ISO 8601. Jika nilai kosong atau properti tidak ada, siaran akan dijadwalkan untuk berlanjut tanpa batas.
liveStreamingDetails.concurrentViewers unsigned long
Jumlah penonton yang saat ini menonton siaran. Properti dan nilainya akan ada jika siaran memiliki penonton saat ini dan pemilik siaran belum menyembunyikan jumlah penayangan untuk video. Perhatikan bahwa YouTube akan berhenti melacak jumlah penonton serentak untuk siaran ketika siaran berakhir. Jadi, properti ini tidak akan mengidentifikasi jumlah penonton yang menonton video live streaming yang diarsipkan yang sudah berakhir.
Jumlah penonton serentak yang ditampilkan YouTube Data API mungkin berbeda dari jumlah penonton serentak yang telah diproses dan dijadikan bukan spam yang tersedia melalui YouTube Analytics. Pelajari lebih lanjut metrik live streaming di Pusat Bantuan YouTube.
liveStreamingDetails.activeLiveChatId string
ID live chat yang sedang aktif yang dilampirkan pada video ini. Kolom ini hanya diisi jika video merupakan live streaming yang saat ini memiliki live chat. Setelah transisi siaran untuk menyelesaikan kolom ini akan dihapus dan live chat akan ditutup. Untuk siaran terus-menerus, ID live chat tidak akan lagi dikaitkan dengan video ini, melainkan dengan video baru yang ditampilkan di halaman persisten.
localizations object
Objek localizations berisi terjemahan metadata video.
localizations.(key) object
Bahasa teks yang dilokalkan yang terkait dengan nilai kunci. Nilainya adalah string yang berisi kode bahasa BCP-47.
localizations.(key).title string
Judul video yang dilokalkan.
localizations.(key).description string
Deskripsi video yang dilokalkan.