Java Quick Start
Stay organized with collections
Save and categorize content based on your preferences.
This project shows you how to implement a simple
piece of Glassware that demos the major functionality of the Google Mirror API.
To see a fully-working demo of the quick start project, go to
https://glass-python-starter-demo.appspot.com.
Otherwise, read on to see how to deploy your own version.
Download on GitHub
Prerequisites
Ensure your system meets the following prerequisites for the quick start project:
Creating a Google APIs Console project
Next, enable access to the Google Mirror API:
- Go to the Google APIs console and create a new API project.
- Click Services and enable the Google Mirror API for your new project.

- Click API Access and create an OAuth 2.0 client ID for a web application.

- Specify the product name and icon for your Glassware. These fields appear on the OAuth grant
screen presented to your users.

- Select Web application and specify any value for the hostname, such as
localhost

- Click Edit settings... for the client ID to specify redirect URIs. Specify the callback URLs
for your local development web server, for example
http://localhost:8080/oauth2callback
, and
for your deployed web server, for example https://example.com/oauth2callback
.

- Make note of the client ID and secret from the Google APIs Console. You'll need
it to configure the quick start project.

Configure the Quick Start project to use your API client information by entering your client ID and
secret into src/main/resources/oauth.properties
:
# Replace these with values for your project from the Google API Console:
# https://developers.google.com/console
client_id=3141592653589793238462643383279
client_secret=ITS_A_SECRET_TO_EVERYBODY
Importing the project
The following instructions show you to import the Quick Start project source into IntelliJ and
Eclipse.
IntelliJ
- Click File > Import Project....
- Point to the extracted directory.
- Select Import from existing model > Maven
Eclipse
- Install the
m2e
plugin to enable import from a maven pom file.
- Click File > Import... > Maven > Existing Maven Project.
- Point to the extracted directory and import the project.
Running a local development server
You can run the Quick Start project on a local development server for testing:
$ mvn jetty:run
Deploying the Quick Start project
You can build a war file for this project using Maven:
$ mvn war:war
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-07-10 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-07-10 UTC."],[[["\u003cp\u003eThis project provides a simple implementation of Glassware demonstrating core Google Mirror API functionality.\u003c/p\u003e\n"],["\u003cp\u003eIt requires Java 1.6, Apache Maven, and a Google APIs Console project with the Google Mirror API enabled and OAuth 2.0 client ID created.\u003c/p\u003e\n"],["\u003cp\u003eThe project can be configured using your API client information, imported into IntelliJ or Eclipse, and run on a local development server using Maven.\u003c/p\u003e\n"],["\u003cp\u003eA deployable WAR file can be built using Maven for production deployment.\u003c/p\u003e\n"],["\u003cp\u003eA fully-working demo is available at \u003ca href=\"https://glass-java-starter-demo.appspot.com\"\u003ehttps://glass-java-starter-demo.appspot.com\u003c/a\u003e.\u003c/p\u003e\n"]]],[],null,["This project shows you how to implement a simple\npiece of Glassware that demos the major functionality of the Google Mirror API.\n\nTo see a fully-working demo of the quick start project, go to\n[https://glass-python-starter-demo.appspot.com](https://glass-java-starter-demo.appspot.com).\nOtherwise, read on to see how to deploy your own version.\n\n[Download on GitHub](https://github.com/googleglass/mirror-quickstart-java)\n\nPrerequisites\n\nEnsure your system meets the following prerequisites for the quick start project:\n\n- Java 1.6\n- [Apache Maven](http://maven.apache.org/) - used for part of the build process.\n\nCreating a Google APIs Console project\n\nNext, enable access to the Google Mirror API:\n\n1. Go to the [Google APIs console](https://code.google.com/apis/console/) and create a new API project.\n2. Click **Services** and enable the Google Mirror API for your new project.\n3. Click **API Access** and create an OAuth 2.0 client ID for a web application.\n4. Specify the product name and icon for your Glassware. These fields appear on the OAuth grant screen presented to your users.\n5. Select **Web application** and specify any value for the hostname, such as `localhost`\n6. Click **Edit settings...** for the client ID to specify redirect URIs. Specify the callback URLs for your local development web server, for example `http://localhost:8080/oauth2callback`, and for your deployed web server, for example `https://example.com/oauth2callback`.\n7. Make note of the client ID and secret from the Google APIs Console. You'll need it to configure the quick start project.\n\nConfiguring the Quick Start project\n\nConfigure the Quick Start project to use your API client information by entering your client ID and\nsecret into `src/main/resources/oauth.properties`: \n\n # Replace these with values for your project from the Google API Console:\n # https://developers.google.com/console\n\n client_id=3141592653589793238462643383279\n client_secret=ITS_A_SECRET_TO_EVERYBODY\n\nImporting the project\n\nThe following instructions show you to import the Quick Start project source into IntelliJ and\nEclipse.\n\nIntelliJ\n\n1. Click **File \\\u003e Import Project...**.\n2. Point to the extracted directory.\n3. Select **Import from existing model \\\u003e Maven**\n\nEclipse\n\n1. Install the [`m2e`](http://eclipse.org/m2e/) plugin to enable import from a maven pom file.\n2. Click **File \\\u003e Import... \\\u003e Maven \\\u003e Existing Maven Project**.\n3. Point to the extracted directory and import the project.\n\nRunning a local development server\n\nYou can run the Quick Start project on a local development server for testing: \n\n $ mvn jetty:run\n\nDeploying the Quick Start project\n\nYou can build a war file for this project using Maven: \n\n $ mvn war:war"]]