Search

Результаты 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 пикселей. Примечание: Миниатюрные изображения с разрешением 1080p и выше ( fhd , qhd и uhd ) не поддерживаются для результатов поиска. Для получения миниатюр с более высоким разрешением вызовите конечную точку, специфичную для ресурса (например, videos.list ), используя идентификатор ресурса.
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 указывает на то, что у канала есть активная прямая трансляция.