Contents

Abstract

This document shows how to install the Force.com 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.

Prerequisites

Before proceeding to check-out the Force.com Toolkit for Google Data APIs, please note that these instructions assume you have the Force.com 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: http://subclipse.tigris.org/install.html

  • 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 Force.com 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:
    http://apex-google-data.googlecode.com/svn/trunk/
  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 Force.com perspective.
    • If this is not available, go to the "Window" menu, select "Open Perspective", choose "Other", from the menu that appears, select "Force.com".
  9. In the Package Explorer, expand the google_data_toolkit folder to verify that you have the following:
AuthSubUtil.cls

AuthSubUtil.cls-meta.xml

BloggerService.cls

BloggerService.cls-meta.xml

CalendarService.cls

CalendarService.cls-meta.xml

CalendarServiceTest.cls

CalendarServiceTest.cls-meta.xml

ContactService.cls

ContactService.cls-meta.xml

DocumentService.cls

DocumentService.cls-meta.xml

DocumentServiceTest.cls

DocumentServiceTest.cls-meta.xml

GoogleData.cls

GoogleData.cls-meta.xml

GoogleDataTest.cls

GoogleDataTest.cls-meta.xml

GoogleService.cls

GoogleService.cls-meta.xml

SpreadsheetService.cls

SpreadsheetService.cls-meta.xml

SpreadsheetServiceTest.cls

SpreadsheetServiceTest.cls-meta.xml

XMLDom.cls

XMLDom.cls-meta.xml

XMLDomTest.cls

XMLDomTest.cls-meta.xml

You should now have the Force.com 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 Force.com 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 Force.com.
    Set project properties.gif
    • Tip: If you don't see "[+] Force.com" as in the picture above, click cancel and then right-click your project folder in Eclipse. Select "Force.com" -> "Add Force.com Nature" and then try again.
  3. Enter your login, password and security token to associate your new Eclipse project with a Force.com 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 Force.com properties menu.

Synchronizing with your Force.com 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 Force.com 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 Force.com / 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 force.com organization to allow http and https to google, please see this help location:Configure Remote Proxy

Related Content