Sunday, May 25, 2014

Spring Social Google 1.0.0 Reaches General Availability

I am happy to announce the release of Spring Social Google 1.0.0.RELEASE ! I would like to thank everyone who contributed by testing and submitting issues and pull requests.

Spring Social Google contains bindings to Google Plus, Google Tasks and Google Drive APIs, and allows you to use any Java client library for any Google API while using Spring Social for authentication and connection management.

Project on GitHub: https://github.com/GabiAxel/spring-social-google

Distribution bundle: https://github.com/GabiAxel/spring-social-google/releases/tag/1.0.0.RELEASE

Reference manual: http://gabiaxel.github.io/spring-social-google-reference/

JavaDoc: http://gabiaxel.github.io/spring-social-google-javadoc/

Example application: https://github.com/GabiAxel/spring-social-google-example

To use with Maven add the following code to your POM:
<dependency>
   <groupId>org.springframework.social</groupId>
   <artifactId>spring-social-google</artifactId>
   <version>1.0.0.RELEASE</version>
</dependency>

Creating a Google Cloud Project and Using it with Spring Social Google


Navigate to https://console.developers.google.com/project

Click "Create Project" and enter a name and ID for the project.

Enter the project and in the left menu select "APIs & Auth". In "APIs" activate the APIs you want to use in the application. The example application uses Google+ API and Tasks API.

In the left menu go to "Credentials" and click "Create new client ID". For "Application Type" choose "Web Application" and for "Authorized Redirect URI" enter "http://localhost:8080/signin/google".

The new set of credentials will be added. Note the "Cliend ID" and "Client Secret" values - we will use them when running the example application.

Get the example application from GitHub:
git clone git://github.com/GabiAxel/spring-social-google-example.git

Enter the application directory and run it with Tomcat (replace CLIENT_ID and CLIENT_SECRET with the values you saw in Google Developers Console):
cd spring-social-google-example
mvn tomcat7:run \
   -Dgoogle.clientId=CLIENT_ID \
   -Dgoogle.clientSecret=CLIENT_SECRET

The application will run at http://localhost:8080/

The Road Ahead


There is no shortage of Google APIs. My current though is to proceed to YouTube and Calendar, but I really want to know what you want, so please submit your requests and issues in the GitHub project.

Enjoy using Spring Social Google!