pauldub/ruby-glass

A Ruby 2.x Google Mirror API client.

ruby-glass

A Ruby 2.x client for the Glass Mirror API.

glass = Glass::Client.new('access_token')

glass.timeline.insert(text: "Hello Paris", location: "Paris")

glass.timeline.list do |card|
	puts "#{card[:id]} - #{card[:text]}"
end

Todo

• Write tests.
• Document.
• Wrap options (for the client, but also for oauth authorization, etc.) in a separate class.

Supported APIs

• Timeline
• Subscriptions
• Locations
• Contacts
• Accounts
• Settings

Obtaining an access token

The following steps can be done to get an access token:

• Initialize the Glass::Client with your client_id and client_secret:

client = Glass::Client.new(nil, client_id: 'foo', client_secret: 'bar')

• Get an authorization code by sending the user to your application's authorization url:

url = client.authorize_url

• Ask the user for the authorization code and exchange it for an access token:

token = client.get_token('the authorization code').token

• Now you can create a client using only the access token:

client = Glass::Client.new(token)

This client_id and client_secret are not required to access the API on behalf of the user but they are required in order to perform authorization. You will probably grab the access token by different means (eg: With omniauth in a web application).

If refresh tokens where to be used, client_id and client_secret would be required for it too.