erltube

An Erlang library for Google Youtube API v3.

Fetch dependencies and compile

Project depends on jiffy library for JSON parsing.

$ rebar get-deps compile

Quick start

Authentication

The Youtube API v3 uses implementation of oAuth 2.0 for authentiaction and access validation. This library provide helper functions to authorize your application. Fist you neeed to register your application to get client_id, redirect_uri and client_secrect.

Request token

Start authoriation by requesting token based on your client_id and required scope:

Scope = "https://www.googleapis.com/auth/youtube.readonly",
erltube:request_token(ClientKey, RedirectUri, Scope, true).

NOTE: By putting true as a last argument you indicate that requested code will be consumed by your endpoint. See documenatation for more details - section Handle response from Google.

In case your application is not web based use following call to get authorization url:

Url = erltube:request_token(ClientKey, RedirectUri, Scope, false).

Open resulting url in you browser, select account > rights and then manually copy provided code.

Authorize token

Assuming the user has granted access to your application and get authorization code that is used now to get authorized access token using following call:

erltube:authorize_token(ClientKey, ClientSecret, RedirectUri, Code).
{[{<<"access_token">>,
   <<"ya29.AHES6ZTtm7SuokEB-RGtbBty9IIlNiP9-eNMMQKtXdMP3sfjL1Fc">>},
  {<<"token_type">>,<<"Bearer">>},
  {<<"expires_in">>,3600},
  {<<"refresh_token">>,
   <<"1/HKSmLFXzqP0leUihZp2xUt3-5wkU7Gmu2Os_eBnzw74">>}]}

Your application should store both values in a secure, long-lived location that is accessible between different invocations of your application. The refresh token enables your application to obtain a new access token if the one that you have expires.

Refresh token

Access tokens periodically expire and, when that happens, need to be refreshed using:

erltube:refresh_token(ClientKey, ClientSecret, RefreshToken).
{[{<<"access_token">>,<<"1/fFAGRNJru1FTz70BzhT3Zg">>},
  {<<"expires_in">>,3920},
  {<<"token_type">>,<<"Bearer">>}]}

General

After obtaining an access_token for a user, your application can use that token to submit authorized API requests on that user's behalf.

Channels

Returns a collection of zero or more channel resources that match the request params:

TODO

Updates a channel's metadata:

TODO

Playlists

TODO

Upload

TODO

Example

TODO