https://github.com/cable8mm/youtube
Renewal Laravel PHP Facade/Wrapper for the Youtube Data API
https://github.com/cable8mm/youtube
api laravel package php8 youtube youtube-api
Last synced: about 1 month ago
JSON representation
Renewal Laravel PHP Facade/Wrapper for the Youtube Data API
- Host: GitHub
- URL: https://github.com/cable8mm/youtube
- Owner: cable8mm
- License: mit
- Created: 2024-02-05T03:10:09.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-03-09T14:50:52.000Z (over 2 years ago)
- Last Synced: 2025-01-15T19:22:27.999Z (over 1 year ago)
- Topics: api, laravel, package, php8, youtube, youtube-api
- Language: PHP
- Homepage: http://www.palgle.com/Youtube/
- Size: 259 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Youtube
[](https://github.com/cable8mm/Youtube/actions/workflows/code-style.yml)
[](https://github.com/cable8mm/Youtube/actions/workflows/run-tests.yml)
Renew Laravel PHP Facade/Wrapper for the Youtube Data API v3 ( Non-OAuth )
We have provided the API Documentation on the web. For more information, please visit ❤️
## Requirements
- PHP 8.2 or higher
- Laravel 8 or higher
- API key from [Google Console](https://console.developers.google.com)
## Installation
Run in console below command to download package to your project:
```bash
composer require cable8mm/youtube
```
## Configuration
Publish config settings:
```bach
php artisan vendor:publish --provider="Cable8mm\Youtube\YoutubeServiceProvider"
```
Set your Youtube API key in the file:
```shell
/config/youtube.php
```
Or in the .env file
```shell
YOUTUBE_API_KEY =
```
## Package Development
If you are going to contribute,
```sh
composer update
```
And you can use `.env` in the package.
## Usage
```php
// use Cable8mm\Youtube\Facades\Youtube;
// Return an STD PHP object
$video = Youtube::getVideoInfo('rie-hPVJ7Sw');
// Get multiple videos info from an array
$videoList = Youtube::getVideoInfo(['rie-hPVJ7Sw','iKHTawgyKWQ']);
// Get localized video info
$video = Youtube::getLocalizedVideoInfo('vjF9GgrY9c0', 'pl');
// Get comment threads by videoId
$commentThreads = Youtube::getCommentThreadsByVideoId('zwiUB_Lh3iA');
// Get popular videos in a country, return an array of PHP objects
$videoList = Youtube::getPopularVideos('us');
// Search playlists, channels and videos. return an array of PHP objects
$results = Youtube::search('Android');
// Only search videos, return an array of PHP objects
$videoList = Youtube::searchVideos('Android');
// Search only videos in a given channel, return an array of PHP objects
$videoList = Youtube::searchChannelVideos('keyword', 'UCk1SpWNzOs4MYmr0uICEntg', 40);
// List videos in a given channel, return an array of PHP objects
$videoList = Youtube::listChannelVideos('UCk1SpWNzOs4MYmr0uICEntg', 40);
$results = Youtube::searchAdvanced([ /* params */ ]);
// Get channel data by channel name, return an STD PHP object
$channel = Youtube::getChannelByName('xdadevelopers');
// Get channel data by channel ID, return an STD PHP object
$channel = Youtube::getChannelById('UCk1SpWNzOs4MYmr0uICEntg');
// Get playlist by ID, return an STD PHP object
$playlist = Youtube::getPlaylistById('PL590L5WQmH8fJ54F369BLDSqIwcs-TCfs');
// Get playlists by multiple ID's, return an array of STD PHP objects
$playlists = Youtube::getPlaylistById(['PL590L5WQmH8fJ54F369BLDSqIwcs-TCfs', 'PL590L5WQmH8cUsRyHkk1cPGxW0j5kmhm0']);
// Get playlist by channel ID, return an array of PHP objects
$playlists = Youtube::getPlaylistsByChannelId('UCk1SpWNzOs4MYmr0uICEntg');
// Get items in a playlist by playlist ID, return an array of PHP objects
$playlistItems = Youtube::getPlaylistItemsByPlaylistId('PL590L5WQmH8fJ54F369BLDSqIwcs-TCfs');
// Get channel activities by channel ID, return an array of PHP objects
$activities = Youtube::getActivitiesByChannelId('UCk1SpWNzOs4MYmr0uICEntg');
// Retrieve video ID from original YouTube URL
$videoId = Youtube::parseVidFromURL('https://www.youtube.com/watch?v=moSFlvxnbgk');
// result: moSFlvxnbgk
```
## Validation Rules
```php
// use Cable8mm\Youtube\Rules\ValidYoutubeVideo;
// Validate a YouTube Video URL
[
'youtube_video_url' => ['bail', 'required', new ValidYoutubeVideo]
];
```
You can use the bail rule in conjunction with this in order to prevent unnecessary queries.
## Basic Search Pagination
```php
// Set default parameters
$params = [
'q' => 'Android',
'type' => 'video',
'part' => 'id, snippet',
'maxResults' => 50
];
// Make intial call. with second argument to reveal page info such as page tokens
$search = Youtube::searchAdvanced($params, true);
// Check if we have a pageToken
if (isset($search['info']['nextPageToken'])) {
$params['pageToken'] = $search['info']['nextPageToken'];
}
// Make another call and repeat
$search = Youtube::searchAdvanced($params, true);
// Add results key with info parameter set
print_r($search['results']);
/* Alternative approach with new built-in paginateResults function */
// Same params as before
$params = [
'q' => 'Android',
'type' => 'video',
'part' => 'id, snippet',
'maxResults' => 50
];
// An array to store page tokens so we can go back and forth
$pageTokens = [];
// Make inital search
$search = Youtube::paginateResults($params, null);
// Store token
$pageTokens[] = $search['info']['nextPageToken'];
// Go to next page in result
$search = Youtube::paginateResults($params, $pageTokens[0]);
// Store token
$pageTokens[] = $search['info']['nextPageToken'];
// Go to next page in result
$search = Youtube::paginateResults($params, $pageTokens[1]);
// Store token
$pageTokens[] = $search['info']['nextPageToken'];
// Go back a page
$search = Youtube::paginateResults($params, $pageTokens[0]);
// Add results key with info parameter set
print_r($search['results']);
```
The pagination above is quite basic. Depending on what you are trying to achieve you may want to create a recursive function that traverses the results.
## Manual Class Instantiation
```php
// Directly call the YouTube constructor
$youtube = new Youtube(config('YOUTUBE_API_KEY'));
// By default, if the $_SERVER['HTTP_HOST'] header is set,
// it will be used as the `Referer` header. To override
// this setting, set 'use-http-host' to false during
// object construction:
$youtube = new Youtube(config('YOUTUBE_API_KEY'), ['use-http-host' => false]);
// This setting can also be set after the object was created
$youtube->useHttpHost(false);
```
## Test
```sh
composer test
```
## Format of returned data
The returned JSON is decoded as PHP objects (not Array).
Please read the ["Reference" section](https://developers.google.com/youtube/v3/docs/) of the Official API doc.
## Youtube Data API v3
- [Youtube Data API v3 Doc](https://developers.google.com/youtube/v3/)
- [Obtain API key from Google API Console](https://console.developers.google.com)
## Credits
Built on code from Alaouy's [alaouy/youtube](https://github.com/alaouy/youtube).