Google Docs Airdrop
The Google Docs Airdrop facilitates the import and synchronization of documents, groups, and user permissions from Google Docs to DevRev, streamlining documentation workflows and improving collaboration.
Set up the Google Docs connection
To establish the connection between Google Docs and DevRev, follow these steps:
1. Admin flow
In the admin flow, administrators can import:
- Documents
- Groups
- Users
- Permissions
This flow does not require any prerequisites for non-admin users attempting import after the admin has set up groups, users, and permissions.
2. Non-Admin flow
For non-admin users who initiate the import before the admin setup, they can import Groups, Users, and Permissions by fulfilling these prerequisites:
a) Customer ID Retrieval: Obtain the customer ID from the Google Cloud Identity Documentation.
b) Enable Contact Sharing: Admin must enable contact sharing in directory settings, following guidelines provided by Google.
c) Scope Configuration: Ensure the following scopes are added:
- https://www.googleapis.com/auth/cloud-identity.groups.readonly – Required for Groups and Group Members.
- https://www.googleapis.com/auth/directory.readonly – Required for the People API.
These steps are necessary only if a non-admin initiates the import before an admin has imported the necessary users, groups, and permissions.
Supported Objects
Below is a list of Google Docs objects and their corresponding DevRev equivalents:
Importing from Google Docs
To import documents from Google Docs, follow these steps:
- Access Marketplace: Go to the DevRev Marketplace and locate the Google Docs entry in the Airdrop category to install it.
- Snap-in Configuration: After installation, access the Airdrop section within your DevRev settings to configure the snap-in.
- Establish Connection: Set up a new connection to your Google account or use an existing one. Ensure that you have selected the required API scopes.
- Initiate Import: Select the Google Docs account you want to import from and specify the appropriate DevRev parts for the imported documents.
- Automatic Mapping: DevRev attempts to automatically map fields from Google Docs to DevRev. Manual mapping may be required for unmatched fields.
Error handling and syncing
- Periodic Synchronization: Ensure ongoing data syncs so that any updates in Google Docs are accurately reflected in DevRev.
- Handling Failures: Log mismatches in permissions or sync errors responsibly, using retry mechanisms to address Google API rate limits.
Post-import options
Following successful import, manage the Google Docs data with these options:
- Sync to DevRev: Ensure accurate updates and the creation of new items in DevRev for edits and additions made in Google Docs after the last sync.
- View Report: Access comprehensive reports detailing the initial import and any subsequent synchronizations.
- Delete Import: Remove the import along with all items integrated from Google Docs into DevRev by using this feature.
- Edit Connection: Make changes to the established connection for any further integration actions should a connection be disabled or the initiating user become unavailable.