Watermarks

watermark kaynağı, belirtilen bir kanalın videoları oynatılırken görüntülenen resmi tanımlar. Ayrıca, resmin bağlanacağı hedef kanalı ve video oynatma sırasında filigranın ne zaman görüneceğini ve ne kadar süre boyunca görüneceğini belirleyen zamanlama ayrıntılarını da belirtebilirsiniz.

Yöntemler

API, watermarks kaynakları için aşağıdaki yöntemleri destekler:

ayar
YouTube'a filigran resmi yükler ve bunu bir kanal için ayarlar.
ayarlanmadı
Kanalın filigran resmini siler. Hemen deneyin.

Kaynak temsili

Aşağıdaki JSON yapısı, watermarks kaynağının biçimini gösterir:

{
  "timing": {
    "type": string,
    "offsetMs": unsigned long,
    "durationMs": unsigned long
  },
  "position": {
    "type": string,
    "cornerPosition": string
  },
  "imageUrl": string,
  "imageBytes": bytes,
  "targetChannelId": string
}

Özellikler

Aşağıdaki tabloda bu kaynakta görünen özellikler tanımlanmaktadır:

Özellikler
timing object
timing nesnesi, bir video oynatma sırasında kanal filigran resminin gösterileceği zamanla ilgili bilgileri içerir.
timing.type string
Filigran resminin video oynatma sırasında ne zaman gösterileceğini belirleyen zamanlama yöntemi. Değer offsetFromStart ise offsetMs alanı, videonun başlangıcından itibaren bir ofseti temsil eder. Değer offsetFromEnd ise offsetMs alanı, videonun sonundan itibaren bir ofseti temsil eder.
timing.offsetMs unsigned long
Tanıtılan öğenin video oynatmaları sırasında ne zaman gösterileceğini belirleyen, milisaniye cinsinden belirtilen zaman farkı. type özelliğinin değeri, ofsetin videonun başlangıcından mı yoksa sonundan mı ölçüleceğini belirler.
timing.durationMs unsigned long
Filigran resminin gösterileceği süre (milisaniye cinsinden).
position object
position nesnesi, video içinde filigran resminin gösterileceği uzamsal konumla ilgili bilgileri içerir.
position.type string
Tanıtılan öğenin video oynatıcıda konumlandırılma şekli.

Bu mülk için geçerli değerler şunlardır:
  • köşe
position.cornerPosition string
Tanıtılan öğenin görüneceği oynatıcının köşesi. Öğe her zaman oynatıcının sağ üst köşesinde görünür.

Bu mülk için geçerli değerler şunlardır:
  • topRight
imageUrl string
Kanalın filigran resminin URL'si. YouTube, bu URL'yi oluşturur ve watermark.set isteğine verdiği API yanıtında döndürür.
imageBytes bytes
Filigran resminin bayt cinsinden boyutu.
targetChannelId string
Filigran resminin bağlantı verdiği kanalın YouTube kanal kimliği.