• NAME
• SYNOPSIS
• DESCRIPTION
• ATTRIBUTES
• AUTHOR
• SEE ALSO
• LICENSE

NAME

Net::Google::DataAPI::Auth::OAuth2 - OAuth2 support for Google Data APIs

SYNOPSIS

  use Net::Google::DataAPI::Auth::OAuth2;

  my $oauth2 = Net::Google::DataAPI::Auth::OAuth2->new(
    client_id => 'xxxxxxxxxxxxxxxxxxxxxx.apps.googleusercontent.com',
    client_secret => 'mys3cr33333333333333t',
    scope => ['http://spreadsheets.google.com/feeds/'],

    # with web apps, redirect_uri is needed:
    #
    #   redirect_uri => 'http://your_app.sample.com/callback',

  );
  my $url = $oauth2->authorize_url();

  # you can add optional parameters:
  #
  #   my $url = $oauth2->authorize_url(
  #     access_type => 'offline',
  #     approval_prompt => 'force',
  #   );

  # show the user $url and get $code
  # if you're making web app, you will do:
  #
  #   return $c->redirect($auth->authorize_url());
  #
  # getting $code from the request to the 'redirect_uri' in web apps:
  #
  #   my $code = $c->req->param('code');
  #
  # in installed apps:
  #
  #   use Term::Prompt;
  #   my $code = prompt('x', 'paste the code: ', '', '');

  my $token = $oauth2->get_access_token($code) or die;

  # after retrieving $token, you can use $oauth2 with Net::Google::DataAPI items:

  my $client = Net::Google::Spreadsheets->new(auth => $oauth2);

DESCRIPTION

Net::Google::DataAPI::Auth::OAuth2 interacts with google OAuth 2.0 service and adds Authorization header to given request.

ATTRIBUTES

You can make Net::Google::DataAPI::Auth::OAuth2 instance with those arguments below:

• client_id

  client id. You can get it at https://code.google.com/apis/console#access.

• client_secret

  The client secret paired with the client id.

• scope

  URL identifying the service(s) to be accessed. You can see the list of the urls to use at http://code.google.com/intl/en-US/apis/gdata/faq.html#AuthScopes

• redirect_url

  OAuth2 redirect url. 'urn:ietf:wg:oauth:2.0:oob' will be used if you don't specify it.

See https://developers.google.com/accounts/docs/OAuth2 for details.

AUTHOR

Nobuo Danjou <danjou@soffritto.org>

SEE ALSO

Net::OAuth2

https://developers.google.com/accounts/docs/OAuth2

you can see sample implementations for oauth2 client both as installed and web app in the eg directory of this distribution.

LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

                    cpanm Net::Google::DataAPI::Auth::OAuth2

                    perl -MCPAN -e shell
                    install Net::Google::DataAPI::Auth::OAuth2