> For the complete documentation index, see [llms.txt](https://guides.mangoapps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.mangoapps.com/integrations-guide/workspace/integration-with-google-workspace.md).

# Integration with Google Workspace

### Overview 

MangoApps integration with Google Workspace allows teams to create, manage, and collaborate on Google Docs, Sheets, and Slides directly within the MangoApps **Files** module. 

Once enabled, Google Workspace files appear alongside native MangoApps files, marked with their recognizable icons and extensions (`.gdoc`, `.gsheets`, `.gslides`). This functionality is available across:

* Projects, Groups, and Departments
* The Network Files module
* Personal "My Drive" folders

***

### Administrator Setup

Administrators can activate this integration via the **Admin Portal > Integrations > Built-In Integrations > Document Management Apps**.

<figure><img src="/files/MYWg0agIRFqApgiFZJwN" alt="" width="563"><figcaption></figcaption></figure>

* **Enable the Toggle**: A new Google Workspace toggle is available in this section. Note that while the toggle is present by default, the integration requires activation.
* **Authentication**: Admins must complete a one-time Google OAuth authentication to link the organization's Google Workspace to MangoApps.
* **Consolidated Management**: For ease of use, the Google Workspace settings are located alongside the Microsoft 365 toggle, allowing admins to manage all cloud document integrations from a single screen. (Note: Enabling Google Workspace does not change any existing Microsoft 365 configurations).

***

### End User Experience

**Creating and Adding Files**

Users can find the new options under the Files dropdown menu in a dedicated Google Workspace section:

* Create New: Selecting a Document, Spreadsheet, or Presentation opens a dialog to name the file and choose a destination. Upon saving, the file is automatically created in Google Drive and opens in a new tab for immediate editing.
* Add via Link: You can link existing Google Workspace files to MangoApps by pasting any valid Google Docs, Sheets, or Slides URL. This saves the file as a linked entry in your selected MangoApps folder.

**Collaboration and Permissions**

MangoApps simplifies access management by mapping permissions directly to Google Drive:

* Permission Mapping: Sharing a file with a colleague in MangoApps automatically synchronizes their access level (Owner, Editor, or Viewer) in Google. These permissions remain in sync at all times.
* File Actions: Users can perform a focused set of actions on Google files within MangoApps, including View, Edit, Share, Pin, Move, Rename, and Add Hashtags/Descriptions.
* Renaming & Deletion: Renaming a file in MangoApps updates the title in Google Drive simultaneously. However, deleting a file in MangoApps only removes the entry from the portal; the original file remains safe in Google Drive.

**Search and Discovery**

Google Workspace files are fully integrated into the MangoApps search engine:

* Files are searchable by name, hashtags, and descriptions.
* Results appear in the global search "type-ahead" and the full search results page.
* Users can use the Documents, Spreadsheets, and Presentations filters to find specific Google file types quickly.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://guides.mangoapps.com/integrations-guide/workspace/integration-with-google-workspace.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.