Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
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: 3 months ago
JSON representation
Object-oriented Wrapper for Youtube API in Python
- Host: GitHub
- URL: https://github.com/jonnekaunisto/simple-youtube-api
- Owner: jonnekaunisto
- License: other
- Created: 2019-02-08T07:54:37.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-06-28T13:54:39.000Z (5 months ago)
- Last Synced: 2024-07-21T00:32:19.841Z (4 months ago)
- Topics: api, hacktoberfest, python, wrapper, youtube, youtube-api
- Language: Python
- Homepage: https://simple-youtube-api.rtfd.io
- Size: 19.2 MB
- Stars: 73
- Watchers: 1
- Forks: 16
- Open Issues: 27
-
Metadata Files:
- Readme: README.rst
- Contributing: CONTRIBUTING.md
- License: LICENSE.rst
- Code of conduct: CODE_OF_CONDUCT.md
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/