Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/muzafferkadir/google-oauth-token-generator

Generate Google OAuth access tokens for testing or development...
https://github.com/muzafferkadir/google-oauth-token-generator

google google-api google-apps-script google-maps-api google-sheets

Last synced: 1 day ago
JSON representation

Generate Google OAuth access tokens for testing or development...

Awesome Lists containing this project

README

        

# Google OAuth Token Generator

A simple web-based tool to generate Google OAuth access tokens. This tool helps developers quickly obtain OAuth tokens for testing and development purposes.

## Installation

```bash
# Run directly with npx
npx google-oauth-token-generator

# Or install globally
npm install -g google-oauth-token-generator
google-oauth-token-generator
```

## Features

- Simple web interface
- Automatic browser opening
- Copy-to-clipboard functionality
- Token information display
- Support for all Google API scopes
- Real-time token validation
- Configurable port number

## Usage

1. Run the command:
```bash
# Using default port (2323)
npx google-oauth-token-generator

# Using custom port
npx google-oauth-token-generator --port=3000
```

2. The tool will:
- Start a local server (default port: 2323)
- Open your default browser automatically
- Display the setup instructions

3. Follow the on-screen instructions to:
- Set up your Google Cloud Project
- Configure OAuth consent screen:
- Set User Type as "External"
- Set Publishing Status to "In Production"
- Fill in required app information
- Create credentials
- Generate your token

## Port Configuration

- Default port: 2323
- To use a different port: `--port=`
- Valid port range: 0-65535
- Example: `npx google-oauth-token-generator --port=3000`

## OAuth Configuration Requirements

1. **Publishing Status**: Your application must be set to "In Production" in the OAuth consent screen
- Go to Google Cloud Console → APIs & Services → OAuth consent screen
- Under "Publishing status", select "In Production"
- This is required for public access to your application

2. **User Type**: Must be set to "External"
- This allows any Google account to authenticate
- Internal user type is only for Google Workspace users

3. **Required Information**:
- Application name
- User support email
- Application home page
- Authorized domains (if needed)
- Developer contact information

## Common Scopes

- `https://www.googleapis.com/auth/userinfo.profile` - User profile information
- `https://www.googleapis.com/auth/userinfo.email` - User email information
- `https://www.googleapis.com/auth/calendar` - Google Calendar access
- `https://www.googleapis.com/auth/drive` - Full Google Drive access
- `https://www.googleapis.com/auth/gmail.readonly` - Gmail read-only access

For a complete list of available scopes, visit [Google OAuth 2.0 Scopes](https://developers.google.com/identity/protocols/oauth2/scopes).

## Important Notes

- The application must be run on a web server (localhost is fine for development)
- You need to configure your Google Cloud Console project properly
- Some scopes may require verification from Google
- Always handle tokens securely and never expose them in client-side code
- Your application must be in "Production" status, not "Testing"
- Verification may be required for certain sensitive scopes

## License

MIT

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.