How to Automate Google Calendar Scheduling using the API

1#!/usr/bin/env python3
2"""Google Calendar Scheduling Automation — availability check + event creation."""
3import os
4import uuid
5import logging
6from datetime import datetime, timedelta
7from googleapiclient.discovery import build
8from google.oauth2.credentials import Credentials
9from google_auth_oauthlib.flow import InstalledAppFlow
10from google.auth.transport.requests import Request
11import pytz
12
13logging.basicConfig(level=logging.INFO)
14log = logging.getLogger(__name__)
15
16SCOPES = ['https://www.googleapis.com/auth/calendar.events']
17
18def get_service():
19    creds = None
20    if os.path.exists('token.json'):
21        creds = Credentials.from_authorized_user_file('token.json', SCOPES)
22    if not creds or not creds.valid:
23        if creds and creds.expired and creds.refresh_token:
24            creds.refresh(Request())
25        else:
26            flow = InstalledAppFlow.from_client_secrets_file('credentials.json', SCOPES)
27            creds = flow.run_local_server(port=0)
28        with open('token.json', 'w') as f: f.write(creds.to_json())
29    return build('calendar', 'v3', credentials=creds)
30
31def check_availability(service, start_dt, end_dt, calendar_id='primary'):
32    result = service.events().list(
33        calendarId=calendar_id,
34        timeMin=start_dt.isoformat(),
35        timeMax=end_dt.isoformat(),
36        singleEvents=True
37    ).execute()
38    return len([e for e in result.get('items', []) if e.get('status') != 'cancelled']) == 0
39
40def create_booking(service, title, attendee_emails, start_dt, duration_min=30,
41                   timezone='America/New_York', calendar_id='primary'):
42    tz = pytz.timezone(timezone)
43    if start_dt.tzinfo is None:
44        start_dt = tz.localize(start_dt)
45    end_dt = start_dt + timedelta(minutes=duration_min)
46
47    if not check_availability(service, start_dt, end_dt, calendar_id):
48        raise ValueError(f'Time slot unavailable: {start_dt}')
49
50    event = {
51        'summary': title,
52        'start': {'dateTime': start_dt.isoformat(), 'timeZone': timezone},
53        'end':   {'dateTime': end_dt.isoformat(),   'timeZone': timezone},
54        'attendees': [{'email': e} for e in attendee_emails],
55        'conferenceData': {'createRequest': {
56            'requestId': str(uuid.uuid4()),
57            'conferenceSolutionKey': {'type': 'hangoutsMeet'}
58        }},
59        'reminders': {'useDefault': False, 'overrides': [
60            {'method': 'email', 'minutes': 1440},
61            {'method': 'popup', 'minutes': 10}
62        ]}
63    }
64    result = service.events().insert(
65        calendarId=calendar_id, body=event,
66        conferenceDataVersion=1, sendUpdates='all'
67    ).execute()
68    meet_link = next(
69        (e['uri'] for e in result.get('conferenceData', {}).get('entryPoints', [])
70         if e['entryPointType'] == 'video'), None
71    )
72    log.info(f'Booked: {title} | Meet: {meet_link}')
73    return {'id': result['id'], 'meet_link': meet_link, 'html_link': result['htmlLink']}
74
75if __name__ == '__main__':
76    service = get_service()
77    booking = create_booking(
78        service,
79        title='Discovery Call - RapidDev Demo',
80        attendee_emails=['prospect@example.com'],
81        start_dt=datetime(2025, 5, 20, 14, 0),
82        duration_min=30,
83        timezone='America/Chicago'
84    )
85    print(f'Meeting scheduled: {booking["html_link"]}')
86    print(f'Join: {booking["meet_link"]}')