Google Form Generator

A Next.js application that allows users to generate Google Forms programmatically using OAuth 2.0 authentication.

Prerequisites

Before you begin, you need to:

1. Have a Google Account
2. Set up a Google Cloud Project
3. Have an OpenAI API key

Initial Setup

1. Google Cloud Project Setup

1. Go to Google Cloud Console
2. Create a new project or select an existing one
3. Enable the Google Forms API:
   • Go to "APIs & Services" > "Library"
   • Search for "Google Forms API"
   • Click "Enable"

2. OAuth 2.0 Credentials Setup

1. In Google Cloud Console:

   • Go to "APIs & Services" > "Credentials"
   • Click "Create Credentials" > "OAuth client ID"
   • Select "Web application"

2. Configure OAuth consent screen:

   • Go to "OAuth consent screen"
   • Choose "External" user type
   • Fill in required app information
   • Add scopes:
     • https://www.googleapis.com/auth/forms.body
     • https://www.googleapis.com/auth/forms.responses.readonly

3. Configure authorized redirect URIs:

   • Add: http://localhost:3000/auth/callback (for development)
   • Add your production URL if deploying

4. After creating, you'll receive:

   • Client ID
   • Client Secret

3. Local Environment Setup

1. Clone the repository:

git clone https://github.com/yourusername/google-form-generator.git
cd google-form-generator

2. Install dependencies:

npm install
# or
yarn install

3. Create a .env.local file in the root directory:

GOOGLE_CLIENT_ID=your_client_id_here
GOOGLE_CLIENT_SECRET=your_client_secret_here
GOOGLE_REDIRECT_URI=http://localhost:3000/auth/callback
NEXT_PUBLIC_API_URL=http://localhost:3000/api
OPENAI_API_KEY=your_openai_api_key_here

4. Start the development server:

npm run dev
# or
yarn dev

Usage

1. Visit http://localhost:3000
2. Click "Sign in with Google"
3. Authorize the application
4. Enter your form details:
   • Title
   • Description/Questions (one per line)
   • The AI will automatically detect question types:
     • Multiple choice questions with options will be RADIO type
     • Rating questions will be SCALE type (1-5)
     • Questions asking for explanations will be PARAGRAPH type
     • Questions with multiple possible answers will be CHECKBOX type
     • Simple short answers will be TEXT type
5. Click "Generate Form"
6. Use the generated form URL to access your new Google Form

Features

• OAuth 2.0 authentication with Google
• Automatic form generation
• AI-powered question type detection using OpenAI
• Support for multiple question types (text, paragraph, radio, checkbox, scale)
• Direct integration with user's Google account
• Forms appear in user's Google Drive

Development Notes

• The application uses the Google Forms API v1
• Forms are created under the authenticated user's account
• Questions are intelligently parsed using OpenAI's GPT model
• Supports various question types based on context and phrasing

Troubleshooting

1. If authentication fails:

   • The application will automatically attempt to refresh expired tokens
   • If token refresh fails, you will be redirected to login again
   • Verify your OAuth credentials and consent screen configuration
   • Check that redirect URIs are correctly configured
   • Ensure all required scopes are added to the consent screen

2. If form creation fails:

   • Verify the Google Forms API is enabled
   • Check the user has granted necessary permissions
   • Review API quotas in Google Cloud Console

3. If AI parsing fails:

   • Verify your OpenAI API key is correct
   • Check the API key has sufficient credits
   • Ensure the API key has the necessary permissions

Security Notes

• OAuth tokens are stored in localStorage (consider more secure alternatives for production)
• Always use HTTPS in production
• Keep your Google Cloud credentials secure
• Protect your OpenAI API key and never expose it client-side