Android add-ons (also referred to as "mobile add-ons") are Android apps that can be called from Google Docs or Google Sheets editor apps on a mobile device, and are built by developers like you to enhance or extend the capabilities of those editors. Android add-ons can utilize the Apps Script Execution API to directly call functions in Apps Script projects. This allows Android add-ons to retrieve and manipulate data from a Google Doc or Sheet using standard Apps Script techniques. Just like desktop add-ons, Android add-ons allow you to craft custom user interfaces — but with the full capabilities of the Android platform at your disposal.
Using Android Add-ons
Users can install your published Android add-on from the Google Play store, just like any other Android application. After installing, the app becomes available to the user via the Add-ons menu in the Google Docs or Google Sheets mobile editor apps, or through context menus.
Upon opening your add-on, the user is presented with the interface you designed. You can customize this interface in any way you like — we recommend you follow the Material Design guidelines for Android whenever possible.
As the user interacts with the interface, your add-on will most likely use the Apps Script Execution API to retrieve and send data, usually to the Doc or Sheet the user opened the add-on from. Android add-ons can also use the Execution API to access other services via Apps Script, such as Gmail, Google Calendar, and Google Drive.
Once the user is done interacting with your add-on, closing or backing out of it returns the user to the calling editor, where any changes your add-on made to the open Doc or Sheet will be shown.
See what you can make
The Converting Android Apps into Android Add-ons guide shows how you can build your Android add-on by adapting an existing Android app. Naturally, you can also build an Android app from scratch then use the guide to create an Android add-on from it.
You can also download the Mobile Doc Translate Add-on to see a working example of an Android add-on structure.
Things you can't do
There are a few restrictions on what Android add-ons can do:
Change features in Google Apps
Like regular add-ons, the Android add-ons framework is designed to enhance Google Sheets and Docs — not to add limits. Consequently, you can't alter existing features or lock down the Google Apps sharing model.
Affect the Docs or Sheets editor apps
Android add-ons cannot adjust the appearence or function of the Docs or Sheets editor apps that call them. They also cannot change which file is being presented in the app. For example, an Android add-on cannot change the active sheet in the Sheets app, or open a new Document in the Document app.
Create and adjust triggers
Creating or adjusting Apps Script triggers is currently not possible with the Apps Script Execution API.
Android Add-ons Developer Preview
Android add-ons are currently in Developer Preview. During developer preview:
- Google reserves the right to change the integration points, APIs and intents that support the Android add-ons feature.
- Google can change the way in which this feature is distributed, discovered and used.
This gives us the flexibility to rapidly iterate in collaboration with our partners to offer the best user and developer experience.