XML video açıklaması

Video formatı ovs:available_format öğesinin özelliklerinde açıklanmaktadır. Video kalitesinin ve parametrelerin her birleşimi ayrı format öğesinin özelliklerinde açıklanmalıdır.

Aşağıdaki alanlar desteklenir:

• codecs (zorunlu özellik): bu format için kullanılabilir kod.

• width: piksel olarak videonun genişliği.

• height: piksel olarak videonun yüksekliği.

• bitrate: kbit/sn olarak maksimum bit geçiş hızı (bit rate).

• quality — videonun kalitesi.

  Desteklenen değerler şöyle:

  • low — düşük kalite (çözünürlük 360×640 altı, bitrate 717 kbps altı);

  • medium — orta kalite (çözünürlük 360×640 ile 720×1280 arası, bitrate 717 kbps ile 1 Mbps arası);

  • HD — HD kalitesi (çözünürlük 720×1280 ile 1080×1920 arası, bitrate 1-2 Mbps);

  • full HD — Full HD kalitesi (çözünürlük 1080×1920 üstü, bitrate 2 Mbps üstü).

• size — Kilobayt olarak video dosyasının boyutu.

İşaretleme örneği:

<ovs:available_format>
<ovs:format codecs="h.264" width="320" height="240" quality="low" bitrate="250"/>
<ovs:format codecs="h.264" width="854" height="480" quality="medium" bitrate="800"/>
<ovs:format codecs="h.264" width="1280" height="720" quality="HD" bitrate="1800"/>
<ovs:format codecs="h.264" width="1920" height="1080" quality="full HD" bitrate="2800"/>
</ovs:available_format>

Category öğesinin değerinde, videonun ilişkin olduğu kategori belirtilebilir. Yandex tarafından tavsiye edilen kategoriler ve ilgili değerler aşağıda listelendi. Listede uygun bir kategori bulunmadığında kendi kategorinizi oluşturup uygun bir değer belirtebilirsiniz.

Mevcut kategoriler

• Oto-moto (auto_moto).

• Animasyon (animation).

• Webinarlar (webinars).

• Web kameralar (webcams).

• Ev, aile, çocuk (home_family_kids).

• Hayvanlar (animals).

• Sağlık (health).

• Oyunlar (games).

• Röportaj (interview).

• İnternet (internet).

• Sanat (art).

• Tarih (history).

• Karaoke (karaoke).

• Felaketler ve olaylar (disasters_and_accidents).

• Klip (clip).

• Konser (concert).

• Kısa video (short_video).

• Güzellik ve moda (beauty_and_fashion).

• Yemek (recipe).

• Müzik ve video klipler (music).

• Çizgi filmler (cartoons).

• Bilim (science).

• Haber (news).

• Eğitim (education).

• Parodi (parody).

• Politika (politics).

• Doğa (nature).

• Programlar (software).

• Canlı yayın (broadcast).

• Gezi (travel).

• Eğlence (entertainment).

• Reklam (commercial).

• Bahçe (Gardening).

• Kendin yap (handmade).

• Slayt gösterisi (slideshow).

• Spor (sport).

• Yaşam tarzı (lifestyle).

• Dans (dancing).

• TV (TV).

• Dizi (tvseries).

• TV programı (tvshow).

• Teknoloji (gadget).

• Ürünler (goods).

• Fragman (trailer).

• Hobi (hobby).

• Film (movie).

• Kamera arkası (movie_about_movie).

• Parça (fragment).

Virgüllerle ayrırarak veya farklı elementlerde birkaç kategori belirtebilirsiniz. Örneğin videonun bir filmin fragmanı veya konser kaydı olduğunu belirtebilirsiniz.

İşaretleme örneği:

<ovs:category>movie</ovs:category>
<ovs:category>trailer</ovs:category>

Bazı video kategorileri için ek işaretleme mevcuttur:

Film (ovs:movie)

Desteklenen özellikler:

• ovs:original_name: orijinal dilinde filmin adı.

• ovs:release_date: filmin vizyona giriş tarihi. Kesin tarih bilinmiyorsa filmin vizyona girdiği yıl için 1 Ocak tarihini belirtin.

• ovs:part: birkaç bölümden oluşan filmler için bölüm numarası (örneğin "Harry Potter ve Ölüm Yadigarları: Bölüm 1").

İşaretleme örneği:

<ovs:movie>
  <ovs:original_name>Harry Porter ve Ölüm Yadigarları</ovs:original_name>
  <ovs:release_date>2013-03-04T00:00:00</ovs:release_date>
  <ovs:part>1</ovs:part>
</ovs:movie>

Dizi (ovs:tvseries)

Desteklenen özellikler:

• ovs:episode (zorunlu alan): bölüm numarası.

• ovs:season: sezon numarası.

• ovs:release_date: bölümün yayına girdiği tarih.

• ovs:original_name: üretici dilindeki isim.

İşaretleme örneği:

<ovs:tvseries>
    <ovs:original_name>The Big Bang Theory</ovs:original_name>
      <ovs:release_date>2013-03-04T00:00:00</ovs:release_date>
      <ovs:season>6</ovs:season>
      <ovs:episode>15</ovs:episode>
</ovs:tvseries>

Müzik klibi (ovs:music)

Desteklenen özellikler:

• ovs:track_name (zorunlu alan): parça adı.

• ovs:album: albüm adı.

İşaretleme örneği:

<ovs:music>
      <track_name>A Bar In Amsterdam</track_name>
      <album>Le Pop</album>
</ovs:music>

TV programı (ovs:tvshow)

Desteklenen özellikler:

• ovs:episode (zorunlu alan): yayın numarası.

• ovs:season: sezon numarası.

• ovs:release_date: TV programının yayına girdiği tarihi.

İşaretleme örneği:

<ovs:tvshow>
    <ovs:original_name>Top Gear</ovs:original_name>
      <ovs:release_date>2013-03-04T00:00:00</ovs:release_date>
      <ovs:season>19</ovs:season>
      <ovs:episode>2</ovs:episode>
</ovs:tvshow>

Canlı yayın (ovs:broadcast)

Desteklenen özellikler:

• ovs:start_date (zorunlu alan): yayının başlangıç tarihi ve saati.

• ovs:end_date: yayının bitiş tarihi ve saati. Yayın bittikten sonra kayda aynı adresten ulaşılabiliyorsa doldurulması gerekmiyor.

İşaretleme örneği:

<ovs:broadcast>
      <ovs:start_date>2013-04-04T00:00:00</ovs:start_date>
      <ovs:end_date>2013-04-04T00:30:00</ovs:end_date>
</ovs:broadcast>

Videonun ek açıklaması için bu kategorilerden sadece bir tanesi kullanılabilir (örneğin, ovs:movie ve ovs:tvshow öğeleri aynı anda kullanılamaz). Ek öğe belirtme zorunluluğu yok; video ile ilgili detaylı bilgi yoksa, ovs:category öğesi için gerekli değeri belirlemek yeterlidir.

Desteklenen özellikler:

• embed_url: ayrı sayfada bulunan videoyu eklemek için bağlantı.

  Bağlantı oluşturulmadıysa oynatıcının kodunu eklemek için embed_html alanını kullanabilirsiniz.

• embed_html — oynatıcıyı eklemek için HTML kod (embed_url alanı için bağlantı oluşturulamadıysa belirtilir).

• allow_embed: videonun Yandex arama sonuçları sayfasında gösterilmesinin mümkün olduğunun belirtisidir.

  Varsayılan olarak video doğrudan arama sonuçları sayfasından oynatılabilir. Videonun sadece sizin sitenizde izlenebilmesi için <ovs:allow_embed>no</ovs:allow_embed> öğesini ekleyin.

• available_platform: videonun oynatılabildiği platformdur.

  Desteklenen platform listesi örneği:

  <ovs:available_platform>Windows</ovs:available_platform>
  <ovs:available_platform>WindowsPhone</ovs:available_platform>

  Geçerli platformun tam listesi:

  • Desktop: belli başlı işletim sistemlerinin (aşağıda sıralanmıştır) desteklendiğinin belirtisidir,

  • Windows,

  • Linux,

  • OSX,

  • Mobile: belli başlı mobil platformların (aşağıda sıralanmıştır) desteklendiğinin belirtisidir,

  • iOS,

  • Android,

  • WindowsPhone,

  • WindowsMobile,

  • Symbian,

  • Bada,

  • BlackBerry,

  • MeeGo.

Tarih ve saat ISO 8601 standartına uygun olarak YYYY-MM-DDTHH:mm:ss+02:00 formatında belirtilmelidir. Burada:

• YYYY — yıl

• AA — ay

• GG — gün

• SS — saat

• dd — dakika

• ss — saniye

• +02:00 — saat dilimi (bu örnekte İstanbul saati).

Sadece yıl belirtmek istiyorsanız (örneğin, filmin vizyona giriş tarihi olarak) gerekli yıl için tarihi 1 Ocak olarak , saati ise gece yarısı olarak belirtin. Örneğin, 2001-01-01T00:00:00.

İşaretleme örneği:

<ovs:created_date>2013-07-15T15:00:00</ovs:created_date>
<ovs:upload_date>2013-07-19T02:35:10</ovs:upload_date>

Video izleme ve reyting istatistiklerini şu özelliklerin yardımıyla ovs:stats öğesinde açıklayabilirsiniz:

• views_last_day: videonun bir günde kaç kere izlendiği.

• views_last_month: videonun bir ayda kaç kere izlendiği.

• views_last_week: videonun son bir haftada kaç kere izlendiği.

• views_total: videonun toplam izlenme sayısı.

• comments: videoyla ilgili olarak yapılan toplam yorumların sayısı.

• likes: videoyu beğenen kullanıcıların sayısı.

• dislikes: videoyu beğenmeyen kullanıcıların sayısı.

• rating: videonun ortalama derecesi (0 ile 10 arası).

İşaretleme örneği:

<ovs:stats>
      <views_last_day>0</views_last_day>
      <views_last_month>45454</views_last_month>
      <views_last_week>5454</views_last_week>
      <views_total>544787</views_total>
      <comments>5</comments>
      <likes>54</likes>
      <dislikes>1</dislikes>
      <rating>6</rating>
      <rating_count>54444</rating_count>
</ovs:stats>

ovs:allow_countries ve ovs:disallow_countries öğelerini kullanarak uluslararası video gösterimleri için sınırlamaları kesin olarak belirleyebilirsiniz. Videonun sadece belirli ülkelerde gösterime açık olduğunda ovs:allow_countries öğesinin kullanımı önerilir. Videonun sadece belirli ülkelerde gösterime kapalı olduğunda ovs:disallow_countries öğesinin kullanımı önerilir. Birden fazla sınırlama virgüllerle ayrılarak sıralanabilir veya birkaç adet öğede belirtilebilir.

İşaretleme örneği:

<!-- Video sadece Rusya'da (12+ izleyici kitlesi için) ve Türkiye'de (18+ izleyici kitlesi için) gösterime açıktır. -->
<ovs:allow_countries>ru(12+), tr(18+)</ovs:allow_countries>

<!-- Video, İngiltere hariç tüm ülkelerde gösterime açıktır. Rusya'da 12+ yaşındaki izleyici kitlesi için gösterime açık olan bu video, Türkiye'de 18+ yaşındaki izleyici kitlesi için gösterime açık sayılmaktadır. -->
<ovs:disallow_countries>ru(12+), tr(18+)</ovs:disallow_countries>
<ovs:disallow_countries>uk</ovs:disallow_countries>

Video izleme ücreti price öğesinde belirtilir. Bazı ücretler belirtilebilir; örneğin video servisine abonelik ücreti ve geçerli videonun indirme ücreti.

Desteklenen özellikler şöyle:

• type: ödeme türü

  Geçerli değerler:

  • rent: belirli bir süre boyunca video izleme yetkisi,

  • subscription: birden fazla video için izleme yetkisi veya uzun süreli abonelik,

  • purchase: videonun satın alınması.

• duration: süre (ISO 8601 formatında süre bazlı ücret hesaplaması için).

• currency: ISO 4217 formatında döviz türü.

İşaretleme örneği:

<!-- Video için 36 saatlik kiralama bedeli. -->
<ovs:price type="rent" duration="P1DT12H" currency="rur">100</ovs:price>
<!-- Bir aylık abonelik bedeli. -->
<ovs:price type="subscription" duration="P1M" currency="rur">1000</ovs:price>
<!-- Videonun satın alma bedeli. -->
<ovs:price type="purchase" currency="rur">100</ovs:price>