Simple Youtube API
.. image:: https://badge.fury.io/py/simple-youtube-api.svg
:target: https://badge.fury.io/py/simple-youtube-api
:alt: Simple YouTube API page on the Python Package Index
.. image:: https://travis-ci.org/jonnekaunisto/simple-youtube-api.svg?branch=master
:target: https://travis-ci.org/jonnekaunisto/simple-youtube-api
:alt: Build status on travis
.. image:: https://coveralls.io/repos/github/jonnekaunisto/simple-youtube-api/badge.svg?branch=master
:target: https://coveralls.io/github/jonnekaunisto/simple-youtube-api?branch=master
:alt: Coverage on coveralls
Simple Youtube API(full documentation_) is a Youtube API wrapper for python, making it easier to search and upload your videos.
Examples
In this example we log in into a YouTube channel, set the appropriate variables for a video and upload the video to the YouTube channel that we logged into:
.. code:: python
from simple_youtube_api.Channel import Channel
from simple_youtube_api.LocalVideo import LocalVideo
# loggin into the channel
channel = Channel()
channel.login("client_secret.json", "credentials.storage")
# setting up the video that is going to be uploaded
video = LocalVideo(file_path="test_vid.mp4")
# setting snippet
video.set_title("My Title")
video.set_description("This is a description")
video.set_tags(["this", "tag"])
video.set_category("gaming")
video.set_default_language("en-US")
# setting status
video.set_embeddable(True)
video.set_license("creativeCommon")
video.set_privacy_status("private")
video.set_public_stats_viewable(True)
# setting thumbnail
video.set_thumbnail_path('test_thumb.png')
# uploading video and printing the results
video = channel.upload_video(video)
print(video.id)
print(video)
# liking video
video.like()
Installation
Simple YouTube API needs API keys from Google in order to be able to make queries to YouTube.
Installation by hand: you can download the source files from PyPi or Github:
.. code:: bash
python setup.py install
Installation with pip: make sure that you have pip
installed, type this in a terminal:
.. code:: bash
pip install simple-youtube-api
Generating YouTube API Keys
For user data:
5. Select OAuth Client ID
6. Select that you will call API from "Web Server"
7. Download or copy your API key from the Credentials tab
For non-user data
5. Select API Key
6. Paste the key into a file
Running Tests
Run the python command
.. code:: bash
python setup.py test
References
YouTube API Documentation
_
Python YouTube API Examples
_
Contribute
- Fork the repository from Github
- Clone your fork
.. code:: bash
git clone https://github.com/yourname/simple-youtube-api.git
- Add the main repository as a remote
.. code:: bash
git remote add upstream https://github.com/jonnekaunisto/simple-youtube-api.git
4. Create a pull request and follow the guidelines
Maintainers
jonnekaunisto (owner)
.. _YouTube API Documentation
: https://developers.google.com/youtube/v3/docs/
.. _Python YouTube API Examples
: https://github.com/youtube/api-samples/tree/master/python
.. _documentation: https://simple-youtube-api.readthedocs.io/