Google Calendar HTTP connector specifications

Deploy the Google Calendar integrations to schedule Calendar events and List events and office hours of a user from any device or intranet.

Version Details

These API’s are used for Google Calendar integration.

`https://www.googleapis.com/calendar/v3/`
`https://www.googleapis.com/admin/directory/v1/`

Endpoints

POST

`https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&prompt=consent`
`https://oauth2.googleapis.com/token`
`https://www.googleapis.com/calendar/v3/calendars/\{\{calendarId\}\}/events`
`https://www.googleapis.com/calendar/v3/calendars/\{\{calendarId\}\}/events/\{\{eventId\}\}`

GET

`https://www.googleapis.com/admin/directory/v1/users`
`https://www.googleapis.com/calendar/v3/calendars/\{\{calendarId\}\}/events`

Note:

Ensure the maxResults parameter is updated with Page size value-500 of Pagination type “Cursor” for “Users” Endpoint.

Service Actions

  • Refresh - Used to for Refresh List of the upcoming Meetings/events.
  • Create Meeting - Schedule a Meeting with these details: Meeting Title, Google Meet Video link, Start and End Time, Time Zone, Recurrence(One Time, Daily, Weekly, Monthly), Meeting Attendees
  • EditAttendee - Edit a Meeting with these details: Meeting Title, Meeting Attendees
  • EditTime - Edit a Meeting with these details: Meeting Title, Start and End Time, Time Zone
  • EditRecurrence - Edit a Meeting with these details: Meeting Title, Start and End Time, Time Zone, Recurrence(One Time, Daily, Weekly, Monthly)
  • Edit Event - Edit a Meeting with these details: Meeting Title, Start and End Time, Time Zone, Recurrence(One Time, Daily, Weekly, Monthly), Meeting Attendees
  • Save This Occ - Edit a Meeting with these details: Meeting Title, Start and End Time, Time Zone, Recurrence(One Time, Daily, Weekly, Monthly), Meeting Attendees
  • Save all occurrence - Edit Meeting instances with these details: Meeting Title, Start and End Time, Time Zone, Recurrence(One Time, Daily, Weekly, Monthly), Meeting Attendees

For Create Meeting service action ensure the conferenceData parameter is listed/updated as below:

"conferenceData": {
    "createRequest": {
        "requestId": "AIzaSyAJV0pH9dpVwdNZeLajIGsIpjcPu3tVgAE"
    }
}

Note:

Refresh is used to sync cache with the most recent data, in lieu of full/incremental synchronization as the Users Endpoint doesn’t support incremental synchronization.

Key Entities

The following are the main business entities that this connector addresses:

  • users_users
  • users_users_emails
  • users_users_non_editable_aliases
  • events
  • events_attachments
  • events_attendees
  • events_conference_data_entry_points
  • events_recurrence

Entities with Attributes

The following is a full list of entities and their attributes:

users_users

  • agreed_to_terms: BOOLEAN
  • archived: BOOLEAN
  • change_password_at_next_l: BOOLEAN
  • creation_time: TIMESTAMP
  • customer_id: STRING(255)
  • etag: STRING(255)
  • gender_type: STRING(255)
  • id: DOUBLE
  • include_in_global_address: BOOLEAN
  • ip_whitelisted: BOOLEAN
  • is_admin: BOOLEAN
  • is_delegated_admin: BOOLEAN
  • is_enforced_in_2_sv: BOOLEAN
  • is_enrolled_in_2_sv: BOOLEAN
  • is_mailbox_setup: BOOLEAN
  • kind: STRING(255)
  • last_login_time: TIMESTAMP
  • name_family_name: STRING(255)
  • name_full_name: STRING(255)
  • name_given_name: STRING(255)
  • org_unit_path: STRING(255)
  • primary_email: STRING(255)
  • recovery_email: STRING(255)
  • recovery_phone: LONG
  • suspended: BOOLEAN
  • suspension_reason: STRING(255)
  • thumbnail_photo_etag: STRING(255)
  • thumbnail_photo_url: STRING(255)
  • parent_kind: STRING(255), FK(users.kind)
  • unique_id: STRING(36)
  • root_kind: STRING(255)

users_users_emails

  • address: STRING(255)
  • primary: BOOLEAN

users_users_non_editable_aliases

  • value: STRING(255)

events

  • conference_data_conference_id: STRING(255)
  • conference_data_conference_solution_icon_uri: STRING(255)
  • conference_data_conference_solution_key_type: STRING(255)
  • conference_data_conference_solution_name: STRING(255)
  • conference_data_signature: STRING(255)
  • created: TIMESTAMP
  • creator_display_name: STRING(255)
  • creator_email: STRING(255)
  • creator_self: BOOLEAN
  • description: STRING(255)
  • end_date: TIMESTAMP
  • end_date_time: TIMESTAMP
  • end_time_zone: STRING(255)
  • etag: STRING(255)
  • guests_can_invite_others: BOOLEAN
  • guests_can_modify: BOOLEAN
  • guests_can_see_other_guests: BOOLEAN
  • hangout_link: STRING(255)
  • html_link: STRING(255)
  • i_cal_uid: STRING(255)
  • id: STRING(255)
  • kind: STRING(255)
  • location: STRING(255)
  • organizer_display_name: STRING(255)
  • organizer_email: STRING(255)
  • organizer_self: BOOLEAN
  • original_start_time_date: TIMESTAMP
  • original_start_time_date_time: TIMESTAMP
  • private_copy: BOOLEAN
  • recurring_event_id: STRING(255)
  • reminders_use_default: BOOLEAN
  • sequence: INTEGER
  • start_date: TIMESTAMP
  • start_date_time: TIMESTAMP
  • start_time_zone: STRING(255)
  • status: STRING(255)
  • summary: STRING(255)
  • updated: TIMESTAMP

events_attachments

  • file_id: STRING(255)
  • file_url: STRING(255)
  • icon_link: STRING(255)
  • mime_type: STRING(255)
  • title: STRING(255)
  • parent_id: STRING(255), FK(events.id)
  • unique_id: STRING(36)
  • root_id: STRING(255)

events_attendees

  • email: STRING(255)
  • organizer: BOOLEAN
  • response_status: STRING(255)
  • self: BOOLEAN
  • parent_id: STRING(255), FK(events_attachments.parent_id)
  • unique_id: STRING(36)
  • root_id: STRING(255)

events_conference_data_entry_points

  • entry_point_type: STRING(255)
  • label: STRING(255)
  • pin: LONG
  • region_code: STRING(255)
  • uri: STRING(255)
  • parent_id: STRING(255)
  • unique_id: STRING(36)
  • root_id: STRING(255)

events_recurrence

  • value: STRING(255)
  • parent_id: STRING(255), FK(events.id)
  • unique_id: STRING(36)
  • root_id: STRING(255)
Google Calendar HTTP connector specifications