--- title: Google API Integration on Truto slug: google category: Default canonical: "https://truto.one/integrations/detail/google/" --- # Google API Integration on Truto **Category:** Default **Status:** Generally available ## Unified APIs ### Unified HRIS API - **Employees** — Represents an employee in HRIS - **Groups** — Groups represent the groups for an Employee ### Unified Forms API - **Fields** — - **Forms** — - **Responses** — ### Unified Knowledge Base API - **Page-Content** — Represents the content of a page - **Pages** — Represents the pages, posts, articles in a knowledge base ### Unified Emails API - **Attachments** — Attachments are the files associated with an email. - **Emails** — An email is a digital message sent and received electronically over the Internet. It typically contains a subject, sender, recipients, body content, and sometimes attachments. - **Folders** — The folder is a container used to organize and manage email messages. ### Unified User Directory API - **Me** — - **Role Assignments** — - **Roles** — The Role object represents a role of a User. - **Users** — The User object represents a User. - **Workspaces** — Workspaces represent concepts like teams, workspaces, projects in apps that support them ### Unified Conferencing API - **Attendees** — The attendees represent the individuals who join the meeting. - **Meetings** — The meeting represents the actual meeting or video call conducted on the platform. - **Transcript Entries** — The transcript entries represent the list of sentences in the meeting transcript. - **Transcripts** — The transcript represents the written text of the spoken dialogue during the meeting. ### Unified Calendar API - **Availability** — Represents the availability of a person in a time period. - **Calendars** — Represents a calendar of a user. Can have multiple events associated with it. - **Contacts** — - **Events** — Events are the time-bound tasks that are associated with a calendar. ### Unified File Storage API - **Drive-Items** — Drive Items are the files and folders present in a file storage system. These items are usually part of a Drive. You can differentiate between files and folders using the type attribute. - **Drives** — Drives is a collection of files and folders. They could have multiple Drive Items within them. Users could have multiple Drives accessible to them in a file storage system. - **Permissions** — Permissions can answer your questions around which User has access to do what on a Drive Item or a Drive. - **Tags** — Represents the tags in a file storage system ### Unified Single Sign-On API - **App Users** — AppUsers represent the users assigned to an application. - **Apps** — Applications represent the applications that are registered with the SSO service. ### Unified Search API - **Search** — Search endpoint for all the apps. ## How it works 1. **Link your customer's Google account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Google.** The Proxy API is a 1-to-1 mapping of the Google API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Sync employee directories for automated provisioning** — SaaS companies building HR, IT management, or security products need to pull the full Google Workspace user directory to auto-populate employee lists, detect new hires, and trigger onboarding workflows — without asking every employee to authenticate individually. - **Read and send emails on behalf of users** — Sales engagement, CRM, and recruiting platforms need to send emails directly from a user's Gmail account for better deliverability and thread continuity, while also monitoring incoming replies to trigger automated sequences or log correspondence. - **Schedule meetings with calendar availability lookups** — Scheduling, ATS, and customer success tools need to read a user's Google Calendar availability, create events with Google Meet links, and keep both sides in sync — enabling features like candidate interview booking or customer meeting scheduling directly from the SaaS UI. - **Store and manage files in Google Drive programmatically** — Contract management, project management, and compliance SaaS products need to upload documents to Google Drive, organize them into shared drives, and set granular permissions — keeping Google Drive as the system of record without manual file shuffling. - **Enable Google SSO and workspace-level app management** — Security and identity platforms need to enumerate apps installed across a Google Workspace, audit user-to-app assignments, and enforce access policies — requiring deep integration with Google's SSO and admin APIs. ## What you can build - **One-click interview scheduling with Meet links** — Let recruiters check interviewer availability from Google Calendar, book a slot, and auto-generate a Google Meet link — all without leaving your product. - **Automated email sequence engine via Gmail** — Send personalized drip campaigns directly from a sales rep's Gmail account so emails land in their Sent folder and replies are tracked in real time. - **Company-wide employee directory sync** — Pull every user, group, and role from Google Workspace's directory to auto-populate your platform's org chart, permission model, or onboarding pipeline. - **Executed document auto-upload to Shared Drives** — When a contract or report is finalized in your app, automatically push the PDF to the correct Google Shared Drive with the right permissions already set. - **Unified search across Gmail, Drive, and Calendar** — Surface relevant emails, files, and events from a user's Google Workspace in a single search bar embedded in your product. - **Google Workspace SSO app audit dashboard** — Enumerate all third-party apps connected to a customer's Google Workspace and display user-to-app assignments for security review and compliance reporting. ## FAQs ### How does authentication work for Google integrations through Truto? Google uses OAuth 2.0 for user-level authentication. Truto handles the full OAuth flow — token acquisition, refresh, and scope management — so your users just click 'Connect Google' and you receive a managed credential. For admin-wide access (e.g., pulling the entire company directory), Google also supports service account delegation, which Truto can manage on your behalf. ### Which Google APIs map to Truto's Unified APIs? Google Calendar maps to the Unified Calendar API (Events, Calendars, Availability). Gmail maps to the Unified Emails API (Emails, Attachments, Folders). Google Drive maps to the Unified File Storage API (Drive-Items, Drives, Permissions). Google Admin Directory maps to the Unified User Directory API and Unified HRIS API (Users, Groups, Roles). Google Meet maps to the Unified Conferencing API (Meetings, Transcripts). Google SSO data maps to the Unified Single Sign-On API. ### How does Truto handle Google API rate limits? Google enforces per-user and per-project rate limits that vary by API (e.g., Gmail allows ~250 quota units per second per user). Truto manages rate limiting, automatic retries with exponential backoff, and pagination transparently so your application doesn't need to implement this logic directly. ### Can I read and write data, or is the integration read-only? Truto supports both read and write operations where the underlying Google API allows it. For example, you can create calendar events, send emails, upload files to Drive, and create users in the directory — all through the corresponding Unified APIs. ### What happens if specific tools I need aren't available yet? Google integration tools are built on request. If you need a specific endpoint or data model that isn't yet covered, Truto's team will build and ship it for you — typically with fast turnaround. You can also use Truto's proxy mode to call any Google API endpoint directly while still benefiting from Truto's auth and token management. ### How fresh is the data from Google APIs? Data freshness depends on your polling interval or webhook configuration. Google supports push notifications for several APIs (Calendar, Gmail, Drive), enabling near-real-time sync. Truto can orchestrate these webhooks so your application receives changes as they happen rather than relying solely on periodic polling. ## Related reading - [How to Integrate Google Drive, SharePoint, and Box: What It Really Takes](https://truto.one/blog/how-to-integrate-google-drive-sharepoint-and-box/) — Explore the engineering trade-offs of building Google Drive, SharePoint, and Box integrations versus using a Unified File Storage API. - [Our Google OAuth app is live and CASA Tier 2 certified](https://truto.one/blog/our-google-oauth-app-is-live-and-casa-tier-2-certified/) — Truto’s Google OAuth app is officially live and CASA Tier 2 certified. Securely connect Google Workspace apps like Gmail and Drive without your own verification.