Youtube API v3: получаем API key и работаем

Приветствую, друзья!

Это уже становится не смешно: сто́ит мне разместить информацию по API для какого-либо сервиса, как в скором времени сервис умирает. Очень надеюсь, что в этот раз статья будет актуальной более длительное время. Итак, сегодняшняя тема — Youtube API версии 3.

Для работы нам потребуется всего лишь PHP версии 5.2.0 или выше. Если учесть, что версия 5.3 появилась уже в середине 2009 года, нужно «иметь» ооочень древнего хостера, чтобы не заработало. По плану у нас следующее:

1. — получаем API key;
2. — исследуем описание (увы, на английском);
3. — получаем содержимое плейлиста и выводим его на странице.

Старый код, к сожалению, не актуален. Запрос фида выдаёт ошибку — «No longer available». Возможно, Google пойдёт навстречу массовым жалобам пользователей, но рассчитывать на это не нужно. Посему, обновим наш код так, чтобы всё работало, как и раньше.

Список доступных методов можно посмотреть на этой странице. Там же ссылка на официальную докуменатцию.

Недолгие копания приведут к следующему адресу, на который должен осуществляться запрос:

{PLAY_LIST_ID} имеет то же значение, что и в прошлой статье. Но для продолжения работы жизненно необходим {YOUR_API_KEY}.

Получаем API key

1. Идём сюда.

2. Жмём кнопку Create Project. В появившемся окошке вводим имя. Я использую my-test-youtube-api. Ставим галочку согласия I agree… и нажимаем кнопку Create. Подождём, пока проект создастся.

3. Для открытия, в пункте «Boost your app with a Google API» активируем кнопку Enable an API.

4. Нам необходимо работаmь с данными YouTube, поэтому выбираем «YouTube Data API».

5. Нажимаем на кнопку «Enable API». Теперь всё готово, можно осуществлять запросы. Выделенная квота находится во вкладке Quotas. Но ещё нужен ключ.

6. Для получения ключа выбираем в меню слева API & auth → Credentials. Правее нажимаем кнопку «Create new Key».

7. Жмём «Browser key». По необходимости указываем домены, с которых разрешаются запросы. Я ничего не вбивал (разрешены запросы с любых доменов) и сразу нажал «Create». Значимая информация это API key — он понадобится для работы.

Youtube API v3

Нам нужен метод PlaylistItems: list.

Описания доступных параметров приведены на странице, хотя и на английском. Мы же будет использовать четыре:

1. part — через запятую перечисляются значения свойств, которые должны быть возвращены. Чтобы всё было без гемороя, используем спецслово snippet;
2. playlistId — идентификатор плейлиста;
3. maxResults — сколько результатов (данных по видеороликам) возвращать;
4. key — API key, ключ, полученный на шаге 7.

Данные возвращаются в виде JSON-объекта, осталось разрулить их и сформировать «старый» массив.

Решение

<?php
/**
* Получить список последних видео заданного плейлиста
*
* @param string $ytlist идентификатор плейлиста
* @param int $cnt по сколько позиций обрабатывать (не всегда нужно содержимое всего плейлиста)
* @param int $cache_life время жизни кеша в секундах (чтобы не получить бан IP за рилтайм запросы)
* @return array список найденных видео, не более $cnt штук
*/
function getYoutubePlaylistDataXml($ytlist, $cnt = 5, $cache_life = 3600) {
    # файл, содержащий копию ленты
    $cache_file = dirname(__FILE__) . DIRECTORY_SEPARATOR . $ytlist . '.json';
    
    # Ключ для запросов
    $api_key = 'ВАШ-API-KEY';
    
    # специальный адрес, отвечающий за выдачу фида
    $url = 'https://www.googleapis.com/youtube/v3/playlistItems?part=snippet'
         . '&playlistId=' . $ytlist
         . '&maxResults=' . $cnt
         . '&key=' . $api_key;
    
    # если кеш устарел...
    if (time() - @filemtime($cache_file) >= $cache_life) {
        # ...пытаемся обновить его
        $buf = file_get_contents($url);
        # в случае успеха запишем в файл обновлённые данные
        # проверка на пустоту нужна для того, чтобы не запороть кеш при ошибке
        if ($buf) file_put_contents($cache_file, $buf);
    }
    
    # если фид получить не удалось...
    if (empty($buf)) {
        # ...просто берём содержимое из кеша
        $buf = file_get_contents($cache_file);
    }
    
    # декодируем JSON данные
    $json = json_decode($buf, 1);
    
    $arr = array();
    
    # если данных нет — на выход
    if (empty($json['items'])) return $arr;
    
    # перебор доступных значений
    foreach ($json['items'] as $v) {
        $t = array(
            'title' => $v['snippet']['title'], # название
            'desc'  => $v['snippet']['description'], # описание
            'url'   => $v['snippet']['resourceId']['videoId'], # адрес
        );
        
        # изображения
        if (isset($v['snippet']['thumbnails'])) {
            $t['imgs']['all'] = array();
            foreach ($v['snippet']['thumbnails'] as $name => $item) {
                $t['imgs']['all'][] = $item['url'];
                $wh = $item['width'] . 'x' . $item['height'];
                $t['imgs'][$wh][0] = $item['url'];
            }
        }
        
        $arr[] = $t;
    }
    
    return $arr;
}

В представленном коде забейте ВАШ-API-KEY, полученный на седьмом шаге (без этого код не будет работать!).

Обратите внимание, что в коде происходит запрос файла по HTTPS протоколу. Если вы испытываете скрипт на локальной машине, под Windows, и код не работает (скрипт ругается на https), необходимо в файле php.ini раскомментировать (удалить точку с запятой ; в начала строки) инструкцию extension=php_openssl.dll и перезагрузить веб-сервер.

Вот, собственно, и всё. Работать с функцией можно так же, как и в прошлой статье. Функция либо добавляется в ваш файл, либо в новосозданный документ, например, youtube_api.php, после чего подключается стандартным способом:

require_once 'youtube_api.php';

Возвращаемый массив данных сделан совместимым со старым решением, таким образом, достаточно лишь заменить тело функции.

Пользуйтесь на здоровье!

Полезные ссылки

• Скачать Google APIs Client Library for PHP — клиентские библиотеки
• Скачать API Client Library for PHP — библиотека для работы с API

Примеры кода

Получение последних видео из указанный плейлистов и сохранение информации в файл

<?php
/*
Получение последних видео для указанных каналов
*/
header('Content-Type:text/plain;charset=utf-8');

function getYoutubeDataXml($id) {
    // Ключ для запросов
    $api_key = 'ВАШ-API-KEY';
    
    // специальный адрес, отвечающий за выдачу фида
    $url = 'https://www.googleapis.com/youtube/v3/search?part=snippet'
         . '&channelId=' . $id
         . '&order=date'    // упорядочивать по дате добавления
         . '&maxResults=5'  // за раз получать не более 5 результатов
         . '&fields=items/id/videoId'  // нам нужны только идентификаторы видео
         . '&key=' . $api_key;
    $buf = file_get_contents($url);
    
    // декодируем JSON данные
    $json = json_decode($buf, 1);
    
    return $json;
}

// список каналов
$channel_list = array(
    'UCmOpCyZ1j406Qyun7dJgOFg',
    'UCvBGdmck9fnkFa1jWucN87Q',
);

// хэш в виде: array('id_канала-1' => [vid1, vid2, ...], 'id_канала-2' => [vid1, vid2, ...])
$lastvideo = array();

// пробежаться по каналам, получить для них идентификаторы последних видео
foreach ($channel_list as $channel_id) {
    $tarr = getYoutubeDataXml($channel_id);
    $lastvideo[$channel_id] = array();
    
    if ( !empty($tarr['items']) ) {
        foreach ($tarr['items'] as $v) {
            $lastvideo[$channel_id][] = $v['id']['videoId'];
        }
    }
}

// сохранить в текстовой файл, каждая строка: id-канала|id-видео через пробел
$s = '';
foreach ($lastvideo as $channel_id => $video_list) {
    $s .= $channel_id . '|' . implode(' ', $video_list) . "\r\n";
}
// файл создаётся в директории с ЭТИМ скриптом
file_put_contents( __DIR__ . DIRECTORY_SEPARATOR . 'lastvideo.txt', $s );

// вывод результата в браузер, для визуального контроля
print_r($lastvideo);

Поддержка сайта

С удовольствием создаю годный контент. Буду очень признателен, если вы поддержите мои усилия:

днём интернета
шоколадкой для работы мозга
коробочкой ароматного чая для бодрости
продлением хостинга на +1 месяц

Автор публикации

2 070

не в сети 12 месяцев

x64 (aka andi)

Комментарии: 2893Публикации: 405Регистрация: 02-04-2009

(4 голосов, в среднем: 5,00 из 5)

Загрузка...