youtube-api
A Node.JS module, which provides an object oriented wrapper for the Youtube v3 API.
:cloud: Installation
npm install --save youtube-api
yarn add youtube-api
:clipboard: Example
const Youtube = require("youtube-api")
, fs = require("fs")
, readJson = require("r-json")
, Lien = require("lien")
, Logger = require("bug-killer")
, opn = require("opn")
, prettyBytes = require("pretty-bytes")
;
const CREDENTIALS = readJson(`${__dirname}/credentials.json`);
let server = new Lien({
host: "localhost"
, port: 5000
});
let oauth = Youtube.authenticate({
type: "oauth"
, client_id: CREDENTIALS.web.client_id
, client_secret: CREDENTIALS.web.client_secret
, redirect_url: CREDENTIALS.web.redirect_uris[0]
});
opn(oauth.generateAuthUrl({
access_type: "offline"
, scope: ["https://www.googleapis.com/auth/youtube.upload"]
}));
server.addPage("/oauth2callback", lien => {
Logger.log("Trying to get the token using the following code: " + lien.query.code);
oauth.getToken(lien.query.code, (err, tokens) => {
if (err) {
lien.lien(err, 400);
return Logger.log(err);
}
Logger.log("Got the tokens.");
oauth.setCredentials(tokens);
lien.end("The video is being uploaded. Check out the logs in the terminal.");
var req = Youtube.videos.insert({
resource: {
snippet: {
title: "Testing YoutTube API NodeJS module"
, description: "Test video upload via YouTube API"
}
, status: {
privacyStatus: "private"
}
}
, part: "snippet,status"
, media: {
body: fs.createReadStream("video.mp4")
}
}, (err, data) => {
console.log("Done.");
process.exit();
});
setInterval(function () {
Logger.log(`${prettyBytes(req.req.connection._bytesDispatched)} bytes uploaded.`);
}, 250);
});
});
:question: Get Help
There are few ways to get help:
- Please post questions on Stack Overflow. You can open issues with questions, as long you add a link to your Stack Overflow question.
- For bug reports and feature requests, open issues. :bug:
- For direct and quick help, you can use Codementor. :rocket:
:memo: Documentation
The official Youtube documentation is a very useful resource.
If you have any questions, please ask them on Stack Overflow and eventually open an issue and link your question there.
Authentication
OAuth (Access Token)
Youtube.authenticate({
type: "oauth"
, token: "your access token"
});
OAuth (Refresh Token)
Youtube.authenticate({
type: "oauth"
, refresh_token: "your refresh token"
, client_id: "your client id"
, client_secret: "your client secret"
, redirect_url: "your refresh url"
});
Server Key
Only for requests that don't require user authorization (certain list operations)
Youtube.authenticate({
type: "key"
, key: "your server key"
});
:yum: How to contribute
Have an idea? Found a bug? See how to contribute.
:sparkling_heart: Support my projects
I open-source almost everything I can, and I try to reply to everyone needing help using these projects. Obviously,
this takes time. You can integrate and use these projects in your applications for free! You can even change the source code and redistribute (even resell it).
However, if you get some profit from this or just want to encourage me to continue creating stuff, there are few ways you can do it:
-
Starring and sharing the projects you like :rocket:
-
—I love books! I will remember you after years if you buy me one. :grin: :book:
-
—You can make one-time donations via PayPal. I'll probably buy a coffee tea. :tea:
-
—Set up a recurring monthly donation and you will get interesting news about what I'm doing (things that I don't share with everyone).
-
Bitcoin—You can send me bitcoins at this address (or scanning the code below): 1P9BRsmazNQcuyTxEqveUsnf5CERdq35V6
Thanks! :heart:
:dizzy: Where is this library used?
If you are using this library in one of your projects, add it in this list. :sparkles:
youtube-playlist-info
node-youtubeapi-simplifier
youtube-channel-videos
YouSlackBot
ydown
youtube-dler
test-youtube-api
steam-chat-bot
youtube-vanitystats
node-red-node-youtube
kyot-sunday-playlists
anitube
mediacenterjs-youtube
node-red-contrib-youtube
pullplaylist
youtube-album-uploader
mediacenterjs
adasq-services-ytv
youtube-comment-sampler
botyo-command-youtube
muzier-cli
osjs-youtube-adapter
@zlucy/lucy-search
youtube-album-uploader-multiple
chewb-youtube-uploader
hpcbot
nodejs-youtube-uploader
spotivy
@dottjt/mediareade
:scroll: License
MIT © Ionică Bizău