Setting up the Google Drive integration allows your team to take advantage of a whole slew of helpful features. Use this integration to reference Google Docs on a Tettra page, set permissions based on your Google Groups, and log in with your Google credentials.
How to Connect your Google Account
Set up or view your Google integration under "My settings" > "My integrations".
Once you're in your settings, look in the left nav for your individual user integrations.
If your Google account is not connected it will look like this:
Click "Connect your Google Account". You'll need to authenticate the integration with your Google login credentials.
NOTE: For the Google Drive integration, you’re only authenticating Google Drive content to which you have been granted access, (not the private content of others on your team).
Tettra only uses the metadata of your files, (file name, type of document, and link to the file). We don’t access any content inside the files.
Google Log in and Authentication
You can confirm your G Suite domain is connected under Team Settings > Team integrations.
After you've added a G Suite domain, your users can use their Google login credentials to sign into Tettra!
If you're on our Scaling plan, you can choose to disable this feature. Just visit the "Admin settings" tab in your account settings and make sure to uncheck the G Suite option:
It's important to keep in mind that connecting to a G Suite domain restricts Google log in to just the domain.
When your users sign into Tettra, they'll be presented with the option to sign in via Slack, Google, or email.
Select "Sign in with Google", choose the Google account you'd like to sign in with (making sure it's connected to your G Suite domain), and we'll use your Google sign in credentials to log you into Tettra.
How to Use the Integration
1. Search for and Reference Docs
Go to a new or existing Tettra page. Use the hash key (#), and you'll see the five most recently modified files to which you have access. Start typing the name of the file you want. When you see the result you want, select it, and the document is now referenced inline in your Tettra page. You can embed files you created as well as files other have shared with you or made public.
If you have the GitHub integration enabled as well, you’ll see a combo of Google Drive and GitHub results come up. You can differentiate between Google Drive and GitHub items by the icon that appears next to the options. The icon also tells you what type of file you're referencing (doc, spreadsheet, presentation, etc).
Now, when someone clicks on the file in your Tettra page, it'll open in a new tab. The reader must have access to the file in Google Drive, (ie be the account owner or be shared on the doc.) If they don’t have access, they’ll have to request access via the Google Drive page.
2. Set Permissions based on Google Groups (Only Available on Scaling)
Sync your Google Groups under "Team Settings" > "Team Integrations".
Once you've synced your groups, you're ready to start setting team permissions! Navigate to an invite-only category and select edit from the kebab menu:
In the category settings, make sure your category is set to
"Only certain people and groups". When you click into the dropdown, you should see a list of individual users and Google Groups to pick from:
Once you're done, click "Update category" and your permissions will be saved! Check out this article for more reference.
How to Disable the Integration
Whether you're no longer using the integration or trying to connect a new G Suite domain, the process of removing the integration is simple.
Head over to your Team Integrations, scroll down to the G Suite integration, and click "Remove".