Mengupload thumbnail video kustom ke YouTube dan menyetelnya untuk video.
Metode ini mendukung upload media. File yang diupload harus sesuai dengan batasan berikut:
- Ukuran file maksimum: 2 MB
- Jenis MIME Media yang diterima:
image/jpeg
,image/png
,application/octet-stream
Dampak kuota: Panggilan ke metode ini memiliki biaya kuota sekitar 50 unit.
Kasus penggunaan umum
Permintaan
Permintaan HTTP
POST https://www.googleapis.com/upload/youtube/v3/thumbnails/set
Otorisasi
Permintaan ini memerlukan otorisasi dengan setidaknya satu cakupan berikut (baca selengkapnya tentang autentikasi dan otorisasi).
Cakupan |
---|
https://www.googleapis.com/auth/youtubepartner |
https://www.googleapis.com/auth/youtube.upload |
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
Parameter
Tabel berikut mencantumkan parameter yang didukung kueri ini. Semua parameter yang tercantum adalah parameter kueri.
Parameter | ||
---|---|---|
Parameter yang diperlukan | ||
videoId |
string Parameter videoId menentukan ID video YouTube yang menyediakan thumbnail video kustom. |
|
Parameter opsional | ||
onBehalfOfContentOwner |
string Catatan: Parameter ini ditujukan secara eksklusif untuk partner konten YouTube. Parameter onBehalfOfContentOwner menunjukkan bahwa kredensial otorisasi permintaan mengidentifikasi pengguna YouTube CMS yang bertindak atas nama pemilik konten yang ditentukan dalam nilai parameter. Parameter ini ditujukan untuk partner konten YouTube yang memiliki dan mengelola berbagai channel YouTube. Tindakan ini memungkinkan pemilik konten mengautentikasi satu kali dan mendapatkan akses ke semua data video dan channel mereka, tanpa harus memberikan kredensial autentikasi untuk setiap channel. Akun CMS sebenarnya yang diautentikasi pengguna harus ditautkan ke pemilik konten YouTube tertentu. |
Isi permintaan
Isi permintaan berisi gambar thumbnail yang Anda upload. Isi permintaan tidak berisi resource thumbnail
.
Respons
Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:
{ "kind": "youtube#thumbnailSetResponse", "etag": etag, "items": [ thumbnail resource ] }
Properti
Tabel berikut menentukan properti yang muncul dalam resource ini:
Properti | |
---|---|
kind |
string Mengidentifikasi jenis resource API. Nilai akan menjadi youtube#thumbnailSetResponse . |
etag |
etag Etag resource ini. |
items[] |
list Daftar thumbnail. |
Error
Tabel berikut mengidentifikasi pesan error yang dapat ditampilkan API sebagai respons terhadap panggilan untuk metode ini. Lihat dokumentasi pesan error untuk detail selengkapnya.
Jenis error | Detail error | Deskripsi |
---|---|---|
badRequest (400) |
invalidImage |
Konten gambar yang diberikan tidak valid. |
badRequest (400) |
mediaBodyRequired |
Permintaan tidak menyertakan konten gambar. |
forbidden (403) |
forbidden |
Thumbnail tidak dapat ditetapkan untuk video yang ditentukan. Permintaan mungkin tidak diotorisasi dengan benar. |
forbidden (403) |
forbidden |
Pengguna terautentikasi tidak memiliki izin untuk mengupload dan menetapkan thumbnail video kustom. |
notFound (404) |
videoNotFound |
Video yang Anda coba sisipkan gambar thumbnail tidak dapat ditemukan. Periksa nilai parameter videoId permintaan untuk memastikan bahwa parameter tersebut sudah benar. |
tooManyRequests (429) |
uploadRateLimitExceeded |
Channel baru-baru ini mengupload terlalu banyak thumbnail. Coba kirim permintaan lagi nanti. |
Cobalah!
Gunakan APIs Explorer untuk memanggil API ini dan lihat permintaan dan respons API.