Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Ruby

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bin
examples/sinatra
lib/google
spec
tasks
.gitignore
CHANGELOG
LICENSE
README
Rakefile

README

== APIClient

Homepage::  google-api-ruby-client[http://code.google.com/p/google-api-ruby-client/]
Authors::   Bob Aman (mailto:bobaman@google.com), Matt Pokrzywa (mailto:mattpok@google.com)
Copyright:: Copyright 2010 Google Inc.
License::   Apache 2.0

== Description

The Google API Ruby Client makes it trivial to discover and access supported
APIs.

== Example Usage

  # Initialize the client
  require 'google/api_client'
  require 'signet/oauth_1/client'
  client = Google::APIClient.new(
    :service => 'buzz',
    # Buzz has API-specific endpoints
    :authorization => Signet::OAuth1::Client.new(
      :temporary_credential_uri =>
        'https://www.google.com/accounts/OAuthGetRequestToken',
      :authorization_uri =>
        'https://www.google.com/buzz/api/auth/OAuthAuthorizeToken',
      :token_credential_uri =>
        'https://www.google.com/accounts/OAuthGetAccessToken',
      :client_credential_key => 'anonymous',
      :client_credential_secret => 'anonymous'
    )
  )
  client.authorization.fetch_temporary_credential!(
    :additional_parameters => {
      'scope' => 'https://www.googleapis.com/auth/buzz'
    }
  )
  redirect_uri = client.authorization.authorization_uri(
    :additional_parameters => {
      'domain' => client.authorization.client_credential_key,
      'scope' => 'https://www.googleapis.com/auth/buzz'
    }
  )
  # Redirect user here
  client.authorization.fetch_token_credential!(:verifier => '12345')

  # Discover available methods
  method_names = client.discovered_service('buzz').to_h.keys

  # Make an API call
  response = client.execute(
    'chili.activities.list',
    {'scope' => '@self', 'userId' => '@me', 'alt' => 'json'}
  )
  status, headers, body = response

== Install

Be sure both http://gems.github.com/ and http://rubygems.org/ are in your gem
sources.

For normal client usage, this is sufficient:

sudo gem install google-api-client

The command line interface, the example applications, and the test suite
require additional dependencies. These may be obtained with:

sudo gem install google-api-client --development --force --no-rdoc --no-ri
Something went wrong with that request. Please try again.