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 and easily make calls to their API through 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 respectively a user or a video object from Vimeo. Using the gem starts with obtaining an access token from vimeo.com. When calling the classes, put in the access token and access the various methods.
Use utility methods to make any call against Vimeo. You can see the full list of endpoints in the Vimeo documentation on vimeo.com.
# Set-up the basis for making calls to Vimeo
vimeo = VimeoMe2::VimeoObject.new('12345hjhsjdshasd') # '12345hjhsjdshasd' must be replace by 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 repsonse code
# You can also set additional header
body = "whatever"
vimeo.post('/videos/12344', body:body, headers:{'Content-Type': 'video/mp4'}, code:201)
# Or 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 someones user object
vimeo_user = VimeoMe2::User.new('12345hjhsjdshasd','username')Get a list of the likes, like and unlike video's.
# Fetch for the 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
# Unlike the video
vimeo_user.unlike_video 1234455
# Check if a video is unliked
vimeo_user.check_if_liked 1234455 #returns falseAt this moment there are two ways of uploading video's to Vimeo. The first one works in Rails and uploads an ActionDispatch::Http::UploadedFile object to Vimeo, like so:
# Example in RoR
# Set-up a model like this for instance:
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(self.video_file)
self.data_url = video['uri']
return true
rescue VimeoMe2::RequestFailed => e
errors.add(:video_file, e.message)
return false
end
endYou can also upload a Video File through plain ruby like this:
# 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 above
#in the previous 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 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.