How to Integrate Web-Based Educational Games into Google Workspace Add-ons?

I’m working on a learning app that involves vocabulary-building and interactive spelling challenges, and I was wondering—has anyone here tried integrating third-party browser-based games into google docs or classroom using google workspace add-ons or apps script?

The idea is to allow students to directly launch tools like play words game from within a google environment to support classroom engagement. but I’m not sure how far the embedding capabilities go when it comes to games that run in-browser and don’t require sign-in.

are there recommended approaches for linking or partially embedding such web-based tools while keeping things secure and compliant with workspace API usage?

would love to hear if anyone has done something similar or run into related limitations.

Thanks!

To integrate web-based educational games into Google Workspace Add-ons, you don’t embed the full game directly inside Gmail, Docs, or Classroom. Instead, you:

Host your game on the web (HTTPS-secured).

Create a Google Workspace Add-on using Apps Script or CardService UI.

In the add-on, add a card with an iframe/web link (via OpenLink or a web app URL) that opens the game in a new tab or sidebar.

Use Google APIs (Classroom, Drive, Sheets) to connect progress tracking or scoring with student accounts.

Handle authentication with OAuth2 if you need to save user data securely.

In short: host the game externally → build a Workspace Add-on UI → connect it to Google APIs for classroom use → link students to the game while keeping progress in Workspace tools.