This article is for G Suite Administrators who want to know more about how to install the Huddle for G Suite add-on for their users.
If you are an end user who is already allowed to install add-ons yourself, read our guide to using the add-on here.
I) Installation options
Option A: Let users install the Huddle add-ons themselves
There are 2 ways that end users can install the Huddle add-ons for Docs and Sheets themselves.
- If whitelisting is enabled, and you've added the Huddle add-ons to your whitelist or if whitelisting is disabled completely, users can install the add-ons from the G Suite Marketplace.
- If you've allowed installation of add-ons in Google Drive settings, users can install them via the "Add-ons Store" accessed via the menu in Docs or Sheets ("Add-ons" -> "Get add-ons"). Please note: whitelists are are also enforced for the add-ons store.
Option B: Install the add-on on behalf of users
If many will be using the Huddle add-ons it would be far easier to install it for them. Google lets you install add-ons across the whole domain or within specific organizational units.
This article (by Google) explains the exact procedures you'll need to follow to implement your preferred installation option.
TIP: Please ensure you install or authorise the correct add-ons for your organisation (see below)
II) Ensure you install or authorise the correct add-ons
We have separate add-ons that can be installed for Google Docs or Sheets and they can connect to either the Huddle Global instance (login.huddle.net) or the Huddle US instance (login.huddle.com):
- Google Docs add-on for our Global instance (hosted in the UK)
- Google Sheets add-on for our Global instance (hosted in the UK)
- Google Docs add-on for our US Gov & Healthcare instance (hosted in the USA)
- Google Sheets add-on for our US Gov & Healthcare instance (hosted in the USA)
When whitelisting or installing add-ons on behalf of your users please ensure that you select both the Docs and Sheets add-ons for the correct instance otherwise users will not be able to sign in to the add-on.
III) Add-on Permissions
Our add-ons use the following Google permissions to allow the add-on to link and publish copies of your Google documents to Huddle:
- "View your email address" - basic permission required to use add-ons.
- "View your basic profile info" - basic permission required to use add-ons.
- "View and manage your documents in Google Drive" - allows us to view data for the Google documents that users publish to Huddle.
- "View and manage your spreadsheets in Google Drive" - allows us to view data for the Google sheets that users publish to Huddle.
- "View and manage the files in your Google Drive" - allows us to export documents and sheets to Huddle in compatible formats. E.g. Docs format to PDF or Word.
- "Connect to an external service" - allows the add-on to communicate with Huddle's servers.
- "Allow this application to run when you are not present" - allows the add-on to refresh OAuth 2.0 tokens in the background.
- "View and manage data associated with the application" - allows us to save and retrieve the unique document reference for the linked document in Huddle.
- "Publish this application as a web app or a service that may share your data" - allows us to publish the add-on in the Add-ons Store & Marketplace so that it can be installed by users and managed by administrators.
Please note: Data is sent to directly from Google Drive to Huddle via this add-on. All users of this add-on are required to sign into Huddle using valid Huddle credentials and have been granted permissions to access or upload documents to the target Workspace and folder in Huddle.