Publish Google Chat apps

After you've created a Chat app, you can publish it so that it's available to select people or groups, everyone in your Google Workspace organization, or any Google Chat user.

How users discover and use Chat apps

To discover Google Chat apps, users can do any of the following:

  • Search and install Chat apps from Google Chat or the Google Workspace Marketplace.
  • Interact with an app that's been added to a Chat space.
  • Discover the app in their direct messages panel after a Google Workspace administrator installed the app on their behalf.

To start using an app, Google Chat users can start a direct message with the app or add it to a space. Users can also add the app by @ mentioning it. The following example shows how a user @ mentions a Chat app to add it to a space:

Adding an app to a space by typing @ in a message.

How Google Workspace administrators install Chat apps

Google Workspace administrators can find Chat apps on the Google Workspace Marketplace and install the apps for users in their organization. When an administrator installs a Chat app, the app appears in the users' direct messages panel.

Google Workspace administrators can also manage and allowlist the use of Chat apps in their Google Workspace organization. If you're developing a Chat app for an organization that uses allowlists, you must request that an administrator adds your Chat app to the allowlist so that users can find and use the app. For more information see Google Workspace Admin Help's documentation, Allow users to install Chat apps.

Configure and publish your Chat app using the Google Cloud console

To publish your Chat app and make it available to others, you generally need to follow these steps:

  1. Enable and configure the Google Chat API. When you configure the API, you grant other Google Chat users access to your Chat app for testing.
  2. Publish your app with the Google Workspace Marketplace SDK. You can configure your Chat app to be available to users in your Google Workspace organization, or to all Google Chat users.
  3. If your Google Workspace organization manages access to Chat apps, request that your Google Workspace administrator adds the app to the organization's allowlist.

Visibility and publishing settings for your Chat app

The following table explains how to configure the settings for the Google Chat API and Google Workspace Marketplace SDK based on the audience of your Chat app:

Intended app users Authentication method Google Chat API settings Google Workspace Marketplace SDK settings Where is my Chat app published?
Your small team Authenticate as a user or an app. In the Visibility setting, specify people or Google Groups that can access the app.

If your Google Workspace account requires apps to be allowlisted, you can only specify up to 5 individual email addresses (You can't specify Google Groups).

You don't need to configure the Google Workspace Marketplace SDK for your Chat app. Team members can find and use your Chat app from Google Chat.
Your large team Authenticate as a user or an app. In the Visibility setting, specify people or Google Groups to test your Chat app.

After testing, publish your Chat app to your Google Workspace organization using the settings in the Google Workspace Marketplace SDK.

Set App visibility to Private.

Set Installation settings to Individual + Admin.

If your Google Workspace account requires apps to be allowlisted, request that an administrator add your Chat app to the allowlist so that users can find and use the app. For more information see Google Workspace Admin Help's documentation, Allow users to install Chat apps.

Anyone in your Google Workspace organization can find and install your Chat app in Google Chat, and view your app in the Google Workspace Marketplace. Users and Google Workspace administrators can install your app from the Marketplace.

Your Google Workspace organization Authenticate as a user or an app. In the Visibility setting, specify people or Google Groups to test your Chat app.

After testing, publish your Chat app to your Google Workspace organization using the settings in the Google Workspace Marketplace SDK.

Set App visibility to Private.

Set Installation settings to Individual + Admin.

Anyone in your Google Workspace organization can find and install your Chat app in Google Chat, and view your app in the Google Workspace Marketplace. Only Google Workspace administrators can install your app from the Marketplace.

Everyone (public Chat app) Authenticate as a user or an app. In the Visibility setting, specify people or Google Groups to test your Chat app.

After testing, publish your Chat app publicly using the settings in the Google Workspace Marketplace.

Set App visibility to Public.

Set Installation settings to Individual + Admin

Any Google Workspace user can find and install your Chat app in Google Chat, and view your app in the Google Workspace Marketplace. Only Google Workspace administrators can install your app from the Marketplace.

Enable and configure the Google Chat API

Set up a project for your app in the Google Cloud console and enable the Google Chat API:

  1. Use the button below to create a new project (or select an existing one) and add a service account to it. Give the service account the Project Owner role.
    Enable the API
  2. Save the downloaded JSON key. Your app can use this key to authenticate messages that it sends to spaces asynchronously.
  3. Open your project in the . In the list of APIs, click Google Chat API.
  4. Select the Configuration tab and enter the information for the app, as described in the following table.

When you save the app configuration, your app becomes available to the specified users in your Google Workspace organization.

Google Chat API configuration settings

Field Description
App name The name that people use when interacting with your Chat app.
Avatar URL An HTTPS URL pointing to a square graphics image (e.g. PNG or JPEG), at least 128x128, that will appear as the avatar for your Chat app.
Description A description of the Chat app's functionality which appears below your Chat app's name.
Functionality A set of fields that determine how Chat app can interact with users:
  • Receive 1:1 messages: Users can find and message the Chat app directly in Google Chat.
  • Join spaces and group conversations: Users can add the Chat app to spaces and group conversations.
Connection settings The endpoint for the Chat app, which is one of the following:
  • App URL: An HTTPS endpoint that hosts the Chat app implementation.
  • Apps Script project: A deployment ID for an Apps Script project that implements a Chat app.
  • Cloud Pub/Sub topic name: A Cloud Pub/Sub topic that the Chat app subscribes to as an endpoint.
  • Dialogflow: Registers the Chat app with a Dialogflow integration. For more information, see the Dialogflow documentation on integration with Google Chat.
Slash commands Commands that can be surfaced to users within Google Chat. Allows users to see core actions for your Chat app within Google Chat, and choose a specific action they wish to interact with.
Link previews URL patterns that the Chat app recognizes and provides additional content for when users send links. For more information, refer to Preview links.
Visibility Up to 5 individuals or one or more Google Groups that can view and install your Chat app. Use this field to test your Chat app, or to share the Chat app with your team. To learn more see Visibility and publishing settings for your Chat app.

Grant app configuration permissions

You can grant specific users access to the app configuration page. To do this, use the Chat apps Owner and Chat apps Viewer IAM roles. Users with these roles can't navigate to the app configuration page via the APIs & Services dashboard, but can access the configuration page by navigating to the console for their project as follows:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

Publish your app with the Google Workspace Marketplace SDK

Use the Google Workspace Marketplace SDK to do any of the following:

  • Publish your Chat app publicly and let any Google Chat user add your app to a space.
  • Publish your Chat app to your Google Workspace organization.
  • Make your app visible to Google Workspace administrators so that they can install the app for users in their organization. To be visible to Google Workspace administrators, your app must feature direct messaging.

Before you publish your app using the Google Workspace Marketplace SDK, follow these steps:

  1. Test your Chat app by installing it from Chat. Make sure your app is fully functional and not a work in progress.
  2. Review the publication requirements and verify that your app satisfies all of them. See Areas of review.
  3. Record your app’s version number--you need this to configure the Google Workspace Marketplace SDK.

When you're ready to publish, see Overview: Publish an app.