This document shows how to install the Toolkit for Google Data APIs. The Toolkit is open source and hosted in a subversion repository on Google Code. After establishing a few prerequisites, we show how to install Subclipse, the Eclipse subversion plug-in, and then how to check the code out from the repository. Once you've done this, head over to one of the other documents in the Related Content section.


Before proceeding to check-out the Toolkit for Google Data APIs, please note that these instructions assume you have the IDE installed and are familiar with the basic functionality of Eclipse. If not, take some time to become familiar with both before proceeding to check-out the source code from the Google repository.

In addition, these steps require that you have installed the Eclipse plug-in that adds support for Subversion revision control system, also known as SVN. Because this is an important feature, please install the subclipse add-in and become familiar with the documentation it provides. If you have used SVN in the past, you may be able to install the subclipse add-in and proceed with the following steps.

Installing Subclipse

Follow the instructions here:

  • Be sure to uncheck Integrations containing Buckminster and Subclipse Integration for Mylyn during the plugin installation.
  • If this is the first time you have used SVN, please read the supporting documentation that comes with the Subclipse add-in.

Checking Out the Toolkit for Google Data APIs

The next step is to select the source code to checkout.

Locating the Repository and Checking out the source code

Steps to Checkout

  1. In eclipse, choose the SVN Repository Exploring perspective in the upper right-hand corner.
    • If this is not available, go to the Window menu, select "Open Perspective", choose "Other", then from the menu that appears, select "SVN Repository Exploring".
  2. Right-click in the SVN Repository Explorer and select New -> Repository Location.
  3. Specify the URL of the repository:
  4. Click Finish.
    Add repository.gif
  5. Expand the SVN repository until you see the google_data_toolkit folder.
  6. Right-click on the folder and choose Checkout.
    Checkout toolkit.gif
  7. Select "Check out as a project in the workspace". Accept the other defaults and click "Finish".
    Checkout as project.gif
  8. Now, use the pull-down menu in the upper right-hand corner of Eclipse to switch to the perspective.
    • If this is not available, go to the "Window" menu, select "Open Perspective", choose "Other", from the menu that appears, select "".
  9. In the Package Explorer, expand the google_data_toolkit folder to verify that you have the following:




























You should now have the Toolkit for Google Data APIs source code in a new Eclipse project called "google_data_toolkit[trunk/google_data_toolkit]".

Configuring your Eclipse project

Now that you have the source code in an Eclipse project, the next step is to associate the Eclipse project with a Developer org or Sandbox.

Setting login properties for your Developer org in Eclipse project

  1. Right-click your project folder in Eclipse and select Properties.
  2. In the dialog box that appears, Select
    Set project properties.gif
    • Tip: If you don't see "[+]" as in the picture above, click cancel and then right-click your project folder in Eclipse. Select "" -> "Add Nature" and then try again.
  3. Enter your login, password and security token to associate your new Eclipse project with a Developer org.
  4. Click the "Apply" button in the lower right.
  5. A dialog box will appear which says "Refresh Project Contents"?
  6. Click "Yes" to populate your new project with the meta data from your org.
  7. Click the "OK" button to close the properties menu.

Synchronizing with your Developer Edition org

Now that you've checked out the source code and configured your new project in Eclipse, the final step is to load the source code from Eclipse to your Developer org.

  1. Expand your google_data_toolkit project folder until you see the src folder.
  2. Right-click the src folder in your project folder and select / Synchronize with Server.
  3. Click “Yes” to switch to the Team Synchronizing perspective.
  4. In the Synchronize view, right-click on your project folder and choose "Apply Project to Server".

Configuring Remote Site settings

Before your application can make any callouts to google you must configure your remote sites within your organization to allow http and https to google, please see this help location:Configure Remote Proxy

Related Content