Google APIs Client Library for Java V3

Google APIs Client Library for Java 

• Home

---

• Developer's Guide
• ▾Supported Google APIs
  • ▸APIs Discovery Service
  • ▸Ad Exchange Buyer API
  • ▸Ad Exchange Seller API
  • ▸AdSense Host API
  • ▸AdSense Management API
  • ▸Admin Directory API
  • ▸Admin Reports API
  • ▸BigQuery API
  • ▸Blogger API
  • ▸Books API
  • ▾Calendar API
    • v3 (preferred)
  • ▸Cloud SQL Administration API
  • ▸Cloud Storage API
  • ▸Compute Engine API
  • ▸CustomSearch API
  • ▸DFA Reporting API
  • ▸DoubleClick Bid Manager API
  • ▸Drive API
  • ▸Email Migration API v2
  • ▸Enterprise Apps Reseller API
  • ▸Enterprise Audit API
  • ▸Enterprise License Manager API
  • ▸External API For Ads DoubleClick Search
  • ▸Freebase Search
  • ▸Fusion Tables API
  • ▸Google Affiliate Network API
  • ▸Google Analytics API
  • ▸Google App State API
  • ▸Google Civic Information API
  • ▸Google Cloud Datastore API
  • ▸Google Fonts Developer API
  • ▸Google Identity Toolkit API
  • ▸Google Maps Coordinate API
  • ▸Google Mirror API
  • ▸Google OAuth2 API
  • ▸Google Play Android Developer API
  • ▸Google Play Game Services API
  • ▸Google Play Game Services Management API
  • ▸Google Site Verification API
  • ▸Google+ API
  • ▸Google+ Domains API
  • ▸Groups Migration API
  • ▸Groups Settings API
  • ▸Orkut API
  • ▸PageSpeed Insights API
  • ▸Prediction API
  • ▸Search API For Shopping
  • ▸TaskQueue API
  • ▸Tasks API
  • ▸Translate API
  • ▸URL Shortener API
  • ▸YouTube Analytics API
  • ▸YouTube Data API

---

• Other Client Libraries

Calendar API Client Library for Java

 Calendar API: Lets you manipulate events and other calendar data.

This page contains information about getting started with the Calendar API using the Google APIs Client Library for Java. In addition, you may be interested in the following documentation:

• Browse the JavaDoc reference for the Calendar API.
• Read the Developer's guide for the Google APIs Client Library for Java.
• Interact with this API in your browser using the APIs Explorer for the Calendar API.

Quickstart

Quickstart creates a starter application to get you up and running with the Calendar API and the Google APIs Client Library for Java faster. After you select a platform and click Configure Project, it helps you set up a project in the Google Cloud Console. Finally, it generates a custom client application that you can download, run, and modify.

Java/Google App Engine

 

Configure Project

?

A starter application has been generated for you.

1. Install Java Platform (JDK 6 or higher).
2. Install Maven (3.1.0 or higher). You may need to set your JAVA_HOME.
3. Download the starter application and unzip it.
4. Download the client secrets file and overwrite the src/main/resources/client_secrets.json file that was included in the application.
5. Open a terminal, change to the calendar-appengine-sample directory you just unzipped, and execute:

   mvn clean package
   mvn appengine:devserver
       

   This will compile, package, and deploy your starter application on a local development server. Open http://localhost:8888 in your browser.

Congratulations, you are up and running! At this point you will want to add calls into the Calendar API to thesrc/main/java/com/google/api/services/samples/calendar/appengine/CalendarSampleServlet.java file. Please read the file carefully, it contains detailed information in the comments.

To enable logging of HTTP requests and responses (highly recommended when debugging), please take a look at the src/main/webapp/WEB-INF/logging.properties file.

To deploy your application to appspot.com

If this is the first time you are deploying your application to appspot.com, you will need to perform the following steps first.

• Go to https://appengine.google.com and create an application.
• Edit src/main/webapp/WEB-INF/appengine-web.xml, and enter the unique application identifier (you chose it in the prior step) between the <application> tags.

If you've done the above, you can deploy at any time:

  mvn appengine:update
  

If this is the first time you have run "update" on the project, a browser window will open prompting you to log in. Log in with the same Google account the app is registered with.

For more information on the Calendar API Java library surface you can visit:

https://develpers.google.com/resources/api-libraries/documentation/calendar/v3/java/latest/

Also check out the Java Client Library documentation, and get more information on the Calendar API at:

https://developers.google.com/google-apps/calendar/firstapp

Setup Project in Eclipse

Prerequisites: install Eclipse, 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 calendar-appengine-sample project
  • File > Import...
  • Select "General > Existing Project into Workspace" and click "Next"
  • Click "Browse" next to "Select root directory", find calendar-appengine-sample and click "Next"
  • Click "Finish"
• Run
  • Right-click on project calendar-appengine-sample
  • Run As > Web Application
  • If asked for the location of the WAR directory, select target/war
  • Open http://localhost:8888 in your browser.

Samples

The following samples may help you get started using the client library:

• calendar-android-sample
• calendar-appengine-sample
• calendar-cmdline-sample

Add Library to Your Project

Select your build environment (Maven or Gradle) from the following tabs, or download a zip file containing all of the jars you need:

DownloadMavenGradle

Download the Calendar API v3 Client Library for Java.

See the calendar/readme.html file for details on:

• What the zip file contains.
• Which dependent jars are needed for each application type (web, installed, or Android application).

The libs folder contains all the of the globally-applicable dependencies you might need across all application types.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 3.0 License, and code samples are licensed under the Apache 2.0 License. For details, see our Site Policies.

Last updated October 9, 2013.