Watermarks

Resource watermark mengidentifikasi gambar yang ditampilkan selama pemutaran video channel tertentu. Anda juga dapat menentukan saluran target yang akan ditautkan dengan gambar serta detail pengaturan waktu yang menentukan kapan watermark muncul selama pemutaran video dan lamanya waktu terlihat.

Metode

API ini mendukung metode berikut untuk resource watermarks:

kumpulan

Mengupload gambar watermark ke YouTube dan menyetelnya untuk channel.

tidak disetel

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 mendefinisikan 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 offsetFromStart, kolom offsetMs akan merepresentasikan offset dari awal video. Jika nilainya offsetFromEnd, kolom offsetMs akan merepresentasikan offset dari akhir video.
timing.offsetMs	unsigned long Offset waktu, ditentukan dalam milidetik, yang 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 waktu, 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 menempatkan item yang dipromosikan di pemutar video. Nilai yang valid untuk properti ini adalah: sudut
position.cornerPosition	string Sudut pemain tempat item yang dipromosikan akan muncul. Item selalu muncul di sudut kanan atas pemutar video. 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 dari channel yang ditautkan oleh gambar watermark.