Google Apps Scripts
for Workspace Administration

Production-ready scripts to audit inactive users and manage group ownership in Google Workspace. Built for enterprise-scale organizations with 50,000+ users and 5,000+ groups.

4
Ready Scripts
50K+
Users Supported
100%
Open Source
Explore Scripts Setup Guide

Available Scripts

👥

Inactive Users Audit (180 Days - Auto)

Automatically audits users with specific licenses who haven't logged in for 180 days. Includes monthly trigger setup.

View Script →
📊

Inactive Users Audit (180 Days - Manual)

Manual execution version of the 180-day audit. Perfect for on-demand reporting and testing.

View Script →
📅

Inactive Users Audit (365 Days)

Annual audit for users inactive for a full year. Ideal for license reclamation and compliance.

View Script →
🔐

Groups Audit - Batch Processing

Enterprise-scale batch processor for auditing groups without owners or managers. Handles 5,000+ groups efficiently.

View Script →

Inactive Users Audit Scripts

These scripts use a hybrid approach combining the Admin Reports API and Directory API to accurately identify inactive users with specific Google Workspace licenses. Perfect for license optimization and compliance reporting.

Inactive Users Audit - 180 Days (Auto Run)

Automated Reports API Email Alerts

Purpose: Automatically audits users with a specific license (e.g., Enterprise Plus) who have been inactive for 180 days.

Features:

  • ✅ Hybrid approach using Reports API + Directory API for accurate login tracking
  • ✅ Automatic monthly trigger setup (runs every 30 days)
  • ✅ Email notifications with formatted HTML reports
  • ✅ Generates Google Sheet with detailed user information
  • ✅ Supports 50,000+ users with optimized API calls
Inactive users 180 days - Auto Run.js 
// View full code in the download section below
⬇️ Download Full Script

Inactive Users Audit - 180 Days (Manual)

Manual Reports API Email Alerts

Purpose: Same functionality as the auto version but designed for manual, on-demand execution.

Use Cases:

  • 🔍 Testing and validation before automation
  • 📊 Ad-hoc reporting for management
  • 🎯 Quarterly or custom-schedule audits
Inactive users 180 days - With Email.js 
// View full code in the download section below
⬇️ Download Full Script

Inactive Users Audit - 365 Days

Manual Reports API Email Alerts

Purpose: Audits users with a specific license who have been inactive for a full year (365 days).

Ideal For:

  • 💰 License reclamation and cost optimization
  • 📋 Annual compliance reporting
  • 🔒 Security audits for dormant accounts
Inactive users 365 days - With Email.js 
// View full code in the download section below
⬇️ Download Full Script

Groups Audit - Batch Processing

Enterprise-scale solution for auditing Google Workspace groups without proper ownership. Designed specifically for organizations with 5,000+ groups using intelligent batch processing.

Groups Audit - Batch Processing for 5,000+ Groups

Batch Processing Auto Resume Enterprise

Purpose: Identifies Google Workspace groups missing OWNERS and/or MANAGERS with automatic progress tracking.

Key Features:

  • ⚡ Processes 500 groups per batch (configurable)
  • 💾 Automatic progress saving between runs
  • 🔄 Auto-resume capability - picks up where it left off
  • ⏰ Optional automatic trigger (runs every 10 minutes)
  • 🛡️ Timeout protection with smart checkpointing
  • 📊 Comprehensive final report with statistics

Processing Options:

Manual Batch Processing

Run auditGroupsWithoutOwners() multiple times. Each run processes 500 groups and saves progress automatically.

Automatic Batch Processing

Run createAutoBatchTrigger() once. The script runs every 10 minutes until complete, then stops automatically.

Groups Audit - Batch Processing.js 
// View full code in the download section below
⬇️ Download Full Script

📖 Batch Processing Guide

Quick Start - Manual Processing
  1. Run auditGroupsWithoutOwners() - processes first 500 groups
  2. Run again to process next 500 groups
  3. Repeat until complete - progress is saved automatically
Quick Start - Automatic Processing
  1. Run createAutoBatchTrigger() once
  2. Script runs automatically every 10 minutes
  3. Stops automatically when complete
  4. To stop early: deleteAutoBatchTrigger()
Available Functions
Function Purpose
auditGroupsWithoutOwners() Start or continue the audit
checkAuditProgress() View current progress without processing
resetAudit() Clear all progress and start fresh
createAutoBatchTrigger() Set up automatic processing every 10 minutes
deleteAutoBatchTrigger() Stop automatic processing
Time Estimates
5,000 Groups

Manual: ~50 minutes (10 runs)

Automatic: ~1.75 hours hands-off

10,000 Groups

Manual: ~100 minutes (20 runs)

Automatic: ~3.5 hours hands-off

Setup & Configuration Guide

1

Prerequisites

  • Google Workspace Super Admin account
  • Access to Google Apps Script
  • Admin SDK API enabled
  • Admin Reports API enabled (for inactive users scripts)
  • Admin License Manager API enabled (for inactive users scripts)
2

Enable Required APIs

  1. Open your Apps Script project
  2. Click on "Services" (+ icon on left sidebar)
  3. Add "Admin SDK API"
  4. Add "Admin Reports API" (for inactive users)
  5. Add "Admin License Manager API" (for inactive users)
3

Configure Scripts

Update the CONFIG object in each script:

const CONFIG = {
    TARGET_SKU_ID: '1010020020',  // Your license SKU
    EMAIL_RECIPIENTS: 'admin@example.com',
    SEND_EMAIL: true,
    INACTIVITY_DAYS: 180  // or 365
};
4

Run & Authorize

  1. Select the main function (e.g., auditInactiveEnterpriseUsers)
  2. Click "Run"
  3. Authorize the script when prompted
  4. Grant necessary permissions
  5. Check execution logs for results

⚠️ Important Notes

  • Super Admin Required: These scripts must be run with a Super Admin account to access all APIs
  • Reports API Limitation: The Reports API only keeps 180 days of login data. For 365-day audits, the script falls back to Directory API data
  • API Quotas: Scripts are optimized to stay within Google's API quota limits, but very large organizations may need to adjust batch sizes
  • Testing: Always test with manual versions before setting up automatic triggers