Skip to content

Google: Calendar freebusy schemas

7 Google schemas with complete fields and constraints.

← Calendar freebusy operations · All schemas

Returns free busy information for a set of calendars — request body — body

FieldTypePresenceDescription and constraints
$objectRoot
calendarExpansionMaxintegerOptionalMaximal number of calendars for which FreeBusy information is to be provided. Optional. Maximum value is 50.
Format: int32
groupExpansionMaxintegerOptionalMaximal number of calendar identifiers to be provided for a single group. Optional. An error is returned for a group with more members than this value. Maximum value is 100.
Format: int32
itemsarrayOptionalList of calendars and/or groups to query.
items[]ModelEach itemExpand Returns free busy information for a set of calendars — request body — body items item
timeMaxstringOptionalThe end of the interval for the query formatted as per RFC3339.
Format: date-time
timeMinstringOptionalThe start of the interval for the query formatted as per RFC3339.
Format: date-time
timeZonestringOptionalTime zone used in the response. Optional. The default is UTC.
Default: UTC

Referenced models: Returns free busy information for a set of calendars — request body — body items item

Returns free busy information for a set of calendars — request body — body items item

FieldTypePresenceDescription and constraints
$objectRoot
idstringOptionalThe identifier of a calendar or a group.

Returns free busy information for a set of calendars — response body

FieldTypePresenceDescription and constraints
$objectRoot
calendarsobjectOptionalList of free/busy information for calendars.
Additional keys: see wildcard field
calendars.*ModelAdditional keysExpand Returns free busy information for a set of calendars — response body — calendars value
Free/busy expansions for a single calendar.
groupsobjectOptionalExpansion of groups.
Additional keys: see wildcard field
groups.*ModelAdditional keysExpand Returns free busy information for a set of calendars — response body — groups value
List of calendars that are members of this group.
kindstringOptionalType of the resource ("calendar#freeBusy").
Default: calendar#freeBusy
timeMaxstringOptionalThe end of the interval.
Format: date-time
timeMinstringOptionalThe start of the interval.
Format: date-time

Referenced models: Returns free busy information for a set of calendars — response body — calendars value, Returns free busy information for a set of calendars — response body — groups value

Returns free busy information for a set of calendars — response body — calendars value

FieldTypePresenceDescription and constraints
$objectRoot
busyarrayOptionalList of time ranges during which this calendar should be regarded as busy.
busy[]ModelEach itemExpand Returns free busy information for a set of calendars — response body — calendars value busy item
errorsarrayOptionalOptional error(s) (if computation for the calendar failed).
errors[]ModelEach itemExpand Returns free busy information for a set of calendars — response body — groups value errors item

Referenced models: Returns free busy information for a set of calendars — response body — groups value errors item, Returns free busy information for a set of calendars — response body — calendars value busy item

Returns free busy information for a set of calendars — response body — calendars value busy item

FieldTypePresenceDescription and constraints
$objectRoot
endstringOptionalThe (exclusive) end of the time period.
Format: date-time
startstringOptionalThe (inclusive) start of the time period.
Format: date-time

Returns free busy information for a set of calendars — response body — groups value

FieldTypePresenceDescription and constraints
$objectRoot
calendarsarrayOptionalList of calendars' identifiers within a group.
calendars[]stringEach item
errorsarrayOptionalOptional error(s) (if computation for the group failed).
errors[]ModelEach itemExpand Returns free busy information for a set of calendars — response body — groups value errors item

Referenced models: Returns free busy information for a set of calendars — response body — groups value errors item

Returns free busy information for a set of calendars — response body — groups value errors item

FieldTypePresenceDescription and constraints
$objectRoot
domainstringOptionalDomain, or broad category, of the error.
reasonstringOptionalSpecific reason for the error. Some of the possible values are:
- "groupTooBig" - The group of users requested is too large for a single query.
- "tooManyCalendarsRequested" - The number of calendars requested is too large for a single query.
- "notFound" - The requested resource was not found.
- "internalError" - The API service has encountered an internal error. Additional error types may be added in the future, so clients should gracefully handle additional error statuses not included in this list.

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.