GAPI-JZON

This is an API-breaking fork of Dmitry Kosenkov's Google API client for Common Lisp. You can find the original at https://github.com/Junker/gapi .

This fork exists to:

1. use COM.INUOE.JZON instead of Jonathan,
2. to provide DEFUN-GAPI,
3. for me to experiment.

Warning

This software is (the fork of a) still ALPHA quality codebase. The APIs will be likely to change.

Usage

GAPI-JZON allows you to:

(use-package :gapi-jzon)

(defun-gapi get-calendar-events
  (:GET "https://www.googleapis.com/calendar/v3/calendars/~A/events?timeMin=~A&timeMax=~A&orderBy=startTime&singleEvents=true"
        (&client calendario-id start end))) ; by default, we return the API's JZON parsed result

(defun-gapi delete-calendar
    (:DELETE "https://www.googleapis.com/calendar/v3/calendars/~A"
     (&client calendar-id)))

(defun-gapi list-calendars
    (:GET "https://www.googleapis.com/calendar/v3/users/me/calendarList"
     (&client))
  (princ (length response)) ; RESPONSE is lexically bound in the body
  response) ; when there's a body, its evaluation is the function's value.

(defparameter *client* (gapi-jzon:make-client-with-service-account
                                 #P"/home/myuser/service-account-key-file"
                                 :scopes '("https://www.googleapis.com/auth/calendar")))

(defparameter *calendar-id* "c_eda0999*********************************81ff@group.calendar.google.com")


(match (get-calendar-events *client* *calendar-id* 
                            "2025-01-01T00:00:00-04:00" "2025-02-01T00:00:00-04:00")
           ((jzon items
                  updated)
            (format t "~D items retrieved, last updated ~S~%" (length items) updated)))

DEFUN-GAPI introduces two lambda list keywords: &CLIENT and &PAYLOAD.

&CLIENT must be included in the lambda list, and marks where in the lambda list the GAPI-JZON:CLIENT must be passed as an argument.

&PAYLOAD is optional, and marks where in the lambda list the payload must be passed as an argument.

Dmitry Kosenkov's original API is also available, except it everything JSON is parsed and serialized by COM.INUOE.JZON and not by Jonathan.

Documentation

• Google APIs Explorer