Watermarks

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

Yöntemler

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

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

Kaynak temsili

Aşağıdaki JSON yapısında, watermarks kaynağının biçimi gösterilmektedir:

{
  "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, video oynatma sırasında kanalın filigran resminin gösterileceği zamanla ilgili bilgileri kapsar. Bu nesne, watermarks.set çağrılırken gereklidir.
timing.type string
Filigran resminin video oynatma sırasında ne zaman gösterileceğini belirleyen zamanlama yöntemi. Bu özellik, watermarks.set çağrılırken gereklidir.

Geçerli değerler:
  • offsetFromStart: offsetMs alanı, videonun başlangıcından itibaren geçen süreyi ifade eder.
  • offsetFromEnd: offsetMs alanı, videonun sonundan itibaren bir uzaklığı ifade eder.
timing.offsetMs unsigned long
Tanıtılan öğenin video oynatılırken ne zaman görüneceğini belirleyen ve milisaniye cinsinden belirtilen zaman farkı. Bu özellik, watermarks.set çağrılırken gereklidir. type, offsetFromEnd olduğunda offsetMs en az 1000 milisaniye olmalıdır.
timing.durationMs unsigned long
Filigran resminin milisaniye cinsinden ne kadar süreyle görüntüleneceği. Bu özellik isteğe bağlıdır. Belirtilirse minimum süre 1000 milisaniyedir. type değeri offsetFromEnd olduğunda durationMs değeri offsetMs'ü aşmamalıdır.
position object
Desteği sonlandırıldı: position nesnesinin desteği sonlandırıldı ve YouTube tarafından yok sayılıyor. Filigranlar her zaman video oynatıcının sağ üst köşesinde gösterilir.
imageUrl string
Kanalın filigran resminin URL'si. YouTube bu URL'yi oluşturur ve watermark.set isteğine verilen 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.