Skip to content
OpenParablePublic APIs

Calendar API API

by googleapis.com

OAuthHTTPSAnalytics
Open documentation ↗

Overview

Manipulates events and other calendar data.

Calendar API is an analytics API from googleapis.com. Requests are authenticated with OAuth. It is served over HTTPS. Its OpenAPI description documents 37 endpoints.

At a glance

Authentication
OAuth
HTTPS
Yes
CORS
Unknown
Category
Analytics
Base URL
https://www.googleapis.com/calendar/v3
Version
v3
Endpoints
37
OpenAPI
Specification ↗
Spec updated
2023-04-21

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://www.googleapis.com/calendar/v3/colors" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"
JavaScript
const response = await fetch("https://www.googleapis.com/calendar/v3/colors", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://www.googleapis.com/calendar/v3/colors",
    headers={
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
POST/calendarsCreates a secondary calendar.
GET/calendars/{calendarId}Returns metadata for a calendar.
PUT/calendars/{calendarId}Updates metadata for a calendar.
PATCH/calendars/{calendarId}Updates metadata for a calendar. This method supports patch semantics.
DELETE/calendars/{calendarId}Deletes a secondary calendar. Use calendars.clear for clearing all events on primary calendars.
GET/calendars/{calendarId}/aclReturns the rules in the access control list for the calendar.
POST/calendars/{calendarId}/aclCreates an access control rule.
POST/calendars/{calendarId}/acl/watchWatch for changes to ACL resources.
GET/calendars/{calendarId}/acl/{ruleId}Returns an access control rule.
PUT/calendars/{calendarId}/acl/{ruleId}Updates an access control rule.
PATCH/calendars/{calendarId}/acl/{ruleId}Updates an access control rule. This method supports patch semantics.
DELETE/calendars/{calendarId}/acl/{ruleId}Deletes an access control rule.
POST/calendars/{calendarId}/clearClears a primary calendar. This operation deletes all events associated with the primary calendar of an account.
GET/calendars/{calendarId}/eventsReturns events on the specified calendar.
POST/calendars/{calendarId}/eventsCreates an event.
POST/calendars/{calendarId}/events/importImports an event. This operation is used to add a private copy of an existing event to a calendar.
POST/calendars/{calendarId}/events/quickAddCreates an event based on a simple text string.
POST/calendars/{calendarId}/events/watchWatch for changes to Events resources.
GET/calendars/{calendarId}/events/{eventId}Returns an event based on its Google Calendar ID. To retrieve an event using its iCalendar ID, call the events.list method using the iCalUID parameter.
PUT/calendars/{calendarId}/events/{eventId}Updates an event.
PATCH/calendars/{calendarId}/events/{eventId}Updates an event. This method supports patch semantics.
DELETE/calendars/{calendarId}/events/{eventId}Deletes an event.
GET/calendars/{calendarId}/events/{eventId}/instancesReturns instances of the specified recurring event.
POST/calendars/{calendarId}/events/{eventId}/moveMoves an event to another calendar, i.e. changes an event's organizer.
POST/channels/stopStop watching resources through this channel
GET/colorsReturns the color definitions for calendars and events.
POST/freeBusyReturns free/busy information for a set of calendars.
GET/users/me/calendarListReturns the calendars on the user's calendar list.
POST/users/me/calendarListInserts an existing calendar into the user's calendar list.
POST/users/me/calendarList/watchWatch for changes to CalendarList resources.
GET/users/me/calendarList/{calendarId}Returns a calendar from the user's calendar list.
PUT/users/me/calendarList/{calendarId}Updates an existing calendar on the user's calendar list.
PATCH/users/me/calendarList/{calendarId}Updates an existing calendar on the user's calendar list. This method supports patch semantics.
DELETE/users/me/calendarList/{calendarId}Removes a calendar from the user's calendar list.
GET/users/me/settingsReturns all user settings for the authenticated user.
POST/users/me/settings/watchWatch for changes to Settings resources.
GET/users/me/settings/{setting}Returns a single user setting.

Questions

Does the Calendar API API need an API key?

Yes. The Calendar API API uses OAuth authentication; the documentation explains how to get credentials.

Does the Calendar API API support HTTPS?

Yes, the Calendar API API is served over HTTPS.

How many endpoints does the Calendar API API have?

Its OpenAPI description lists 37 endpoints in version v3. All of them are shown on this page.

What are alternatives to the Calendar API API?

Other Analytics APIs include Google Play Integrity API, versionhistory.googleapis.com API, Doc Converter, Perspective Comment Analyzer API, Safe Browsing API.

Compare alternatives →

Google Play Integrity API

Analytics

The Play Integrity API helps you check that you're interacting with your genuine app on a genuine Android device powered by Google Play services. The Play Integrity API has replaced SafetyNet Attestation and Android Device Verification.

OAuth1 endpoints

versionhistory.googleapis.com API

Analytics

Version History API - Prod

No auth4 endpoints

Doc Converter

Analytics

This api converts file formats of OpenXml and OpenOffice documents formats to vector files (e.g., svg)

No auth1 endpoints

Perspective Comment Analyzer API

Analytics

The Perspective Comment Analyzer API provides information about the potential impact of a comment on a conversation (e.g. it can provide a score for the "toxicity" of a comment). Users can leverage the "SuggestCommentScore" method to submit corrections to improve Perspective over time. Users can set the "doNotStore" flag to ensure that all submitted comments are automatically deleted after scores are returned.

OAuth2 endpoints

Safe Browsing API

Analytics

Enables client applications to check web resources (most commonly URLs) against Google-generated lists of unsafe web resources. The Safe Browsing APIs are for non-commercial use only. If you need to use APIs to detect malicious URLs for commercial purposes – meaning “for sale or revenue-generating purposes” – please refer to the Web Risk API.

No auth7 endpoints

Web Fonts Developer API

Analytics

The Google Web Fonts Developer API lets you retrieve information about web fonts served by Google.

No auth1 endpoints

Listed from APIs.guru (CC0).