A very basic wrapper for the Vimeo API. OAuth2 is not included in the code. You can easily write your own OAuth2 workflow with a gem like OAuth2. All you need is a Vimeo access token in order to easily make calls to their API using this gem.
A simple alternative method is to generate your own token, dedicated to your application, which can be clearly convenient in case of script use.
The procedure is to go in your app created on vimeo https://developer.vimeo.com/ and find the Authentication tab (it's next to the Details tab),
at the end, you'll find Generate an Access Token, customize as you wish, then click send. Your token is created and you are ready to use it.
Add this line to your application's Gemfile:
gem 'vimeo_me2', :git => "https://github.com/bo-oz/vimeo_me2.git"And then execute:
$ bundle
This gem consists of two classes that can access a user or a video object from Vimeo. Using the gem's methods requires having a Vimeo access token: vimeo.com. When calling the classes, put in the access token and call the various methods.
Use utility methods to make any call to Vimeo. You can see the full list of endpoints in the Vimeo documentation on vimeo.com.
# Set up a client for making calls to Vimeo:
vimeo = VimeoMe2::VimeoObject.new('12345hjhsjdshasd')
# '12345hjhsjdshasd' must be replaced with a valid token.
# Make any GET request, by providing only the API endpoint:
vimeo.get('/me')
# Make any POST request, including a body.
# Don't forget to set the expected response code.
# You can also set additional headers.
body = "whatever"
vimeo.post('/videos/12344', body:body, headers:{'Content-Type': 'video/mp4'}, code:201)
# Delete items:
vimeo.delete('/videos/12344', code:204)Take a look at the files under /lib/vimeo_me2/user/ for available methods.
# Access your own user object:
vimeo_user = VimeoMe2::User.new('12345hjhsjdshasd')
# Access a different user's object:
vimeo_user = VimeoMe2::User.new('12345hjhsjdshasd','username')Get a list of likes. Like or unlike videos.
# Fetch all likes for a user:
vimeo_user.view_all_likes
# Like a specific video:
vimeo_user.like_video 1234455
# Check if a video is liked:
vimeo_user.check_if_liked 1234455
# Returns true if liked, false if not liked.
# Unlike a video:
vimeo_user.unlike_video 1234455At this moment there are two ways of uploading videos to Vimeo. The first one works in Rails and uploads an ActionDispatch::Http::UploadedFile object to Vimeo, like so:
# RoR Example
# Set up a model like this:
class Videofile < ActiveRecord::Base
attr_accessor :video_file
before_create :upload_to_vimeo
def upload_to_vimeo
# connect to Vimeo as your own user, this requires upload scope
# in your OAuth2 token
vimeo_client = VimeoMe2::User.new('12345hjhsjdshasd')
# upload the video by passing the ActionDispatch::Http::UploadedFile
# to the upload_video() method. The data_url in this model stores
# the location of the uploaded video on Vimeo.
video = vimeo_client.upload_video(video_file)
self.data_url = video['uri']
true
rescue VimeoMe2::RequestFailed => e
errors.add(:video_file, e.message)
false
end
endYou can also upload a Video File through plain ruby:
# Example in Plain Ruby
video = File.open('video.mp4')
vimeo_client = VimeoMe2::User.new('12345hjhsjdshasd')
vimeo_client.upload_video(video)
The second method is using the Pull Upload method that's offered through the Vimeo Api. This method basically fetches video content from any accessible URL and uploads it to Vimeo
# connect to Vimeo as your own user, this requires upload scope
# in your OAuth2 token
vimeo_client = VimeoMe2::User.new('12345hjhsjdshasd')
vimeo_client.pull_upload 'new name of the video', 'http://www.somelocation.com/video_content.mp4'Take a look at the files under /lib/vimeo_me2/video/ for available methods.
# Get access to a video (both options are valid)
vimeo_video = VimeoMe2::Video.new('12345hjhsjdshasd','196277011')
vimeo_video = VimeoMe2::Video.new('12345hjhsjdshasd','/videos/196277011')
# Or with an uploaded video like with the model
# in the above code fragment
videofile = Videofile.last
vimeo_video = VimeoMe2::Video.new('12345hjhsjdshasd',videofile.data_url)
# Get comments on the video:
vimeo_video.comments
# Get the name of the video:
vimeo_video.name
# Set the name of the video:
vimeo_video.name = "New name"
# Update the video:
vimeo_video.update
# Delete the video (if you have access to do that):
vimeo_video.destroyAt this moment the gem only returns the raw JSON response received from Vimeo. I do plan on extending this to also include a player embed method. But this is still a work in progress.
- Write tests
- Include all parameters in the various API calls
- Write methods for every Vimeo API endpoint
After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.
Bug reports and pull requests are welcome on GitHub at https://github.com/bo-oz/vimeo_me2. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
- Updated the upload code to use the new 3.4 spec for uploading: https://developer.vimeo.com/api/upload/videos#resumable-guide
- The result of an upload is no longer the video URL, but the entire video JSON response
- Did some refactoring to the HTTP Request class
The gem is available as open source under the terms of the MIT License.