Creazione e consultazione degli eventi del calendario
Google Calendar API: elenco degli eventi, creazione di riunioni e impostazione dei promemoria
Creazione e consultazione degli eventi del calendario è una lezione AI Agents gratuita su CoddyKit. Questa è la lezione 3 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento AI Agents, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso AI Agents include 4 lezioni in totale.
Panoramica dell'API Google Calendar
L'API Google Calendar consente agli agenti di leggere, creare, aggiornare ed eliminare gli eventi del calendario. Utilizza la stessa autenticazione Google OAuth di Gmail. La risorsa principale è l'oggetto Event e gli eventi appartengono a un Calendar. L'ID del calendario 'primary' fa riferimento al calendario principale dell'utente autenticato.
from googleapiclient.discovery import build
# Build calendar service (same credentials as Gmail)
calendar = build(
'calendar', 'v3',
credentials=creds,
cache_discovery=False
)
# Get a list of the user's calendars
cal_list = calendar.calendarList().list().execute()
for cal in cal_list.get('items', []):
print(f'{cal["summary"]}: {cal["id"]}')
# Primary calendar ID is the user's email addressElencare gli eventi imminenti
Utilizzi service.events().list() per recuperare gli eventi. I parametri timeMin e timeMax filtrano gli eventi in base all'intervallo di tempo. Utilizzi sempre stringhe datetime RFC 3339 con un offset del fuso orario. Imposti singleEvents=True per espandere gli eventi ricorrenti in singole istanze.
import datetime
import pytz
def get_upcoming_events(service, calendar_id='primary', max_results=10):
now = datetime.datetime.now(pytz.utc)
time_min = now.isoformat() # RFC 3339 format
time_max = (now + datetime.timedelta(days=7)).isoformat()
events_result = service.events().list(
calendarId=calendar_id,
timeMin=time_min,
timeMax=time_max,
maxResults=max_results,
singleEvents=True, # expand recurring events
orderBy='startTime'
).execute()
events = events_result.get('items', [])
for event in events:
start = event['start'].get('dateTime', event['start'].get('date'))
print(f'{start}: {event["summary"]}')
return eventsAnalizzare gli orari di inizio e fine degli eventi
Gli eventi del calendario hanno due tipi di orario: dateTime (orario specifico con fuso orario) per gli eventi normali e date (solo la data, senza orario) per gli eventi che durano tutto il giorno. Verifichi sempre quale campo è presente prima di analizzarlo.
from datetime import datetime
import re
def parse_event_time(time_dict):
if 'dateTime' in time_dict:
# Parse RFC 3339 datetime: '2026-05-29T14:00:00+03:00'
dt_str = time_dict['dateTime']
# Python 3.7+ fromisoformat handles this
return datetime.fromisoformat(dt_str), False # not all-day
else:
# All-day event: '2026-05-29'
date_str = time_dict['date']
return datetime.strptime(date_str, '%Y-%m-%d'), True # all-day
for event in events:
start_dt, is_all_day = parse_event_time(event['start'])
end_dt, _ = parse_event_time(event['end'])
duration = end_dt - start_dt if not is_all_day else None
print(f'{event["summary"]}: {start_dt.strftime("%H:%M")} '
f'({"all-day" if is_all_day else str(duration)})')Creare un evento semplice
Utilizzi service.events().insert() per creare un nuovo evento. I campi minimi obbligatori sono summary (titolo), start ed end. Gli orari devono essere nel formato RFC 3339 con il fuso orario. Il campo timeZone in start/end specifica il nome del fuso orario.
def create_event(service, title, start_datetime, end_datetime,
description='', timezone='UTC', calendar_id='primary'):
event = {
'summary': title,
'description': description,
'start': {
'dateTime': start_datetime.isoformat(),
'timeZone': timezone
},
'end': {
'dateTime': end_datetime.isoformat(),
'timeZone': timezone
}
}
created = service.events().insert(
calendarId=calendar_id,
body=event
).execute()
print(f'Event created: {created["summary"]}')
print(f'Event ID: {created["id"]}')
print(f'Link: {created["htmlLink"]}')
return created
# --- demo: minimal stand-in for the Calendar API's service object ---
import datetime
class _Exec:
def __init__(self, result):
self._result = result
def execute(self):
return self._result
class _FakeEvents:
def insert(self, calendarId, body):
return _Exec({**body, 'id': 'evt_123',
'htmlLink': 'https://calendar.google.com/event?eid=evt_123'})
class _FakeService:
def events(self):
return _FakeEvents()
service = _FakeService()
start = datetime.datetime(2026, 8, 10, 9, 0)
end = start + datetime.timedelta(hours=1)
create_event(service, 'Team Sync', start, end, description='Weekly sync')
Aggiungere partecipanti agli eventi
Aggiunga i partecipanti a un evento includendo un elenco attendees con gli indirizzi email. Imposti sendUpdates='all' per inviare automaticamente gli inviti di Google Calendar a tutti i partecipanti. Utilizzi 'externalOnly' per avvisare solo gli ospiti esterni.
import datetime
def schedule_meeting(service, title, start_iso, duration_minutes,
attendees, description=''):
start = datetime.datetime.fromisoformat(start_iso)
end = start + datetime.timedelta(minutes=duration_minutes)
event = {
'summary': title,
'description': description,
'start': {'dateTime': start.isoformat(), 'timeZone': 'UTC'},
'end': {'dateTime': end.isoformat(), 'timeZone': 'UTC'},
'attendees': [
{'email': email} for email in attendees
],
'conferenceData': {
'createRequest': {'requestId': f'meet-{start.timestamp()}'}
} # creates a Google Meet link
}
created = service.events().insert(
calendarId='primary',
body=event,
sendUpdates='all', # send invites
conferenceDataVersion=1 # enable Meet link creation
).execute()
return created
# --- demo: minimal stand-in for the Calendar API's service object ---
class _Exec:
def __init__(self, result):
self._result = result
def execute(self):
return self._result
class _FakeEvents:
def insert(self, calendarId, body, sendUpdates=None, conferenceDataVersion=None):
return _Exec({**body, 'id': 'evt_456'})
class _FakeService:
def events(self):
return _FakeEvents()
service = _FakeService()
created = schedule_meeting(
service, 'Sprint Planning', '2026-08-11T10:00:00', 30,
attendees=['alice@example.com', 'bob@example.com']
)
print(f'Meeting scheduled: {created["summary"]}')
print(f'Attendees: {[a["email"] for a in created["attendees"]]}')
Aggiungere promemoria agli eventi
Gli eventi possono avere dei promemoria — notifiche inviate prima dell'evento. Utilizzi 'popup' per le notifiche nel browser o nell'app e 'email' per i promemoria via email. Imposti useDefault: False per sostituire le impostazioni predefinite del calendario con tempistiche personalizzate.
def create_event_with_reminders(service, title, start_iso, end_iso):
event = {
'summary': title,
'start': {'dateTime': start_iso, 'timeZone': 'UTC'},
'end': {'dateTime': end_iso, 'timeZone': 'UTC'},
'reminders': {
'useDefault': False,
'overrides': [
{'method': 'email', 'minutes': 24 * 60}, # 1 day before
{'method': 'popup', 'minutes': 30}, # 30 min before
{'method': 'popup', 'minutes': 10} # 10 min before
]
}
}
return service.events().insert(
calendarId='primary',
body=event
).execute()
# --- demo: minimal stand-in for the Calendar API's service object ---
class _Exec:
def __init__(self, result):
self._result = result
def execute(self):
return self._result
class _FakeEvents:
def insert(self, calendarId, body):
return _Exec({**body, 'id': 'evt_789'})
class _FakeService:
def events(self):
return _FakeEvents()
service = _FakeService()
created = create_event_with_reminders(
service, 'Deploy Review', '2026-08-12T15:00:00', '2026-08-12T15:30:00'
)
print(f'Event id: {created["id"]}')
print('Reminders:', created['reminders']['overrides'])
Creare eventi ricorrenti
Gli eventi ricorrenti utilizzano una stringa RRULE (regola di ricorrenza), nello stesso formato di iCalendar RFC 5545. Alcune regole comuni sono: FREQ=WEEKLY;BYDAY=MO,WE,FR per lunedì, mercoledì e venerdì, e FREQ=MONTHLY;BYDAY=1MO per il primo lunedì di ogni mese.
def create_recurring_event(service, title, start_iso, end_iso,
rrule, timezone='UTC'):
event = {
'summary': title,
'start': {'dateTime': start_iso, 'timeZone': timezone},
'end': {'dateTime': end_iso, 'timeZone': timezone},
'recurrence': [
f'RRULE:{rrule}' # recurrence rule string
]
}
return service.events().insert(
calendarId='primary',
body=event
).execute()
# Weekly team standup every Monday at 9am for 30 min
create_recurring_event(
service=calendar_service,
title='Team Standup',
start_iso='2026-06-01T09:00:00',
end_iso='2026-06-01T09:30:00',
rrule='FREQ=WEEKLY;BYDAY=MO;COUNT=52', # 52 weeks
timezone='America/New_York'
)Aggiornare un evento esistente
Utilizzi service.events().patch() per aggiornare campi specifici di un evento esistente senza sostituire l'intero evento. Utilizzi .update() per sostituire l'intero corpo dell'evento. Entrambi i metodi richiedono l'ID dell'evento restituito dalla risposta originale di create o list.
def reschedule_event(service, event_id, new_start_iso, new_end_iso,
timezone='UTC', calendar_id='primary'):
updated_fields = {
'start': {'dateTime': new_start_iso, 'timeZone': timezone},
'end': {'dateTime': new_end_iso, 'timeZone': timezone}
}
updated_event = service.events().patch(
calendarId=calendar_id,
eventId=event_id,
body=updated_fields,
sendUpdates='all' # notify attendees of the change
).execute()
print(f'Event rescheduled: {updated_event["summary"]}')
print(f'New start: {updated_event["start"]["dateTime"]}')
return updated_event
# --- demo: minimal stand-in for the Calendar API's service object ---
class _Exec:
def __init__(self, result):
self._result = result
def execute(self):
return self._result
class _FakeEvents:
def patch(self, calendarId, eventId, body, sendUpdates=None):
return _Exec({'summary': 'Team Sync', 'id': eventId, **body})
class _FakeService:
def events(self):
return _FakeEvents()
service = _FakeService()
reschedule_event(service, 'evt_123', '2026-08-13T09:00:00', '2026-08-13T10:00:00')
Eliminare gli eventi
Utilizzi service.events().delete() per annullare e rimuovere un evento. Impostando sendUpdates='all', i partecipanti ricevono una notifica. Per gli eventi ricorrenti, può eliminare una singola istanza oppure l'intera serie, a seconda dell'ID dell'evento utilizzato.
from googleapiclient.errors import HttpError
def cancel_event(service, event_id, notify_attendees=True,
calendar_id='primary'):
try:
service.events().delete(
calendarId=calendar_id,
eventId=event_id,
sendUpdates='all' if notify_attendees else 'none'
).execute()
print(f'Event {event_id} cancelled')
return True
except HttpError as e:
if e.resp.status == 404:
print(f'Event {event_id} not found (already deleted?)')
elif e.resp.status == 403:
print('No permission to delete this event')
else:
print(f'Delete failed: {e.resp.status}')
return FalseVerificare la disponibilità free/busy
Prima di pianificare una riunione, verifichi la disponibilità dei partecipanti utilizzando l'API freebusy. L'API restituisce i blocchi di tempo occupati per un elenco di calendari in una determinata finestra temporale: è perfetta per trovare fasce libere per gli agenti che pianificano appuntamenti.
import datetime
import pytz
def check_availability(service, attendees, duration_hours=1):
now = datetime.datetime.now(pytz.utc)
time_min = now.isoformat()
time_max = (now + datetime.timedelta(days=5)).isoformat()
body = {
'timeMin': time_min,
'timeMax': time_max,
'timeZone': 'UTC',
'items': [{'id': email} for email in attendees]
}
result = service.freebusy().query(body=body).execute()
for email in attendees:
busy_slots = result['calendars'].get(email, {}).get('busy', [])
print(f'{email}: {len(busy_slots)} busy slots in next 5 days')
for slot in busy_slots[:3]:
print(f' Busy: {slot["start"]} -> {slot["end"]}')
return resultCercare gli eventi per query
Utilizzi il parametro q in events().list() per cercare gli eventi in base al testo: la ricerca comprende titolo, descrizione, luogo e nomi dei partecipanti. Combini questo parametro con timeMin/timeMax per limitare i risultati a un periodo specifico.
def search_events(service, query, days_back=30, days_forward=30,
calendar_id='primary'):
import datetime, pytz
now = datetime.datetime.now(pytz.utc)
result = service.events().list(
calendarId=calendar_id,
q=query,
timeMin=(now - datetime.timedelta(days=days_back)).isoformat(),
timeMax=(now + datetime.timedelta(days=days_forward)).isoformat(),
singleEvents=True,
orderBy='startTime',
maxResults=50
).execute()
events = result.get('items', [])
print(f'Found {len(events)} events matching "{query}"')
for event in events:
start = event['start'].get('dateTime', event['start'].get('date'))
print(f' {start}: {event["summary"]}')
return eventsVerifica rapida: parametro singleEvents
Verifichi la Sua comprensione dell'API Calendar.
Riepilogo dell'API Calendar
Ora i Suoi agenti possono gestire Google Calendar a livello programmatico:
- Elencare gli eventi:
events().list(timeMin=now, singleEvents=True, orderBy='startTime') - Creare gli eventi:
events().insert(body={summary, start, end, attendees}) - Eventi ricorrenti: aggiungere
recurrence: ['RRULE:FREQ=WEEKLY;BYDAY=MO'] - Promemoria: utilizzare
reminders.overridesconmethod: popup/emaileminutes - Aggiornare: utilizzare
events().patch()per aggiornamenti parziali; impostaresendUpdates='all'per avvisare i partecipanti - Disponibilità free/busy: utilizzare
freebusy().query()per verificare la disponibilità prima di pianificare un appuntamento
Domande Frequenti
La lezione «Creazione e consultazione degli eventi del calendario» è gratuita?
Sì — il testo completo di «Creazione e consultazione degli eventi del calendario» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso AI Agents, passa a CoddyKit PRO. Il corso AI Agents include 4 lezioni in totale.
Cosa imparerò in «Creazione e consultazione degli eventi del calendario»?
Google Calendar API: elenco degli eventi, creazione di riunioni e impostazione dei promemoria Eserciti AI Agents con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare AI Agents?
Non è richiesta alcuna esperienza precedente. AI Agents su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.
Quanto tempo richiede la lezione «Creazione e consultazione degli eventi del calendario»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione AI Agents?
Sì. Ogni lezione AI Agents include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Connessione a Gmail tramite API
- Lettura e invio programmatico delle email
- Creazione e consultazione degli eventi del calendario
- Creazione di un semplice agente assistente email