# Google Calendar

Attify reads Google Calendar through its API, read-only, with OAuth or an API token, for sales meetings and bookings. It is the customer's own system, so what Attify reads there is connected data: the strongest provenance, and what a vendor verification rests on.

## As a crm or calendar, for sales meetings and bookings

| Item             | Google                                                                    |
|------------------|---------------------------------------------------------------------------|
| id               | event `id` (an occurrence's own id, `<series id>_<time>`)                 |
| started_at       | `created`                                                                 |
| updated_at       | `updated`                                                                 |
| start, end       | `start` / `end`: `dateTime`, or an all-day `date` at midnight UTC         |
| original_start   | `originalStartTime`, for an occurrence of a recurring event               |
| status           | cancelled: `status` cancelled; pending: tentative; booked otherwise       |
| cancelled_at     | `updated` of a cancelled event (its last change, the cancellation)        |
| cancelled_by     | "unknown": Google does not record who cancelled                           |
| created_by       | app: the event has a `source`, a private extended property, or a          |
|                  | `...gserviceaccount.com` creator; user: otherwise, id the creator's email |
| ai               | null: Google does not say                                                 |
| organizer        | `organizer.email`                                                         |
| attendees        | `attendees[]` (rooms left out): needsAction reads as "none"               |
| attendance       | none: the calendar does not record it                                     |
| title, location  | `summary`, `location`                                                     |
| links            | `ical:<iCalUID>` (shared by a series' occurrences), `google:<id>`         |
