Resource watermark
mengidentifikasi gambar yang ditampilkan selama pemutaran video channel tertentu. Anda juga dapat menentukan saluran target yang akan ditautkan ke gambar serta detail pengaturan waktu yang menentukan kapan watermark muncul selama pemutaran video dan durasi tampilannya.
Metode
API mendukung metode berikut untuk resource watermarks
:
- setel
- Mengupload gambar watermark ke YouTube dan menyetelnya untuk channel.
- batalkan penyetelan
- Menghapus gambar watermark channel. Coba sekarang.
Representasi resource
Struktur JSON di bawah ini menunjukkan format resource watermarks
:
{ "timing": { "type": string, "offsetMs": unsigned long, "durationMs": unsigned long }, "position": { "type": string, "cornerPosition": string }, "imageUrl": string, "imageBytes": bytes, "targetChannelId": string }
Properti
Tabel berikut menentukan properti yang muncul di resource ini:
Properti | |
---|---|
timing |
object Objek timing mengenkapsulasi informasi tentang waktu selama pemutaran video saat gambar watermark channel akan ditampilkan. |
timing.type |
string Metode pengaturan waktu yang menentukan kapan gambar watermark ditampilkan selama pemutaran video. Jika nilainya adalah offsetFromStart , kolom offsetMs mewakili offset dari awal video. Jika nilainya offsetFromEnd , kolom offsetMs mewakili offset dari akhir video. |
timing.offsetMs |
unsigned long Offset waktu, yang ditentukan dalam milidetik, menentukan kapan item yang dipromosikan muncul selama pemutaran video. Nilai properti type menentukan apakah offset diukur dari awal atau akhir video. |
timing.durationMs |
unsigned long Durasi, dalam milidetik, saat gambar watermark harus ditampilkan. |
position |
object Objek position mengenkapsulasi informasi tentang posisi spasial dalam video tempat gambar watermark akan ditampilkan. |
position.type |
string Cara item yang dipromosikan diposisikan di pemutar video. Nilai yang valid untuk properti ini adalah:
|
position.cornerPosition |
string Sudut pemutar tempat item yang dipromosikan akan muncul. Item selalu muncul di sudut kanan atas pemutar. Nilai yang valid untuk properti ini adalah:
|
imageUrl |
string URL untuk gambar watermark channel. YouTube akan membuat URL ini dan menampilkannya dalam respons API untuk permintaan watermark.set . |
imageBytes |
bytes Ukuran gambar watermark, dalam byte. |
targetChannelId |
string ID channel YouTube dari channel yang ditautkan ke gambar watermark. |