Watermarks

watermark kaynağı, belirli 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.
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 geçen süreyi temsil eder. Değer offsetFromEnd ise offsetMs alanı, videonun sonundan itibaren bir uzaklığı temsil 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ı. type özelliğinin değeri, ofsetin videonun başından mı yoksa sonundan mı ölçüleceğini belirler.
timing.durationMs unsigned long
Filigran resminin gösterilmesi gereken süre (milisaniye cinsinden).
position object
position nesnesi, filigran resminin gösterileceği videodaki konumsal konum hakkında bilgileri kapsar.
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
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 özelliğin geçerli değerleri şunlardır:
  • topRight
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ğlandığı kanalın YouTube kanal kimliği.