Search

search sonucu, bir API isteğinde belirtilen arama parametreleriyle eşleşen bir YouTube videosu, kanalı veya oynatma listesi hakkında bilgi içerir. Arama sonucu, video gibi kimliği net bir şekilde tespit edilebilir bir kaynağa işaret etse de kendi kalıcı verileri yoktur.

Yöntemler

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

list
API isteğinde belirtilen sorgu parametreleriyle eşleşen bir arama sonuçları koleksiyonu döndürür. Varsayılan olarak, bir arama sonucu kümesi eşleşen video, channel ve playlist kaynaklarını tanımlar ancak sorguları yalnızca belirli bir kaynak türünü alacak şekilde de yapılandırabilirsiniz. Hemen deneyin.

Kaynak temsili

Aşağıdaki JSON yapısı, bir arama sonucunun biçimini gösterir:

{
  "kind": "youtube#searchResult",
  "etag": etag,
  "id": {
    "kind": string,
    "videoId": string,
    "channelId": string,
    "playlistId": string
  },
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "liveBroadcastContent": string
  }
}

Özellikler

Aşağıdaki tabloda, arama sonucunda görünen özellikler tanımlanmaktadır:

Özellikler
kind string
API kaynağının türünü tanımlar. Değer youtube#searchResult olur.
etag etag
Bu kaynağın ETag'i.
id object
id nesnesi, arama isteğiyle eşleşen kaynağı benzersiz şekilde tanımlamak için kullanılabilecek bilgileri içerir.
id.kind string
API kaynağının türü.
id.videoId string
id.type özelliğinin değeri youtube#video ise bu özellik mevcut olur ve değeri, YouTube'un arama sorgusuyla eşleşen bir videoyu benzersiz şekilde tanımlamak için kullandığı kimliği içerir.
id.channelId string
id.type özelliğinin değeri youtube#channel ise bu özellik mevcut olur ve değeri, arama sorgusuyla eşleşen bir kanalı benzersiz şekilde tanımlamak için YouTube'un kullandığı kimliği içerir.
id.playlistId string
id.type özelliğinin değeri youtube#playlist ise bu özellik mevcut olur ve değeri, YouTube'un arama sorgusuyla eşleşen bir oynatma listesini benzersiz şekilde tanımlamak için kullandığı kimliği içerir.
snippet object
snippet nesnesi, bir arama sonucuyla ilgili temel ayrıntıları (ör. başlığı veya açıklaması) içerir. Örneğin, arama sonucu bir video ise başlık, videonun başlığı, açıklama ise videonun açıklaması olur.
snippet.publishedAt datetime
Arama sonucunun tanımladığı kaynağın oluşturulma tarihi ve saati. Değer, ISO 8601 biçiminde belirtilir.
snippet.channelId string
Arama sonucunun tanımladığı kaynağı yayınlayan kanalı benzersiz şekilde tanımlamak için YouTube'un kullandığı değer.
snippet.title string
Arama sonucunun başlığı.
snippet.description string
Arama sonucunun açıklaması.
snippet.thumbnails object
Arama sonucuyla ilişkili küçük resimlerin haritası. Haritadaki her nesne için anahtar, küçük resmin adı, değer ise küçük resimle ilgili diğer bilgileri içeren bir nesnedir.
snippet.thumbnails.(key) object
Geçerli anahtar değerleri:
  • default: Varsayılan küçük resim. Bir video veya videoya referans veren bir kaynak (ör. oynatma listesi öğesi ya da arama sonucu) için varsayılan küçük resim 120 piksel genişliğinde ve 90 piksel yüksekliğindedir. Bir kanalın varsayılan küçük resmi 88 piksel genişliğinde ve 88 piksel yüksekliğindedir.
  • medium: Küçük resmin daha yüksek çözünürlüklü versiyonu. Video (veya videoya atıfta bulunan bir kaynak) için bu resim 320 piksel genişliğinde ve 180 piksel yüksekliğindedir. Kanallar için bu resim 240 piksel genişliğinde ve 240 piksel yüksekliğindedir.
  • high: Küçük resmin yüksek çözünürlüklü sürümü. Video (veya videoya atıfta bulunan bir kaynak) için bu resim 480 piksel genişliğinde ve 360 piksel yüksekliğindedir. Kanallar için bu resim 800 piksel genişliğinde ve 800 piksel yüksekliğindedir.
  • standard: Küçük resmin, high çözünürlüklü resimden daha da yüksek çözünürlüklü bir sürümü. Bu resim, bazı videolar ve videolara referans veren diğer kaynaklar (ör. oynatma listesi öğeleri veya arama sonuçları) için kullanılabilir. Bu resim 640 piksel genişliğinde ve 480 piksel yüksekliğindedir.
  • maxres: Küçük resmin en yüksek çözünürlüklü sürümü. Bu resim boyutu, bazı videolar ve videolara atıfta bulunan diğer kaynaklar (ör. oynatma listesi öğeleri veya arama sonuçları) için kullanılabilir. Bu resim 1.280 piksel genişliğinde ve 720 piksel yüksekliğindedir.

Not: 1080p+ küçük resimleri (fhd, qhd ve uhd) arama sonuçlarında desteklenmez. Daha yüksek çözünürlüklü küçük resimleri almak için kaynağın kimliğini kullanarak kaynağa özgü uç noktayı (ör. videos.list) çağırın.
snippet.thumbnails.(key).url string
Resmin URL'si.
snippet.thumbnails.(key).width unsigned integer
Resmin genişliği.
snippet.thumbnails.(key).height unsigned integer
Resmin yüksekliği.
snippet.channelTitle string
Arama sonucunun tanımladığı kaynağı yayınlayan kanalın başlığı.
snippet.liveBroadcastContent string
video veya channel kaynağında canlı yayın içeriği olup olmadığını gösterir. Geçerli özellik değerleri upcoming, live ve none'dir.

video kaynağı için upcoming değeri, videonun henüz başlamamış bir canlı yayın olduğunu, live değeri ise videonun etkin bir canlı yayın olduğunu gösterir. channel kaynağı için upcoming değeri, kanalın henüz başlamamış planlanmış bir yayını olduğunu, live değeri ise kanalın etkin bir canlı yayını olduğunu gösterir.