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 waktu yang menentukan kapan tanda air muncul selama pemutaran video dan berapa lama tanda air 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.
timing.type string
Metode pengaturan waktu yang menentukan kapan gambar watermark ditampilkan selama pemutaran video. Jika nilainya adalah offsetFromStart, kolom offsetMs akan merepresentasikan offset dari awal video. Jika nilainya adalah offsetFromEnd, kolom offsetMs akan merepresentasikan offset dari akhir video.
timing.offsetMs unsigned long
Offset waktu, yang ditentukan dalam milidetik, yang menentukan kapan item promosi muncul selama pemutaran video. Nilai properti type menentukan apakah offset diukur dari awal atau akhir video.
timing.durationMs unsigned long
Durasi waktu, dalam milidetik, saat gambar watermark harus ditampilkan.
position object
Objek position merangkum informasi tentang posisi spasial dalam video tempat gambar watermark akan ditampilkan.
position.type string
Cara item promosi diposisikan di pemutar video.

Nilai yang valid untuk properti ini adalah:
  • sudut
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:
  • topRight
imageUrl string
URL untuk gambar watermark channel. YouTube akan membuat URL ini dan menampilkannya dalam respons API terhadap permintaan watermark.set.
imageBytes bytes
Ukuran gambar watermark, dalam byte.
targetChannelId string
ID channel YouTube yang ditautkan ke gambar watermark.