The Vimeo Rest API is a simple, standard API. It’s been added to the Goa library list of services.
Goa library is available with this key, and on github


Vimeo dashboard

There are various kinds of authentication available in Vimeo. This article deals with OAuth2 – known as authenticated access by Vimeo and would be used to allow your Apps Script to access your video resources.
Like other APIS, there’s a dashboard at which you need to create an application and get credentials. All you’ll need is a client id and secret. Goa will give you a redirect API that you can paste into your dashboard.

One off function

If you’re familiar with Goa, you’ll know that there is a one off function you create to store your credentials, which can be deleted after running. For Vimeo it looks like this. Note that I’m using the Script Properties as I’m only going to use these credentials for my own script.
The main points are
  • The id, account and secret come from the vimeo console
  • I’ve called this particular profile ‘vimeo’. You can call it what you like.
  • scopes in vimeo are provided as an array of space separated scope names. Depending on your app you may want to include additional scopes
  • Vimeo access tokens dont’ expire so there is no need for a refresh token process
Once you’ve run this, you’re good to go and you can delete it from your script if you want. It won’t be needed again.

To use

Depending on what you are using it for you’ll need a UI for the consent dialog. This example uses a published web app. One you’ve run this once and authorized it , you won’t need this again.
In the consent dialog, it will tell you the redirect URL to copy to your vimeo developer console to complete the Apps Script/Vimeo app linkage.
You can then use it in your main app like this.
For more like this, see Google Apps Scripts Snippets

Why not join our forum, follow the blog or follow me on Twitter to ensure you get updates when they are available.