Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jonnekaunisto/simple-youtube-api

Object-oriented Wrapper for Youtube API in Python
https://github.com/jonnekaunisto/simple-youtube-api

api hacktoberfest python wrapper youtube youtube-api

Last synced: about 2 months ago
JSON representation

Object-oriented Wrapper for Youtube API in Python

Awesome Lists containing this project

README 

        
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/