В этой статье я расскажу, как искать видео на YouTube с помощью API данных YouTube v3 и PHP. Я покажу, как искать видео по типу (видео, канал, список воспроизведения), ключевым словам и другим условиям поиска. В дополнение к этому я покажу, как упорядочить результат по различным параметрам.
Прочитав эту статью, вы можете создавать поисковые запросы, например получать список видео с определенного канала. Также вы можете фильтровать видео по ключевым словам и другим параметрам.
Для начала вам понадобится ключ API YouTube для запросов API данных YouTube. Если у вас нет ключа API, следуйте нашим предыдущим статьям Извлечение видео из списка воспроизведения YouTube с помощью YouTube API и Получение информации о видео YouTube с помощью API YouTube через PHP .
URL запроса API
URL-адрес запроса для API поиска выглядит следующим образом:
GET https://www.googleapis.com/youtube/v3/search
Вам необходимо передать параметры в виде строки запроса вместе с ключом API. Есть несколько параметров, которые поддерживает API поиска. Среди них ключ и часть являются обязательными параметрами.
«Ключ» – это ключ API, необходимый для доступа к API данных YouTube.
«Часть» указывает разделенный запятыми список одного или нескольких свойств ресурса поиска, который будет включен в ответ API.
Некоторые из известных параметров следующие:
- Q
- тип
- channelId
- publishedAfter
- publishedBefore
- maxResults
- приказ
До сих пор мы обсуждали URL запроса API и его параметры. Теперь пришло время действовать.
Поиск видео на YouTube по ключевым словам
Для поиска по ключевым словам необходимо указать термин запроса в параметре q. В дополнение к этому вы можете также ограничить поисковый запрос, чтобы получать только определенный тип ресурса, используя параметр типа.
Существует 3 типа ресурсов: канал, список воспроизведения и видео. Вы также можете указать несколько типов ресурсов в виде значения через запятую.
Следующий запрос показывает поисковый запрос по ключевому слову «плавание»:
Вы можете легко получить ответ на вышеуказанный запрос, используя file_get_contents, используя PHP, чтобы использовать результаты поиска в вашем приложении.
Получение списка видео с канала с использованием API
Точно так же вы можете получить список видео с канала YouTube, используя API. Для этого вам нужно указать параметр channelId вашего канала YouTube.
Вот пример запроса:
Ограничение и упорядочивание результатов поиска
До сих пор я обсуждал, как составить поисковый запрос для поиска видео на YouTube. Тем не менее, этого недостаточно для применения в реальной жизни. Вам нужно будет ограничить, а также упорядочить результаты поиска.
Чтобы достичь этого, мы можем добавить параметры ‘maxResults’ и ‘order’ в поисковый запрос.
Параметр maxResults указывает максимальное количество элементов, которые должны быть возвращены в наборе результатов. Может принести максимум 50 предметов. Значение по умолчанию 5.
Параметр order указывает метод, который будет использоваться для упорядочения ресурсов в ответе API. Допустимые значения: дата, рейтинг, релевантность, заголовок, videoCount и viewCount. По умолчанию актуальность считается.
Вывод
Таким образом, мы можем выполнять поиск видео на YouTube и ограничивать результаты поиска определенными критериями.
Обратитесь к документации API поиска YouTube, чтобы настроить запрос поиска.
Источник записи: https://thedebuggers.com