This repository serves as a comprehensive guide for leveraging Google Apps Script (GAS) Web Apps, targeting developers and power users who need to create web services, APIs, or webhooks integrated with Google Workspace. It details how to transform GAS functions into accessible web endpoints, enabling seamless interaction between Google Workspace data and external applications or users, thereby offering a cost-effective and rapid development solution without complex server management.

How It Works

GAS Web Apps expose script functions (like doGet and doPost) as HTTP endpoints. The repository explains the deployment process, including configuration for execution context ("Execute as") and access permissions ("Who has access"). It meticulously details how requests are handled, including the crucial redirect process for POST requests and the role of access tokens and scope authorization for secure access. The event object passed to doGet and doPost is thoroughly analyzed, providing insights into request parameters, headers, and body content.

Quick Start & Requirements

• Installation: No explicit installation is required beyond having a Google account and access to the Google Apps Script editor.
• Prerequisites: A Google account and a Google Apps Script project.
• Setup: Deployment involves using the Apps Script editor's "Deploy" > "New deployment" feature. The setup time is minimal, depending on script complexity.
• Resources: Official documentation links are provided throughout the README for detailed guidance.

Highlighted Details

• Explains five distinct deployment situations, detailing access control and execution contexts for owners and client users.
• Provides methods to redeploy Web Apps without changing the URL, ensuring endpoint stability.
• Includes extensive code examples in JavaScript, cURL, Python, Go, Node.js, and PowerShell for interacting with Web Apps.
• Covers advanced topics like CORS handling, logging, performance limitations (simultaneous connections), and implementing pseudo 2FA.

Maintenance & Community

The repository is actively maintained by Tanaike, with regular updates noted up to June 2025. The author's GitHub profile and linked Gists suggest a dedicated contributor to the Google Apps Script ecosystem.

Licensing & Compatibility

The repository itself is not licensed, but the code examples provided are generally permissive, often resembling MIT or BSD styles, allowing for broad use and integration. Compatibility is high for any environment capable of making HTTP requests.

Limitations & Caveats

While powerful, GAS Web Apps have limitations, including quotas on execution time and concurrent requests (around 30 simultaneous connections). Debugging can be challenging, with logs sometimes requiring specific configurations (like linking a GCP project) or access tokens. Certain operations, like direct file uploads via POST, require careful handling of content types and parsing.