Search

Результат поиска содержит информацию о видео, канале или плейлисте YouTube, которые соответствуют параметрам поиска, указанным в запросе API. Хотя результат поиска указывает на уникально идентифицируемый ресурс, такой как видео, у него нет собственных постоянных данных.

Методы

API поддерживает следующие методы поиска:

list

Возвращает набор результатов поиска, соответствующих параметрам запроса, указанным в запросе API. По умолчанию набор результатов поиска идентифицирует совпадающие ресурсы video , channel и playlist , но вы также можете настроить запросы для извлечения только определенного типа ресурсов. Попробуйте прямо сейчас .

Представление ресурсов

Следующая структура JSON показывает формат результата поиска:

{
  "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
  }
}

Характеристики

В следующей таблице определены свойства, отображаемые в результатах поиска:

Характеристики
kind	string Идентифицирует тип ресурса API. Значение будет youtube#searchResult .
etag	etag Etag этого ресурса.
id	object Объект id содержит информацию, которую можно использовать для уникальной идентификации ресурса, соответствующего поисковому запросу.
id. kind	string Тип ресурса API.
id. videoId	string Если значением свойства id.type является youtube#video , то это свойство будет присутствовать, а его значение будет содержать идентификатор, который YouTube использует для уникальной идентификации видео, соответствующего поисковому запросу.
id. channelId	string Если значением свойства id.type является youtube#channel , то это свойство будет присутствовать, а его значение будет содержать идентификатор, который YouTube использует для уникальной идентификации канала, соответствующего поисковому запросу.
id. playlistId	string Если значением свойства id.type является youtube#playlist , то это свойство будет присутствовать, а его значение будет содержать идентификатор, который YouTube использует для уникальной идентификации плейлиста, соответствующего поисковому запросу.
snippet	object Объект snippet содержит основные сведения о результатах поиска, такие как его заголовок или описание. Например, если результатом поиска является видео, то заголовок будет названием видео, а описание будет описанием видео.
snippet. publishedAt	datetime Дата и время создания ресурса, который идентифицирует результат поиска. Значение указано в формате ISO 8601 .
snippet. channelId	string Значение, которое YouTube использует для уникальной идентификации канала, опубликовавшего ресурс, указанный в результатах поиска.
snippet. title	string Название результата поиска.
snippet. description	string Описание результата поиска.
snippet. thumbnails	object Карта эскизов изображений, связанных с результатом поиска. Для каждого объекта на карте ключом является имя миниатюры изображения, а значением — объект, содержащий другую информацию о миниатюре.
snippet.thumbnails. (key)	object Допустимые значения ключей: default — миниатюра изображения по умолчанию. Миниатюра по умолчанию для видео — или ресурса, который ссылается на видео, например элемент плейлиста или результат поиска — имеет ширину 120 пикселей и высоту 90 пикселей. Миниатюра по умолчанию для канала имеет ширину 88 пикселей и высоту 88 пикселей. medium — версия миниатюры с более высоким разрешением. Для видео (или ресурса, который ссылается на видео), это изображение имеет ширину 320 пикселей и высоту 180 пикселей. Для канала это изображение имеет ширину 240 пикселей и высоту 240 пикселей. high — версия миниатюры с высоким разрешением. Для видео (или ресурса, который ссылается на видео), это изображение имеет ширину 480 пикселей и высоту 360 пикселей. Для канала это изображение имеет ширину 800 пикселей и высоту 800 пикселей. standard — версия эскиза с еще более высоким разрешением, чем изображение high разрешением. Это изображение доступно для некоторых видео и других ресурсов, которые ссылаются на видео, таких как элементы плейлиста или результаты поиска. Это изображение имеет ширину 640 пикселей и высоту 480 пикселей. maxres — версия миниатюры с самым высоким разрешением. Этот размер изображения доступен для некоторых видео и других ресурсов, которые ссылаются на видео, таких как элементы плейлиста или результаты поиска. Это изображение имеет ширину 1280 пикселей и высоту 720 пикселей.
snippet.thumbnails.(key). url	string URL изображения.
snippet.thumbnails.(key). width	unsigned integer Ширина изображения.
snippet.thumbnails.(key). height	unsigned integer Высота изображения.
snippet. channelTitle	string Название канала, опубликовавшего ресурс, который идентифицирует результат поиска.
snippet. liveBroadcastContent	string Индикация того, содержит ли ресурс video или channel прямую трансляцию. Допустимые значения свойств: upcoming , live и none . Для video значение upcoming указывает на то, что видео является прямой трансляцией, которая еще не началась, а значение live указывает на то, что видео является активной прямой трансляцией. Для ресурса channel значение upcoming указывает, что на канале есть запланированная трансляция, которая еще не началась, а значение live указывает, что на канале есть активная прямая трансляция.