Watermarks

Resource watermark mengidentifikasi gambar yang ditampilkan selama pemutaran video channel tertentu. Anda juga dapat menentukan channel target yang akan ditautkan ke gambar serta detail pengaturan waktu yang menentukan kapan watermark muncul selama pemutaran video dan berapa lama watermark tersebut terlihat.

Metode

API ini mendukung metode berikut untuk resource watermarks:

set

Mengupload gambar watermark ke YouTube dan menyetelnya untuk channel.

unset

Menghapus gambar watermark channel. Coba sekarang.

Representasi resource

Struktur JSON di bawah 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 merangkum informasi tentang waktu selama pemutaran video saat gambar watermark channel akan ditampilkan. Objek ini diperlukan saat memanggil watermarks.set.
timing.type	string Metode pengaturan waktu yang menentukan kapan gambar watermark ditampilkan selama pemutaran video. Properti ini diperlukan saat memanggil watermarks.set. Nilai yang valid adalah: offsetFromStart: Kolom offsetMs menunjukkan offset dari awal video. offsetFromEnd: Kolom offsetMs menunjukkan offset dari akhir video.
timing.offsetMs	unsigned long Selisih waktu, yang ditentukan dalam milidetik, yang menentukan kapan item promosi muncul selama pemutaran video. Properti ini diperlukan saat memanggil watermarks.set. Jika type adalah offsetFromEnd, offsetMs harus minimal 1000 milidetik.
timing.durationMs	unsigned long Durasi waktu, dalam milidetik, saat gambar watermark harus ditampilkan. Properti ini bersifat opsional. Jika ditentukan, durasi minimumnya adalah 1000 milidetik. Jika type adalah offsetFromEnd, durationMs tidak boleh melebihi offsetMs.
position	object Tidak digunakan lagi: Objek position tidak digunakan lagi dan diabaikan oleh YouTube. Watermark selalu ditampilkan di pojok kanan atas pemutar video.
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 yang ditautkan ke gambar watermark.