blob: 8a0e3e60415f181b2ec81910b48785d81de68a18 [file] [log] [blame]
John Asmuth614db982014-04-24 15:46:26 -04001<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13}
14
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54 margin-top: 0.5em;
55}
56
57.firstline {
58 margin-left: 2 em;
59}
60
61.method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66}
67
68.details {
69 font-weight: bold;
70 font-size: 14px;
71}
72
73</style>
74
75<h1><a href="calendar_v3.html">Calendar API</a> . <a href="calendar_v3.freebusy.html">freebusy</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070078 <code><a href="#close">close()</a></code></p>
79<p class="firstline">Close httplib2 connections.</p>
80<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -070081 <code><a href="#query">query(body=None)</a></code></p>
John Asmuth614db982014-04-24 15:46:26 -040082<p class="firstline">Returns free/busy information for a set of calendars.</p>
83<h3>Method Details</h3>
84<div class="method">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070085 <code class="details" id="close">close()</code>
86 <pre>Close httplib2 connections.</pre>
87</div>
88
89<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -070090 <code class="details" id="query">query(body=None)</code>
John Asmuth614db982014-04-24 15:46:26 -040091 <pre>Returns free/busy information for a set of calendars.
92
93Args:
Dan O'Mearadd494642020-05-01 07:42:23 -070094 body: object, The request body.
John Asmuth614db982014-04-24 15:46:26 -040095 The object takes the form of:
96
97{
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -080098 &quot;calendarExpansionMax&quot;: 42, # Maximal number of calendars for which FreeBusy information is to be provided. Optional. Maximum value is 50.
99 &quot;groupExpansionMax&quot;: 42, # Maximal 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.
100 &quot;items&quot;: [ # List of calendars and/or groups to query.
101 {
102 &quot;id&quot;: &quot;A String&quot;, # The identifier of a calendar or a group.
103 },
104 ],
105 &quot;timeMax&quot;: &quot;A String&quot;, # The end of the interval for the query formatted as per RFC3339.
106 &quot;timeMin&quot;: &quot;A String&quot;, # The start of the interval for the query formatted as per RFC3339.
107 &quot;timeZone&quot;: &quot;UTC&quot;, # Time zone used in the response. Optional. The default is UTC.
108}
John Asmuth614db982014-04-24 15:46:26 -0400109
110
111Returns:
112 An object of the form:
113
114 {
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800115 &quot;calendars&quot;: { # List of free/busy information for calendars.
116 &quot;a_key&quot;: { # Free/busy expansions for a single calendar.
117 &quot;busy&quot;: [ # List of time ranges during which this calendar should be regarded as busy.
118 {
119 &quot;end&quot;: &quot;A String&quot;, # The (exclusive) end of the time period.
120 &quot;start&quot;: &quot;A String&quot;, # The (inclusive) start of the time period.
121 },
122 ],
123 &quot;errors&quot;: [ # Optional error(s) (if computation for the calendar failed).
124 {
125 &quot;domain&quot;: &quot;A String&quot;, # Domain, or broad category, of the error.
126 &quot;reason&quot;: &quot;A String&quot;, # Specific reason for the error. Some of the possible values are:
127 # - &quot;groupTooBig&quot; - The group of users requested is too large for a single query.
128 # - &quot;tooManyCalendarsRequested&quot; - The number of calendars requested is too large for a single query.
129 # - &quot;notFound&quot; - The requested resource was not found.
130 # - &quot;internalError&quot; - 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.
131 },
132 ],
John Asmuth614db982014-04-24 15:46:26 -0400133 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800134 },
135 &quot;groups&quot;: { # Expansion of groups.
136 &quot;a_key&quot;: { # List of calendars that are members of this group.
137 &quot;calendars&quot;: [ # List of calendars&#x27; identifiers within a group.
138 &quot;A String&quot;,
139 ],
140 &quot;errors&quot;: [ # Optional error(s) (if computation for the group failed).
141 {
142 &quot;domain&quot;: &quot;A String&quot;, # Domain, or broad category, of the error.
143 &quot;reason&quot;: &quot;A String&quot;, # Specific reason for the error. Some of the possible values are:
144 # - &quot;groupTooBig&quot; - The group of users requested is too large for a single query.
145 # - &quot;tooManyCalendarsRequested&quot; - The number of calendars requested is too large for a single query.
146 # - &quot;notFound&quot; - The requested resource was not found.
147 # - &quot;internalError&quot; - 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.
148 },
149 ],
John Asmuth614db982014-04-24 15:46:26 -0400150 },
Yoshi Automation Botcc94ec82021-01-15 07:10:04 -0800151 },
152 &quot;kind&quot;: &quot;calendar#freeBusy&quot;, # Type of the resource (&quot;calendar#freeBusy&quot;).
153 &quot;timeMax&quot;: &quot;A String&quot;, # The end of the interval.
154 &quot;timeMin&quot;: &quot;A String&quot;, # The start of the interval.
155}</pre>
John Asmuth614db982014-04-24 15:46:26 -0400156</div>
157
158</body></html>