Skip to main content

Google Drive Integration

Google Drive Integration: Import files from Google Drive into Yoodli and manually sync updates when new versions are available.

Written by Christian Bedoya

Yoodli’s Google Drive integration lets org admins import files from Google Drive into Yoodli. If a file changes later, Yoodli can detect an update and let you manually sync the newest version. Yoodli does not auto-overwrite imported files because that could impact roleplays already assigned to learners.

Set up and import files

Requirements

  • You must be an org admin.

How to connect and import

  • Go to Files in the left-hand navigation.

  • Click Add.

  • Select Add from Google Drive.

  • Connect your Google account when prompted.

  • Choose the files you want to import.

Limits

  • You can import files only.

  • Folders are not supported.

Sync a newer version of a file

What this does

  • Replaces the current file in Yoodli with the latest version from Google Drive.

How it works

  • When a Drive file is edited, Yoodli can detect an update.

  • You will see an update available indicator on the Files page.

  • Yoodli will only overwrite the file when someone clicks to sync the update.

Who can sync updates

  • Anyone who has access to the Files page.

Multiple updates

  • If multiple updates happen before you sync, Yoodli shows only the latest update.

What happens when a Google Drive file changes

Rename a file in Drive

  • Yoodli updates the filename in Yoodli to match the most recent name.

Two different Drive files with the same filename

  • Allowed. Yoodli tracks files by internal file IDs, even if names match.

Move a file in Drive

  • Updates should continue as long as the file keeps the same Google Drive file ID.

  • If the file is moved to a location the original uploader cannot access, syncing may stop.

  • The last synced version in Yoodli remains available.

Replace a Drive file with a new one that has the same name

  • If the file ID changes, updates stop.

  • Import the new file into Yoodli as a new file.

Access and permission changes

Drive access revoked or app access removed

  • The file already in Yoodli remains available.

  • Syncing updates may fail because Yoodli cannot download the file.

Access revoked and later re-granted

  • Older imported files may not reliably resume receiving updates.

  • Best workaround: delete the file in Yoodli and re-import it from Google Drive.

Permissions changed (viewer or editor removed)

  • Viewer and editor are treated the same.

  • If a user loses access to the file, updates stop.

Ownership transferred

  • If the importing user no longer has access to the file, updates stop.

Deleting files: what to expect

Delete a file in Yoodli

  • Removes the file from Yoodli.

  • Removes any update notification in Yoodli.

  • Does not delete the file in Google Drive.

Delete a file in Google Drive

  • The last successfully synced version remains in Yoodli.

  • If an update was pending before deletion, Yoodli may still show “update available,” but syncing will fail.

Shared file deleted in Drive by someone else

  • Updates stop.

Known issue: missed update notifications

What can happen

  • If Yoodli is down and the Google Drive webhook watch is not refreshed for 24 hours, Yoodli can permanently lose update notifications for that file.

Workaround

  • Delete the file from Yoodli.

  • Re-import it from Google Drive.

Did this answer your question?