Publishing Android Add-ons

To publish an Android add-on, it must be submitted to the Google Play Store as an Android app (if it is not already there). After that, the add-on must pass an add-on review. This review ensures that your Android add-on is designed well, follows the UX Style Guide, and does not include or produce any spam, malware, or unacceptable content.

Development checklist

Before beginning publishing, verify that your add-on is functioning well. Use the following checklist to determine if you are ready to publish. Make sure that:

  • The add-on is fully functional—it can't be a “work in progress”.
  • The add-on does not duplicate functionality already present in the Google editor apps that launch the add-on—add-ons must extend what the editor apps do, not replicate it.
  • The design adheres to the UX style guidelines.
  • The add-on has error-handling code and shows appropriate error messages to the user when necessary.
  • The add-on makes good use of runtime permissions when possible and follows runtime permission best practices.
  • The add-on's menus are correctly defined in its AndroidManifest.xml file, with each menu item launching the correct Activity.
  • The add-on has been tested throughly, including edge cases.
  • If you are adapting an existing app to act as an Android add-on, the app must function properly if the Android add-on aspects are unavailable (for example, due to the app not being reviewed yet). The user experience should never suffer if the Android add-on functions are disabled for any reason.
  • If you want to publish your add-on publicly, request verification before starting the publishing process.

If you have not submitted the add-on to the Google Play Store yet, you also need (at minimum) the following assets to complete the add-on's store listing:

  • At least two screenshots of your app (preferably from phones and tablets; using tablet screenshots requires at least one from a 7-inch tablet and one from a 10-inch tablet).
  • A hi-res icon for you app (512 x 512, 32-bit PNG with alpha).
  • A feature graphic (1024 w x 500 h, JPG or 24-bit PNG, no alpha).
  • A short description of the add-on (80 characters max).
  • A full description of the add-on (4000 characters max).

You may also want to enrich the add-on listing with additional screenshots, a promo graphic and a promo video. You may also wish to prepare an end-user license agreement (EULA) and a privacy policy document.

Submit to the Google Play Store

All Android add-ons must have an entry in the Google Play Store. To submit an app for the first time, first review the Get started with publishing documentation.

The Google Play Launch checklist provides detailed list of steps to take prior to launching your app, including how to prepare your add-on for release. Review these documents carefully and follow their instructions to get your app into the Google Play Store.

While following these instructions, keep these points in mind:

  1. Remember to set your add-on as the system debug app while testing. This allows your add-on to appear in the Docs and/or Sheets editor app menus on your test device prior to passing the Android add-on review. Setting the add-on as the debug app enables all debug and release builds of that add-on.
  2. Be sure to test the release build prior to uploading to the Google Play Store. Make sure your add-on's OAuth credentials are established for the release build and function correctly—an add-on's debug and release builds require separate OAuth credentials.
  3. The Android add-on review team needs access to your add-on to conduct its review. The add-on either needs to be published publicly, or you need to create a Closed beta with Google+ community or Google Group beta test and invite the review team (mobile-addon-reviews@googlegroups.com) to participate.

You can use the Google Play Console to manage Android apps you've developed and submitted to the Google Play Store.

Android add-on review

Android Add-ons have been deprecated and no longer supported. New Android add-ons can't be reviewed or published. If you re-publish an existing Android add-on after a code update, it doesn't require review.

Updating your Android add-on

If there are changes you wish to make to your Android add-on, determine if the changes require updating the Android APK, and if they require updating any Apps Script projects your add-on calls.

If the changes require updating the Android APK, make the appropriate changes to your Android project and the follow the updating instructions to get the new version into the Google Play Store.

If the changes you wish to make affect an Apps Script your Android add-on calls with the Apps Script API, do the following:

  1. Make the appropriate changes to the Apps Script project.
  2. Test the changes throughly to ensure they work as intended for the Android add-on.
  3. In the Apps Script editor, select Publish > Deploy as API executable
  4. Create a new version with a label, and then click Deploy.

Unpublishing your Android add-on

You can remove your add-on from the Google Play Store by following these Unpublish an app instructions. This prevents new users from finding your add-on, but existing users can still use the app and receive updates.

You can undeploy an Apps Script project that your Android add-on is calling by selecting Publish > Deploy as API executable in the Apps Script editor, then clicking Disable. This prevents any application from calling the methods in the Apps Script project, which may break your add-on for existing users. The deployment dialog also allows you to re-deploy a project that you have previously disabled.