billyriantono/youtube

YouTube API Wrapper with Laravel 5.

Laravel 5 - YouTube API Wrapper

Based on Dawson/Youtube, _(*1)

If you've ever needed to upload videos to a single YouTube channel or you need request data from your Laravel 5 application, then hopefully this is the package for you., _(*2)

Installation

Add the following to your composer.json., _(*3)

"billyriantono/youtube": "dev-master"

After you've added the above, run composer update to pull it in. Once your update has finished, we'll need to add the service provider to your config/app.php, _(*4)

'providers' => [
    'billyriantono\Youtube\YoutubeServiceProvider',
],

Then add the alias..., _(*5)

'aliases' => [
    'Youtube' => 'billyriantono\Youtube\YoutubeFacade',
],

Configuration

Run php artisan vendor:publish to publish the migrations and config. Then migrate the database with, php artisan migrate., _(*6)

This will create our youtube_access_tokens and channels table which will of course, hold our access tokens once we've authenticated with Google., _(*7)

Next it's time to configure our settings in config/youtube.php makes use of environment variables to ensure no secret crentials make way into version control. So add the following variables to your .env file., _(*8)

GOOGLE_CLIENT_ID=YOUR_CLIENT_ID
GOOGLE_CLIENT_SECRET=YOUR_SECRET
YOUTUBE_APPLICATION_NAME="Your Application Name"
YOUTUBE_REDIRECT_URI="Your Callback Uri" for example : youtube-callback
YOUTUBE_AUTHENTICATION_URI="Your Authentication Uri"
YOUTUBE_AFTER_REDIRECT_URI="Your Custom Controller after getting access token"
GOOGLE_APPROVAL_PROMPT="auto|force"

You can find these values on Google's developer console for your application., _(*9)

Now set up your applications callback, you can find this on your config/youtube.php. By default it's set to http://yourapp.co.uk/youtube-callback, _(*10)

'redirect_uri' => 'youtube-callback'

If you're unsure of how to use enviroment variables, Jeffrey Way helps clear the fog over at Laracasts with his Environments and Configuration lesson with Laravel 5., _(*11)

Authentication

Now our application is configured, we'll go through the inital authentication with Google. By default, the authorization route is /youtube-auth but you can change this in config/youtube.php should you wish to., _(*12)

Proceed with hitting the auth route in your application of which you will be sent to Google to authorize your YouTube account/channel. Once authorized, you will be redirected back to your application assuming you correctly configured your callback., _(*13)

Upload a Video

Once you have complete the above, your Laravel application will now be authorized to make requests to YouTube. Specifically in this case, uploading a video by passing the full path to the file you wish to upload.., _(*14)

To upload a video, do the following:, _(*15)

$id = Youtube::upload($pathToMovieFile);

return $id;

The above will return the ID of the uploaded video to YouTube., _(*16)

You also have the option to pass a second parameter as an array with the following available keys., _(*17)

• title string
• description string
• category_id integer
• tags array

$params = [
    'title' => 'Laravel Screencast',
    'description' => 'My First Laravel Tutorial!',
    'category_id' => 10,
    'tags' => [
        'laravel',
        'eloquent',
        'awesome' // Of course!
    ]
];

$id = Youtube::upload($pathToMovieFile, $params);

return $id;

It's that simple!, _(*18)

Deleting a Video

If you would like to delete a video, which of course is uploaded to your authorized channel, you will also have the ability to delete it:, _(*19)

Youtube::delete($id);

When deleting a video, it will check if exists before attempting to delete., _(*20)

Questions

Should you have any questions, please feel free to submit an issue., _(*21)