Document Services Framework for Google Drive
Integrate the Document Services with Google Drive.
Request apps on the Store
Visit the ServiceNow Store to view all the available apps, and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the ServiceNow Store version history release notes.
Integration Hub subscription
This spoke requires an Integration Hub subscription. For more information, see Legal schedules - IntegrationHub overview.
Supported versions
This Spoke was built for Document Services Framework V1.0, but may be compatible with Utah and later versions.
Key features
Document Services Framework for Google Drive enables a flow designer to:
- Upload the document to Google Drive
- Collaborate
- Manage versions
- Download documents
Spoke requirements
Spoke dependencies
If you’re having trouble installing the app, verify that these dependent plugins are installed:
- IHUB Spoke Util Pack (com.snc.ihub_spoke_util_pack)
- Multi Provider Document Services Framework (com.snc.multiprovider_documents)
- Remote Directory Sync (com.snc.remote_directory_sync)
- ServiceNow Flow Designer - Dynamic Inputs (com.glide.hub.dynamic_inputs)
- ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
- ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
Note: Some of these plugins are licensable features and require appropriate licenses, if used outside the spoke implementation.
Spoke subflows
The Document Services Framework for Google Drive provides sample subflows to demonstrate automating Google Drive tasks for My Drive and Shared drives. To customize a sample subflow, copy it to a new application scope. Available sample subflows include:
| Subflow | Description |
|---|---|
| Create Document | Copies the document to Google Drive and creates a record in the Documents table with the folder ID and created version in Version table under Multi Provider Documents. |
| Create Document V1 | Copies the document to Google Drive and creates a record in the Documents table with shareable folder URL and created version in Version table under Multi Provider Document Services Framework Documents. Note: For shared drive copy the URL and the URL should be in the below the format and anything in between drive and folder needs to be removed while copying the URL. https://drive.google.com/drive/folders/<folder ID> |
| Create Group | Creates a group as specified in Google Drive and updates the Permission Configurations table under Multi Provider Documents. |
| Add Collaborator To Group | Given a Group ID from Google Drive, this subflow will add the given collaborator as specified by role. |
| Collaborate Document | Adds a permission to a given user, group or domain, or to anyone, for a file. This permission is based on a permission type and role and is how collaboration is configured in Google Drive. If User or Group is selected, the email address is required for those users and groups. If Domain is selected, the domain name to create permission for is required. If Anyone is selected, then anyone has permission to the file or folder. |
| Connect Document From Google Drive Using ID | Connects the Google Drive document using the ID and can be tracked under Multi Provider Document Services Framework documents |
| Connect Document From Google Drive V1 | Connects the Google Drive document using the shareable URL for the document and can be tracked under Multi Provider Document Services Framework documents. |
| Copy Google Drive Document Version | Copies the document with the given version from Google Drive to an attachment in ServiceNow. |
| Delete Document | Deletes the document in Google Drive and remove its corresponding records in documents and versions tables. |
| Delete Document Version | Deletes the document in Google Drive and remove its corresponding records in documents and version tables. |
| Get All Document Versions | Gets all the document versions from Google Drive and creates or updates records in the Versions table under Multi Provider Documents. |
| Get Document From Google Drive | Copies the document from Google Drive to the Document Name referred by creating a record in the documents table and all its versions in the Versions table under Multi Provider Documents. |
| Get Document Latest URL | Constructs the web view URL and web edit URL for the file by verifying if the file actually exists in Google Drive. Consuming APIs are required to verify if the file is present or not. |
| Get Oldest Document Version | Returns the oldest version of the document. |
| Reconnect Document From Google Drive | Reconnects the Google Drive document that can be tracked under Multi Provider Documents. |
| Sync Collaborator | Syncs all Google Drive users in a domain with the Collaborators table under Multi Provider Documents. |
| Update Document Content | Updates the document with the attached content in Google Drive corresponding with the document ID from table Multi Provider Documents sys\_id. |
Spoke actions
The Document Services Framework for Google Drive provides actions to automate Document Services tasks when events occurs in your ServiceNow instance. Available actions include:
| Action | Description |
|---|---|
| Delete document and versions | Deletes the specified document along with versions from Multi Provider document and versions table. |
| Look Up Incremental Files and Folders |
Note: Search results may vary due to Google Drive 's indexing behavior. |
| Look Up Files and Folders Stream | Retrieves the list of files and folders under the given folder. |
| Copy File Revision as Attachment | Copies the given Revision ID for a File ID to any record in ServiceNow. |
| Delete document version | Deletes the specified versions of a document from Multi Provider document versions table. |
| Look Up Target Record Existence | Checks for the existence of the target record in the specified target table. |
| Copy Doc File to Attachment | Copies the Google doc file toServiceNow as an attachment. |
| Copy Doc Revision as Attachment | Copies the given revision ID for a Google document file ID to any record in ServiceNow. |
| Get File Type Info | Returns the file type and information for the input mime-type. |
Connection and credential alias requirements
Integration Hub uses aliases to manage connection and credential information, and OAuth credentials. Using an alias eliminates the need to configure multiple credentials and connection information profiles when using multiple environments. If the connection or credential information changes, you don't need to update any actions that use the connection.
For information about setting up the spoke, see Set up Document Services framework for Google Drive.
Parent Topic:Google Drive integration with Document Services