Mengubah informasi beberapa file audio dan video.
Deskripsi operasi
Catatan penggunaan
Anda dapat menemukan file audio atau video berdasarkan ID-nya. Anda dapat mengubah judul, tag, deskripsi, dan informasi lain dari file audio atau video tersebut. Jika parameter diteruskan, bidang yang sesuai akan diperbarui. Jika tidak, bidang tersebut tidak akan ditimpa atau diperbarui.
Anda dapat mengubah informasi hingga 20 file audio atau video sekaligus.
Batas QPS
Batas kueri per detik (QPS) untuk satu pengguna pada Operasi API ini adalah 30. Jika jumlah panggilan per detik melebihi batas, pembatasan kecepatan akan dipicu. Hal ini dapat memengaruhi bisnis Anda. Panggil operasi ini pada laju yang wajar. Untuk informasi lebih lanjut, lihat Batas QPS.
Coba sekarang
Test
RAM authorization
|
Action |
Access level |
Resource type |
Condition key |
Dependent action |
|
vod:UpdateVideoInfos |
update |
*Semua resource.
|
None | None |
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| UpdateContent |
string |
Yes |
Konten pembaruan. Anda dapat mengubah informasi objek hingga 20 file audio atau video sekaligus. Pisahkan informasi objek dari beberapa file audio atau video dengan koma (,). Jika Anda mencoba memperbarui lebih dari 20 file sekaligus, pembaruan akan gagal dan error |
[{"VideoId":"f45cf4eba5cb90233389558c39****","Title":"Alibaba Cloud VOD Video Title1"},{"VideoId":"f45cf4eba5c84233389558c36****","Title":"Alibaba Cloud VOD Video Title2"}] |
UpdateContent
Nilai UpdateContent harus dikonversi menjadi string sebelum diteruskan sebagai parameter permintaan.
| Parameter | Tipe | Diperlukan | Deskripsi |
| VideoId | String | Ya | ID file audio atau video. Anda dapat memperoleh ID dengan menggunakan salah satu metode berikut: Jika file audio atau video diunggah menggunakan konsol, masuk ke Konsol ApsaraVideo VOD dan pilih Aset Media > Audio/Video untuk melihat ID. Saat Anda memanggil Operasi API Obtain the upload URL and credential for a video untuk mendapatkan URL unggah dan kredensial, ID adalah nilai dari parameter respons VideoId. Setelah file audio atau video diunggah, Anda dapat memanggil Operasi API Search for media information untuk mengkueri ID. ID adalah nilai dari parameter respons VideoId. |
| Title | String | Tidak | Judul file audio atau video. |
| Description | String | Tidak | Deskripsi file audio atau video. |
| Tags | String | Tidak | Tag. Satu tag tidak boleh melebihi 32 byte. Anda dapat menambahkan hingga 16 tag. Pisahkan beberapa tag dengan koma (,). Tag harus dienkode dalam UTF-8. |
| CoverURL | String | Tidak | URL sampul audio atau video. |
| CateId | Long | Tidak | ID kategori. Anda dapat memperoleh ID dengan menggunakan salah satu metode berikut: Masuk ke Konsol ApsaraVideo VOD dan pilih Manajemen Konfigurasi > Pengaturan Manajemen Aset Media > Manajemen Kategori untuk melihat ID kategori. Saat Anda memanggil Operasi API Create a category untuk membuat kategori, ID adalah nilai dari parameter respons CateId. Saat Anda memanggil Operasi API Query categories and subcategories untuk mengkueri kategori, ID adalah nilai dari parameter respons CateId. |
| ReferenceId | String | Tidak | ID kustom. ID hanya dapat berisi huruf kecil, huruf besar, digit, tanda hubung (-), dan garis bawah (_), serta harus memiliki panjang 6 hingga 64 karakter. ID harus unik untuk setiap pengguna. |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Hasil yang dikembalikan. |
||
| RequestId |
string |
ID permintaan. |
25818875-5F78-4AF6-D7393642CA58**** |
| ForbiddenVideoIds |
array |
ID file audio atau video yang operasinya dilarang. Hal ini biasanya disebabkan oleh kurangnya izin. |
|
|
string |
ID file audio atau video yang operasinya dilarang. Hal ini biasanya disebabkan oleh kurangnya izin. |
f45cf4eba5c84233389558c36**** |
|
| NonExistVideoIds |
array |
ID file audio atau video yang tidak ada. |
|
|
string |
ID file audio atau video yang tidak ada. |
f45cf4eba5cb90233389558c39**** |
|
| NonExistReferenceIds |
array |
ID kustom yang tidak ada. |
|
|
string |
ID kustom yang tidak ada. |
123-123 |
Contoh
Respons sukses
JSONformat
{
"RequestId": "25818875-5F78-4AF6-D7393642CA58****",
"ForbiddenVideoIds": [
"f45cf4eba5c84233389558c36****"
],
"NonExistVideoIds": [
"f45cf4eba5cb90233389558c39****"
],
"NonExistReferenceIds": [
"123-123"
]
}
Kode kesalahan
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.