Watermarks

watermark kaynağı, belirli bir kanalın videolarını oynatma sırasında gösterilen bir 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üre 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:

belirtin
YouTube'a filigran resmi yükleyip bir kanal için ayarlar.
ayarlanmadı
Kanalın filigran resmini siler. Hemen deneyin.

Kaynak temsili

Aşağıdaki JSON yapısı, bir 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 kanalın filigran resminin gösterileceği video oynatma süresiyle ilgili bilgileri içerir.
timing.type string
Video oynatma sırasında filigran resminin ne zaman gösterileceğini belirleyen zamanlama yöntemi. Değer offsetFromStart ise offsetMs alanı, videonun başlangıcından itibaren ofseti temsil eder. Değer offsetFromEnd ise offsetMs alanı, videonun sonundaki ofseti temsil eder.
timing.offsetMs unsigned long
Tanıtılan öğenin video oynatmaları sırasında ne zaman görüneceğini belirleyen, belirli bir zaman aralığı (milisaniye cinsinden belirtilir). type özelliğinin değeri, ofsetin videonun başlangıcından mı yoksa sonundan mı ölçüldüğünü belirler.
timing.durationMs unsigned long
Filigran resminin gösterileceği süre (milisaniye cinsinden).
position object
position nesnesi, videodaki filigran resminin görüntüleneceği uzamsal konumla ilgili bilgileri içerir.
position.type string
Tanıtılan öğenin video oynatıcıda konumlandırılma şekli.

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

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