How to Create Calendar Events with Google Calendar API in Python

Install Required Libraries

• Ensure you have Python installed on your machine. Use pip to install the Google client library for Python. Execute the following command in your terminal or command prompt:

 

pip install --upgrade google-api-python-client google-auth-httplib2 google-auth-oauthlib

Authenticate and Authorize APIs

• Download the `credentials.json` file for OAuth 2.0 from Google Cloud Console after enabling the Google Calendar API.

 

• Use the following code to authenticate and authorize access:

 

from __future__ import print_function

import os.path
import datetime

from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from google.auth.transport.requests import Request

SCOPES = ['https://www.googleapis.com/auth/calendar']

def authenticate_google():
    creds = None
    if os.path.exists('token.json'):
        creds = Credentials.from_authorized_user_file('token.json', SCOPES)
    
    if not creds or not creds.valid:
        if creds and creds.expired and creds.refresh_token:
            creds.refresh(Request())
        else:
            flow = InstalledAppFlow.from_client_secrets_file('credentials.json', SCOPES)
            creds = flow.run_local_server(port=0)
        
        with open('token.json', 'w') as token:
            token.write(creds.to_json())
    return creds

Creating Calendar Events

• After successfully authenticating, you can now use Google's API to create events. Here is a code snippet to illustrate how to create a calendar event:

 

from googleapiclient.discovery import build

def create_event():
    creds = authenticate_google()
    service = build('calendar', 'v3', credentials=creds)
    
    event = {
        'summary': 'Sample Event',
        'location': '1234 Test St, Test City, Test State',
        'description': 'A chance to hear more about our APIs.',
        'start': {
            'dateTime': '2023-10-08T09:00:00-07:00',
            'timeZone': 'America/Los_Angeles',
        },
        'end': {
            'dateTime': '2023-10-08T17:00:00-07:00',
            'timeZone': 'America/Los_Angeles',
        },
        'recurrence': [
            'RRULE:FREQ=DAILY;COUNT=2'
        ],
        'attendees': [
            {'email': 'lpage@example.com'},
            {'email': 'sbrin@example.com'},
        ],
        'reminders': {
            'useDefault': False,
            'overrides': [
                {'method': 'email', 'minutes': 24 * 60},
                {'method': 'popup', 'minutes': 10},
            ],
        },
    }

    event = service.events().insert(calendarId='primary', body=event).execute()
    print('Event created: %s' % (event.get('htmlLink')))

Customizing Events

• Modify the `event` dictionary to customize aspects such as the summary, location, start and end times, recurrence patterns, and reminders.

 

• Refer to the official Google Calendar API documentation for more details on event object properties.

Handling Errors and Debugging

• Utilize try-except blocks around API calls to handle errors gracefully, and use logging for debugging purposes.

 

• Ensure the API response is properly checked for successful operations, and handle various exceptions such as HTTP errors or invalid credentials.

Enhancing Functionality

• Explore additional API capabilities such as updating, deleting, or listing events, which can be implemented similarly utilizing the `service` object.

 

• Incorporate user input or data from other sources to dynamically populate event details rather than hard-coding values.