Instructions for the Google Analytics API Command-Line Samples

Browse Online

There are 3 samples. Browse Source of all of them. Or view the main file of each sample:

• HelloAnalyticsApiSample.java
• CoreReportingApiReferenceSample.java
• ManagementApiReferenceSample.java
• McfReportingApiReferenceSample.java

Register Your Application

• Visit the Google apis console
• If this is your first time, click "Create project..."
• Otherwise, click on the drop down under the "Google apis" logo at the top left, and click "Create..." under "Other projects"
• Click on "API Access", and then on "Create an OAuth 2.0 Client ID...".
• Enter a product name and click "Next".
• Select "Installed application" and click "Create client ID".
• In the newly created "Client ID for installed applications", click "Download JSON" on the right side. Later on after you check out the sample project, you will copy this downloaded file (e.g. ~/Downloads/client_secrets.json) to src/main/resources/client_secrets.json. If you skip this step, when trying to run the sample you will get a 400 INVALID_CLIENT error in the browser.

Checkout Instructions

Prerequisites: install Java 6, Mercurial, and Maven. You may need to set your JAVA_HOME .

cd [someDirectory]
hg clone https://code.google.com/p/google-api-java-client.samples/ google-api-java-client-samples
cd google-api-java-client-samples/analytics-cmdline-sample
cp ~/Downloads/client_secrets.json src/main/resources/client_secrets.json
mvn compile
mvn -q exec:java
  

To enable logging of HTTP requests and responses (highly recommended when developing), please take a look at logging.properties.

Setup Project in Eclipse

Prerequisites: install Eclipse, the Mercurial plugin, and the Maven plugin.

• Setup Eclipse Preferences
  • Window > Preferences... (or on Mac, Eclipse > Preferences...)
  • Select Maven
    • check on "Download Artifact Sources"
    • check on "Download Artifact JavaDoc"
• Import analytics-cmdline-sample project
  • File > Import...
  • Select "General > Existing Project into Workspace" and click "Next"
  • Click "Browse" next to "Select root directory", find [someDirectory]/google-api-java-client-samples/analytics-cmdline-sample and click "Next"
  • Click "Finish"
• Run
  • Right-click on project analytics-cmdline-sample
  • Run As > Java Application
  • If asked, type "HelloAnalyticsApiSample" and click OK

Note: The default for this project is to run the HelloAnalyticsApiSample application. You can run the other samples by updating the pom.xml mainClass attribute for Maven or Right clicking the appropriate file in Eclipse.