GSimpleApi

This gem wraps the calls executed by google-api-ruby-client and makes it simple for you to be authorized and access the data provided by Google's apis.

Getting Started

Add this line to your application's Gemfile:

gem 'g_simple_api'

And then execute:

$ bundle

Or install it yourself as:

$ gem install g_simple_api

How to Use

To use the gem you will need to firstly create a project on https://console.developers.google.com, then allow access to the required apis and for last create a new Client ID.

After completed the pre-setting process, you can go back to your app and work on the following steps:

First time use

Create a g_simple_api.rb in /initializers

 GSimpleApi.setup do |config|
  config.name = "test" #The name of your application
  config.version = "1" #The current version of your application
  config.api = "drive" #The api that will be used.
  config.api_version = "v2" #If not specified, it will defaults to v1
  config.client_id = "XXXXXXXXXXXXXXXX" #Value provided in the Credentials Section.
  config.client_secret = "XXXXXXXXXXXXXX" #Value provided in the Credentials Section.
  config.scope = "drive" # The scope(s) required to use the api, it can be an Array.
 end

You now have to send the user to Google's authorization page. Use:
```
 GSimpleApi.process.authorize_url("specified callback")
```

to receive the proper URL and redirect the user to it.

If the user accepts the access to the app, google will redirect you back to the "specified callback" along with a "code" parameter. Use this code to get the valid token.
```
manager = GSimpleApi.process
manager.get_token(params[:code])
```
For further use, You should store the values returned from this call.
To make any call to the api, you have to invoke:
```
manager.execute("method.name", {key1: "value", key2:"value2"}) # Example: manager.execute("files.list")
```
where the first parameter is the action that will be executed and the second is any required or optional parameter.
I hope you enjoy it.

Using refresh token to request token

Tokens may expire due a variety of different reasons. If you have stored the user's refresh token then you won't need to ask the users to go through all the acceptance process again (This is true for cases where the users didn't remove access to the app, you didn't change the scope of the app, or etc...). In order to do it so, you only need to call:

    manager = GSimpleApi.process
    manager.get_token("refresh_token", true) # The second parameter tells the function you are passing a refresh_token

Contributing