Hangouts - Getting Started

Create a Simple Hangout App

The Hangouts API enables you to develop collaborative apps that run inside of a Google+ Hangout. You can write your app as either a Hangout application or extension. The example below is written as an application.

The following steps show you how to quickly host and run a pre-built simple Hangout app. It shows you how you can first run it privately before running it publicly.

1. Download and host the Simple Hangout App

The Simple Hangout App is a quick way to get a demo Hangout app up and running. It is one of our sample apps.

  • Download the simpleHangoutApp.xml file to any directory on your local drive. This file is the only file that you need from the zip file.
  • Host the XML file on a server so it is publicly available. The server should have no firewalls and require no login authentication to access this file.

The next steps show how to run this simple app in a Hangout.

2. Create a Google Developers Console project

Before you can use the Google+ Hangouts API, you need to create a project in the Google Developers Console, and enable and configure the API, as follows. OAuth 2.0 is not required for apps that are running in the developer sandbox.

  1. Go to the Google Developers Console .
  2. Create a new project : from the project drop-down, select Create a new project.
  3. Enable the Google+ Hangouts API service:
    1. In the list of Google APIs, search for the Google+ Hangouts API service.
    2. Select Google+ Hangouts API from the results list.
    3. Press the Enable API button. Wait for the API to be enabled.
    This action adds the service to the Enabled APIs tab, which you can access by selecting API Manager on the left menu. You can turn off the Google Cloud services if you don't need them. Enable any other APIs that your app requires.
  4. In the sidebar under "API Manager", select Credentials, then select the OAuth consent screen tab.
    1. Choose an Email Address, specify a Product Name, and press Save.
  5. Configure the API:
    1. In the left sidebar, select API Manager and then select the Enabled APIs tab.
    2. To the right of the Google+ Hangouts API service name, press the gear icon .
    3. In the Application URL field, enter the URL where you published your Hangout gadget XML file from Step 1. If you skipped Step 1 above, you can instead enter this URL where Google already hosts a public example XML file:
    4. Fill out other information requested on that page.
    5. Press Save.

3. Run the Simple Hangout App

  1. To run this app privately, follow the instructions at Running your app privately.
  2. If you want to make this app public, follow the procedure at Publishing Apps.

Send feedback about...

Google+ Hangouts API
Google+ Hangouts API