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://github.com/jonnekaunisto/simple-youtube-api/workflows/Python%20package%20Integration%20Tests/badge.svg :target: https://github.com/jonnekaunisto/simple-youtube-api/actions?query=workflow%3A%22Python+package+Integration+Tests%22 :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

1. Log into https://console.cloud.google.com
2. Create a new Project
3. Search for "YouTube Data API V3" or go to https://console.cloud.google.com/apis/library/youtube.googleapis.com
4. Click Credentials
5. Click Create Credentials

For user data:

1. Select OAuth Client ID
2. Select that you will call API from "Web Server"
3. Download or copy your API key from the Credentials tab

For non-user data:

1. Select API Key
2. 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

1. Fork the repository from Github
2. Clone your fork

.. code:: bash

git clone https://github.com/yourname/simple-youtube-api.git

3. 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/