Google Docs

Installation

8min

Installing Google Docs on Rootly

We recommend you perform the installation with a service account to ensure the integration doesn't break, should the installing user leave the company.

Ensure that you are logged in as an Admin user in Rootly.

Locate Google Docs on the Integrations catalog and select Setup.

Document image


You'll be prompted to choose a connection method to your Google account: Connect through OAuth credentials or Connect through JSON file credentials.

Document image


Integrating via OAuth (non-GCP service account)

Click on Setup to start the integration process. You'll be prompted to select a Google account.

Document image


After selecting a Google account, you'll be prompted to grant Rootly permission to integrate with your Google account.

Document image


Once confirmed, you'll be redirected back to Rootly and the installation is considered complete!

Document image


Integrating via GCP service account

Navigate to your Google Cloud Console, and click on IAM & Admin.

Document image


Next, navigate to Service Accounts and create a new service account by clicking on Create Service Account.

Document image


Fill in the Service account details, your Service Account ID will be automatically generated. Click on Done when you have completed the form.

Document image


Next, Navigate to the Keys tab and click on Add a Key .

Document image


Create a key and download the JSON format.

Document image


Next, go back to the Rootly integration page and upload the JSON key.

Document image


Finally, navigate to https://admin.google.com > Security > Api Controls > Domain Wide Delegation and select your service account.

Add the following scopes and click on Authorize:

  • https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/drive.appdata
Document image


The integration process is now complete!

Setting Up Retro Template in Google Docs

Retrospective templates can be set up in Rootly or Google Docs. For details on how to create templates in Rootly, please refer to this page.

To set up templates in Google Doc, simply open a new Doc in Google Drive and built out the document as you would with any document. For any incident values that you'd like to dynamically reference, you can do so using Liquid syntax.

TIP: You can use the Incident Variable Explorer to test out what value each Liquid variable returns.

Uninstall

You can uninstall this integration in the integrations panel by clicking Configure > Delete.

Support

If you need help or more information about this integration, please contact [email protected] or start a chat by navigating to Help > Chat with Us.

Updated 11 Sep 2024
Doc contributor
Doc contributor
Doc contributor
Doc contributor
Did this page help you?