Google Workspace Sentiment Analyzer

Analyze sentiment across Google Workspace: Gmail, Calendar, Chat, and Docs. Get company health scores, client relationship insights, and team burnout indicators.

BYOK (Bring Your Own Key) -- you provide your own API credentials.

---

Before You Start

This actor requires your own API credentials to fetch real data.

Where to get your key: OAuth 2.0 access token with Gmail, Calendar, and Drive scopes

You can test with Demo Mode first (free, no key needed) to see the output format before committing.

---

Quick Start

Test with Demo Mode (free, no API key needed)

{
  "demoMode": true,
  "clientId": "",
  "companyDomain": "",
  "dateRange": "last_7_days",
  "dataSources": [
    "gmail",
    "calendar"
  ],
  "includeClientSegments": true,
  "includeBurnoutIndicators": true
}

Run with real data

{
  "demoMode": false,
  "accessToken": "YOUR_API_KEY_HERE",
  "refreshToken": "YOUR_API_KEY_HERE",
  "clientId": "",
  "clientSecret": "YOUR_API_KEY_HERE",
  "companyDomain": "",
  "dateRange": "last_7_days",
  "dataSources": [
    "gmail",
    "calendar"
  ],
  "includeClientSegments": true,
  "includeBurnoutIndicators": true
}

---

Input Parameters

Parameter	Type	Default	Required	Description
demoMode	boolean	-	No	When enabled, returns sample Workspace sentiment data without requiring Google OAuth. Useful for testing.
accessToken	string	-	Yes*	OAuth 2.0 access token with Gmail, Calendar, and Drive scopes
refreshToken	string	-	Yes*	OAuth 2.0 refresh token for automatic token refresh
clientId	string	-	No	Your Google Cloud OAuth client ID
clientSecret	string	-	Yes*	Your Google Cloud OAuth client secret
companyDomain	string	-	No	Your company's email domain (e.g., 'acme.com') for internal/external classification
dateRange	string	-	No	Time period to analyze
dataSources	array	-	No	Which Workspace apps to include in analysis
includeClientSegments	boolean	-	No	Break down sentiment by external client domain
includeBurnoutIndicators	boolean	-	No	Analyze after-hours activity and communication patterns for burnout risk

*Required when Demo Mode is off.

---

Pricing

This actor uses pay-per-event billing:

Event	Description	Price
Analysis Completed	Each workspace sentiment analysis completed	$0.05

Demo mode is free -- no charges for sample data.

---

Troubleshooting

"API key is required"

You have Demo Mode turned off but didn't provide an API key. Either:

• Turn Demo Mode on to test with sample data
• Add your API key in the input

"API error 403" or "Unauthorized"

Your API key is invalid, expired, or doesn't have access to this specific API endpoint. Double-check your key and account permissions.

"API error 429" or "Rate limit"

Too many requests. Wait a minute and try again, or reduce the number of items per run.

No results or empty dataset

Check the run log for error messages. Common causes:

• Invalid input format (check the examples above)
• API key without proper permissions
• The target data doesn't exist or is too small to track

How do I test without an API key?

Enable Demo Mode in the input. This returns realistic sample data so you can verify the output format works for your workflow.

---

Built by John Rippy | Actor Arsenal