Bu sayfa, Cloud Translation API ile çevrilmiştir.

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 sonuçları, video gibi benzersiz şekilde tanımlanabilen bir kaynağı işaret etse de kendi kalıcı verilerine sahip değildir.

Yöntemler

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

list: API isteğinde belirtilen sorgu parametreleriyle eşleşen bir arama sonucu 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ında bir arama sonucunun biçimi gösterilmektedir:

{
  "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, bir 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 değeri.
`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` mülkünün değeri `youtube#video` ise bu mülk 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` mülkünün değeri `youtube#channel` ise bu mülk mevcut olur ve değeri, YouTube'un arama sorgusuyla eşleşen bir kanalı benzersiz şekilde tanımlamak için kullandığı kimliği içerir.
`id.playlistId`	`string` `id.type` mülkünün değeri `youtube#playlist` ise bu mülk 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 videoysa 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` YouTube'un, arama sonucunun tanımladığı kaynağı yayınlayan kanalı benzersiz şekilde tanımlamak için 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ıdır ve değer, 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 videonun veya videoya atıfta bulunan bir kaynağın (ör. oynatma listesi öğesi veya arama sonucu) varsayılan küçük resmi 120 piksel genişliğinde ve 90 piksel yüksekliğindedir. Kanalları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ü bir sürümü. Videolar (veya videoya atıfta bulunan kaynaklar) 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ü. Videolar (veya videoya atıfta bulunan kaynaklar) 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üğündeki resimden daha yüksek çözünürlüklü bir sürümü. Bu resim, bazı videolarda ve videolara atıfta bulunan diğer kaynaklarda (ör. oynatma listesi öğeleri veya arama sonuçları) 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.
`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 adı.
`snippet.liveBroadcastContent`	`string` `video` veya `channel` kaynağının canlı yayın içeriği içerip içermediğini belirtir. 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şlatılmamış planlanmış bir yayını olduğunu, `live` değeri ise kanalın etkin bir canlı yayını olduğunu gösterir.