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:
|
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:
|
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. |