Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / e833b79ffee531ae64e11175718bb2fffc504950 / . / docs / dyn / classroom_v1.courses.html
blob: a449dce2eb7d4d1d0eabb0a454c549e70a9f5f90 [file] [log] [blame]
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]1<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="classroom_v1.html">Google Classroom API</a> . <a href="classroom_v1.courses.html">courses</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="classroom_v1.courses.aliases.html">aliases()</a></code>
79</p>
80<p class="firstline">Returns the aliases Resource.</p>
81
82<p class="toc_element">
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]83 <code><a href="classroom_v1.courses.courseWork.html">courseWork()</a></code>
84</p>
85<p class="firstline">Returns the courseWork Resource.</p>
86
87<p class="toc_element">
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]88 <code><a href="classroom_v1.courses.students.html">students()</a></code>
89</p>
90<p class="firstline">Returns the students Resource.</p>
91
92<p class="toc_element">
93 <code><a href="classroom_v1.courses.teachers.html">teachers()</a></code>
94</p>
95<p class="firstline">Returns the teachers Resource.</p>
96
97<p class="toc_element">
98 <code><a href="#create">create(body, x__xgafv=None)</a></code></p>
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]99<p class="firstline">Creates a course.</p>
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]100<p class="toc_element">
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]101 <code><a href="#delete">delete(id=None, x__xgafv=None)</a></code></p>
102<p class="firstline">Deletes a course.</p>
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]103<p class="toc_element">
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]104 <code><a href="#get">get(id=None, x__xgafv=None)</a></code></p>
105<p class="firstline">Returns a course.</p>
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]106<p class="toc_element">
Sai Cheemalapatiea3a5e12016-10-12 14:05:53 -0700[diff] [blame]107 <code><a href="#list">list(studentId=None, pageSize=None, courseStates=None, teacherId=None, pageToken=None, x__xgafv=None)</a></code></p>
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]108<p class="firstline">Returns a list of courses that the requesting user is permitted to view,</p>
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]109<p class="toc_element">
110 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
111<p class="firstline">Retrieves the next page of results.</p>
112<p class="toc_element">
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]113 <code><a href="#patch">patch(id=None, body, updateMask=None, x__xgafv=None)</a></code></p>
114<p class="firstline">Updates one or more fields in a course.</p>
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]115<p class="toc_element">
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]116 <code><a href="#update">update(id=None, body, x__xgafv=None)</a></code></p>
117<p class="firstline">Updates a course.</p>
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]118<h3>Method Details</h3>
119<div class="method">
120 <code class="details" id="create">create(body, x__xgafv=None)</code>
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]121 <pre>Creates a course.
122
123The user specified in `ownerId` is the owner of the created course
124and added as a teacher.
125
126This method returns the following error codes:
127
128* `PERMISSION_DENIED` if the requesting user is not permitted to create
129courses or for access errors.
130* `NOT_FOUND` if the primary teacher is not a valid user.
131* `FAILED_PRECONDITION` if the course owner's account is disabled or for
132the following request errors:
133 * UserGroupsMembershipLimitReached
134* `ALREADY_EXISTS` if an alias was specified in the `id` and
135already exists.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]136
137Args:
138 body: object, The request body. (required)
139 The object takes the form of:
140
141{ # A Course in Classroom.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]142 "updateTime": "A String", # Time of the most recent update to this course.
143 # Specifying this field in a course update mask results in an error.
144 #
145 # Read-only.
146 "description": "A String", # Optional description.
147 # For example, "We'll be learning about the structure of living
148 # creatures from a combination of textbooks, guest lectures, and lab work.
149 # Expect to be excited!"
150 # If set, this field must be a valid UTF-8 string and no longer than 30,000
151 # characters.
152 "alternateLink": "A String", # Absolute link to this course in the Classroom web UI.
153 #
154 # Read-only.
155 "enrollmentCode": "A String", # Enrollment code to use when joining this course.
156 # Specifying this field in a course update mask results in an error.
157 #
158 # Read-only.
159 "creationTime": "A String", # Creation time of the course.
160 # Specifying this field in a course update mask results in an error.
161 #
162 # Read-only.
163 "section": "A String", # Section of the course.
164 # For example, "Period 2".
165 # If set, this field must be a valid UTF-8 string and no longer than 2800
166 # characters.
167 "guardiansEnabled": True or False, # Whether or not guardian notifications are enabled for this course.
168 #
169 # Read-only.
170 "courseGroupEmail": "A String", # The email address of a Google group containing all members of the course.
171 # This group does not accept email and can only be used for permissions.
172 #
173 # Read-only.
174 "name": "A String", # Name of the course.
175 # For example, "10th Grade Biology".
176 # The name is required. It must be between 1 and 750 characters and a valid
177 # UTF-8 string.
178 "teacherGroupEmail": "A String", # The email address of a Google group containing all teachers of the course.
179 # This group does not accept email and can only be used for permissions.
180 #
181 # Read-only.
182 "courseMaterialSets": [ # Sets of materials that appear on the "about" page of this course.
183 #
184 # Read-only.
185 { # A set of materials that appears on the "About" page of the course.
186 # These materials might include a syllabus, schedule, or other background
187 # information relating to the course as a whole.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]188 "materials": [ # Materials attached to this set.
189 { # A material attached to a course as part of a material set.
190 "link": { # URL item. # Link atatchment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]191 "url": "A String", # URL to link to.
192 # This must be a valid UTF-8 string containing between 1 and 2024 characters.
193 "thumbnailUrl": "A String", # URL of a thumbnail image of the target URL.
194 #
195 # Read-only.
196 "title": "A String", # Title of the target of the URL.
197 #
198 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]199 },
200 "driveFile": { # Representation of a Google Drive file. # Google Drive file attachment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]201 "alternateLink": "A String", # URL that can be used to access the Drive item.
202 #
203 # Read-only.
204 "thumbnailUrl": "A String", # URL of a thumbnail image of the Drive item.
205 #
206 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]207 "id": "A String", # Drive API resource ID.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]208 "title": "A String", # Title of the Drive item.
209 #
210 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]211 },
212 "youTubeVideo": { # YouTube video item. # Youtube video attachment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]213 "alternateLink": "A String", # URL that can be used to view the YouTube video.
214 #
215 # Read-only.
216 "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
217 #
218 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]219 "id": "A String", # YouTube API resource ID.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]220 "title": "A String", # Title of the YouTube video.
221 #
222 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]223 },
224 "form": { # Google Forms item. # Google Forms attachment.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]225 "formUrl": "A String", # URL of the form.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]226 "thumbnailUrl": "A String", # URL of a thumbnail image of the Form.
227 #
228 # Read-only.
229 "responseUrl": "A String", # URL of the form responses document.
230 # Only set if respsonses have been recorded and only when the
231 # requesting user is an editor of the form.
232 #
233 # Read-only.
234 "title": "A String", # Title of the Form.
235 #
236 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]237 },
238 },
239 ],
240 "title": "A String", # Title for this set.
241 },
242 ],
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]243 "teacherFolder": { # Representation of a Google Drive folder. # Information about a Drive Folder that is shared with all teachers of the
244 # course.
245 #
246 # This field will only be set for teachers of the course and domain administrators.
247 #
248 # Read-only.
249 "alternateLink": "A String", # URL that can be used to access the Drive folder.
250 #
251 # Read-only.
252 "id": "A String", # Drive API resource ID.
253 "title": "A String", # Title of the Drive folder.
254 #
255 # Read-only.
256 },
257 "courseState": "A String", # State of the course.
258 # If unspecified, the default state is `PROVISIONED`.
259 "ownerId": "A String", # The identifier of the owner of a course.
260 #
261 # When specified as a parameter of a
262 # create course request, this
263 # field is required.
264 # The identifier can be one of the following:
265 #
266 # * the numeric identifier for the user
267 # * the email address of the user
268 # * the string literal `"me"`, indicating the requesting user
269 #
270 # This must be set in a create request. Specifying this field in a course
271 # update mask results in an `INVALID_ARGUMENT` error.
272 "id": "A String", # Identifier for this course assigned by Classroom.
273 #
274 # When
275 # creating a course,
276 # you may optionally set this identifier to an
277 # alias string in the
278 # request to create a corresponding alias. The `id` is still assigned by
279 # Classroom and cannot be updated after the course is created.
280 #
281 # Specifying this field in a course update mask results in an error.
282 "descriptionHeading": "A String", # Optional heading for the description.
283 # For example, "Welcome to 10th Grade Biology."
284 # If set, this field must be a valid UTF-8 string and no longer than 3600
285 # characters.
286 "room": "A String", # Optional room location.
287 # For example, "301".
288 # If set, this field must be a valid UTF-8 string and no longer than 650
289 # characters.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]290}
291
292 x__xgafv: string, V1 error format.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]293 Allowed values
294 1 - v1 error format
295 2 - v2 error format
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]296
297Returns:
298 An object of the form:
299
300 { # A Course in Classroom.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]301 "updateTime": "A String", # Time of the most recent update to this course.
302 # Specifying this field in a course update mask results in an error.
303 #
304 # Read-only.
305 "description": "A String", # Optional description.
306 # For example, "We'll be learning about the structure of living
307 # creatures from a combination of textbooks, guest lectures, and lab work.
308 # Expect to be excited!"
309 # If set, this field must be a valid UTF-8 string and no longer than 30,000
310 # characters.
311 "alternateLink": "A String", # Absolute link to this course in the Classroom web UI.
312 #
313 # Read-only.
314 "enrollmentCode": "A String", # Enrollment code to use when joining this course.
315 # Specifying this field in a course update mask results in an error.
316 #
317 # Read-only.
318 "creationTime": "A String", # Creation time of the course.
319 # Specifying this field in a course update mask results in an error.
320 #
321 # Read-only.
322 "section": "A String", # Section of the course.
323 # For example, "Period 2".
324 # If set, this field must be a valid UTF-8 string and no longer than 2800
325 # characters.
326 "guardiansEnabled": True or False, # Whether or not guardian notifications are enabled for this course.
327 #
328 # Read-only.
329 "courseGroupEmail": "A String", # The email address of a Google group containing all members of the course.
330 # This group does not accept email and can only be used for permissions.
331 #
332 # Read-only.
333 "name": "A String", # Name of the course.
334 # For example, "10th Grade Biology".
335 # The name is required. It must be between 1 and 750 characters and a valid
336 # UTF-8 string.
337 "teacherGroupEmail": "A String", # The email address of a Google group containing all teachers of the course.
338 # This group does not accept email and can only be used for permissions.
339 #
340 # Read-only.
341 "courseMaterialSets": [ # Sets of materials that appear on the "about" page of this course.
342 #
343 # Read-only.
344 { # A set of materials that appears on the "About" page of the course.
345 # These materials might include a syllabus, schedule, or other background
346 # information relating to the course as a whole.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]347 "materials": [ # Materials attached to this set.
348 { # A material attached to a course as part of a material set.
349 "link": { # URL item. # Link atatchment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]350 "url": "A String", # URL to link to.
351 # This must be a valid UTF-8 string containing between 1 and 2024 characters.
352 "thumbnailUrl": "A String", # URL of a thumbnail image of the target URL.
353 #
354 # Read-only.
355 "title": "A String", # Title of the target of the URL.
356 #
357 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]358 },
359 "driveFile": { # Representation of a Google Drive file. # Google Drive file attachment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]360 "alternateLink": "A String", # URL that can be used to access the Drive item.
361 #
362 # Read-only.
363 "thumbnailUrl": "A String", # URL of a thumbnail image of the Drive item.
364 #
365 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]366 "id": "A String", # Drive API resource ID.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]367 "title": "A String", # Title of the Drive item.
368 #
369 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]370 },
371 "youTubeVideo": { # YouTube video item. # Youtube video attachment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]372 "alternateLink": "A String", # URL that can be used to view the YouTube video.
373 #
374 # Read-only.
375 "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
376 #
377 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]378 "id": "A String", # YouTube API resource ID.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]379 "title": "A String", # Title of the YouTube video.
380 #
381 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]382 },
383 "form": { # Google Forms item. # Google Forms attachment.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]384 "formUrl": "A String", # URL of the form.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]385 "thumbnailUrl": "A String", # URL of a thumbnail image of the Form.
386 #
387 # Read-only.
388 "responseUrl": "A String", # URL of the form responses document.
389 # Only set if respsonses have been recorded and only when the
390 # requesting user is an editor of the form.
391 #
392 # Read-only.
393 "title": "A String", # Title of the Form.
394 #
395 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]396 },
397 },
398 ],
399 "title": "A String", # Title for this set.
400 },
401 ],
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]402 "teacherFolder": { # Representation of a Google Drive folder. # Information about a Drive Folder that is shared with all teachers of the
403 # course.
404 #
405 # This field will only be set for teachers of the course and domain administrators.
406 #
407 # Read-only.
408 "alternateLink": "A String", # URL that can be used to access the Drive folder.
409 #
410 # Read-only.
411 "id": "A String", # Drive API resource ID.
412 "title": "A String", # Title of the Drive folder.
413 #
414 # Read-only.
415 },
416 "courseState": "A String", # State of the course.
417 # If unspecified, the default state is `PROVISIONED`.
418 "ownerId": "A String", # The identifier of the owner of a course.
419 #
420 # When specified as a parameter of a
421 # create course request, this
422 # field is required.
423 # The identifier can be one of the following:
424 #
425 # * the numeric identifier for the user
426 # * the email address of the user
427 # * the string literal `"me"`, indicating the requesting user
428 #
429 # This must be set in a create request. Specifying this field in a course
430 # update mask results in an `INVALID_ARGUMENT` error.
431 "id": "A String", # Identifier for this course assigned by Classroom.
432 #
433 # When
434 # creating a course,
435 # you may optionally set this identifier to an
436 # alias string in the
437 # request to create a corresponding alias. The `id` is still assigned by
438 # Classroom and cannot be updated after the course is created.
439 #
440 # Specifying this field in a course update mask results in an error.
441 "descriptionHeading": "A String", # Optional heading for the description.
442 # For example, "Welcome to 10th Grade Biology."
443 # If set, this field must be a valid UTF-8 string and no longer than 3600
444 # characters.
445 "room": "A String", # Optional room location.
446 # For example, "301".
447 # If set, this field must be a valid UTF-8 string and no longer than 650
448 # characters.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]449 }</pre>
450</div>
451
452<div class="method">
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]453 <code class="details" id="delete">delete(id=None, x__xgafv=None)</code>
454 <pre>Deletes a course.
455
456This method returns the following error codes:
457
458* `PERMISSION_DENIED` if the requesting user is not permitted to delete the
459requested course or for access errors.
460* `NOT_FOUND` if no course exists with the requested ID.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]461
462Args:
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]463 id: string, Identifier of the course to delete.
464This identifier can be either the Classroom-assigned identifier or an
465alias. (required)
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]466 x__xgafv: string, V1 error format.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]467 Allowed values
468 1 - v1 error format
469 2 - v2 error format
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]470
471Returns:
472 An object of the form:
473
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]474 { # A generic empty message that you can re-use to avoid defining duplicated
475 # empty messages in your APIs. A typical example is to use it as the request
476 # or the response type of an API method. For instance:
477 #
478 # service Foo {
479 # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
480 # }
481 #
482 # The JSON representation for `Empty` is empty JSON object `{}`.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]483 }</pre>
484</div>
485
486<div class="method">
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]487 <code class="details" id="get">get(id=None, x__xgafv=None)</code>
488 <pre>Returns a course.
489
490This method returns the following error codes:
491
492* `PERMISSION_DENIED` if the requesting user is not permitted to access the
493requested course or for access errors.
494* `NOT_FOUND` if no course exists with the requested ID.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]495
496Args:
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]497 id: string, Identifier of the course to return.
498This identifier can be either the Classroom-assigned identifier or an
499alias. (required)
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]500 x__xgafv: string, V1 error format.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]501 Allowed values
502 1 - v1 error format
503 2 - v2 error format
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]504
505Returns:
506 An object of the form:
507
508 { # A Course in Classroom.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]509 "updateTime": "A String", # Time of the most recent update to this course.
510 # Specifying this field in a course update mask results in an error.
511 #
512 # Read-only.
513 "description": "A String", # Optional description.
514 # For example, "We'll be learning about the structure of living
515 # creatures from a combination of textbooks, guest lectures, and lab work.
516 # Expect to be excited!"
517 # If set, this field must be a valid UTF-8 string and no longer than 30,000
518 # characters.
519 "alternateLink": "A String", # Absolute link to this course in the Classroom web UI.
520 #
521 # Read-only.
522 "enrollmentCode": "A String", # Enrollment code to use when joining this course.
523 # Specifying this field in a course update mask results in an error.
524 #
525 # Read-only.
526 "creationTime": "A String", # Creation time of the course.
527 # Specifying this field in a course update mask results in an error.
528 #
529 # Read-only.
530 "section": "A String", # Section of the course.
531 # For example, "Period 2".
532 # If set, this field must be a valid UTF-8 string and no longer than 2800
533 # characters.
534 "guardiansEnabled": True or False, # Whether or not guardian notifications are enabled for this course.
535 #
536 # Read-only.
537 "courseGroupEmail": "A String", # The email address of a Google group containing all members of the course.
538 # This group does not accept email and can only be used for permissions.
539 #
540 # Read-only.
541 "name": "A String", # Name of the course.
542 # For example, "10th Grade Biology".
543 # The name is required. It must be between 1 and 750 characters and a valid
544 # UTF-8 string.
545 "teacherGroupEmail": "A String", # The email address of a Google group containing all teachers of the course.
546 # This group does not accept email and can only be used for permissions.
547 #
548 # Read-only.
549 "courseMaterialSets": [ # Sets of materials that appear on the "about" page of this course.
550 #
551 # Read-only.
552 { # A set of materials that appears on the "About" page of the course.
553 # These materials might include a syllabus, schedule, or other background
554 # information relating to the course as a whole.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]555 "materials": [ # Materials attached to this set.
556 { # A material attached to a course as part of a material set.
557 "link": { # URL item. # Link atatchment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]558 "url": "A String", # URL to link to.
559 # This must be a valid UTF-8 string containing between 1 and 2024 characters.
560 "thumbnailUrl": "A String", # URL of a thumbnail image of the target URL.
561 #
562 # Read-only.
563 "title": "A String", # Title of the target of the URL.
564 #
565 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]566 },
567 "driveFile": { # Representation of a Google Drive file. # Google Drive file attachment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]568 "alternateLink": "A String", # URL that can be used to access the Drive item.
569 #
570 # Read-only.
571 "thumbnailUrl": "A String", # URL of a thumbnail image of the Drive item.
572 #
573 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]574 "id": "A String", # Drive API resource ID.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]575 "title": "A String", # Title of the Drive item.
576 #
577 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]578 },
579 "youTubeVideo": { # YouTube video item. # Youtube video attachment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]580 "alternateLink": "A String", # URL that can be used to view the YouTube video.
581 #
582 # Read-only.
583 "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
584 #
585 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]586 "id": "A String", # YouTube API resource ID.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]587 "title": "A String", # Title of the YouTube video.
588 #
589 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]590 },
591 "form": { # Google Forms item. # Google Forms attachment.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]592 "formUrl": "A String", # URL of the form.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]593 "thumbnailUrl": "A String", # URL of a thumbnail image of the Form.
594 #
595 # Read-only.
596 "responseUrl": "A String", # URL of the form responses document.
597 # Only set if respsonses have been recorded and only when the
598 # requesting user is an editor of the form.
599 #
600 # Read-only.
601 "title": "A String", # Title of the Form.
602 #
603 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]604 },
605 },
606 ],
607 "title": "A String", # Title for this set.
608 },
609 ],
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]610 "teacherFolder": { # Representation of a Google Drive folder. # Information about a Drive Folder that is shared with all teachers of the
611 # course.
612 #
613 # This field will only be set for teachers of the course and domain administrators.
614 #
615 # Read-only.
616 "alternateLink": "A String", # URL that can be used to access the Drive folder.
617 #
618 # Read-only.
619 "id": "A String", # Drive API resource ID.
620 "title": "A String", # Title of the Drive folder.
621 #
622 # Read-only.
623 },
624 "courseState": "A String", # State of the course.
625 # If unspecified, the default state is `PROVISIONED`.
626 "ownerId": "A String", # The identifier of the owner of a course.
627 #
628 # When specified as a parameter of a
629 # create course request, this
630 # field is required.
631 # The identifier can be one of the following:
632 #
633 # * the numeric identifier for the user
634 # * the email address of the user
635 # * the string literal `"me"`, indicating the requesting user
636 #
637 # This must be set in a create request. Specifying this field in a course
638 # update mask results in an `INVALID_ARGUMENT` error.
639 "id": "A String", # Identifier for this course assigned by Classroom.
640 #
641 # When
642 # creating a course,
643 # you may optionally set this identifier to an
644 # alias string in the
645 # request to create a corresponding alias. The `id` is still assigned by
646 # Classroom and cannot be updated after the course is created.
647 #
648 # Specifying this field in a course update mask results in an error.
649 "descriptionHeading": "A String", # Optional heading for the description.
650 # For example, "Welcome to 10th Grade Biology."
651 # If set, this field must be a valid UTF-8 string and no longer than 3600
652 # characters.
653 "room": "A String", # Optional room location.
654 # For example, "301".
655 # If set, this field must be a valid UTF-8 string and no longer than 650
656 # characters.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]657 }</pre>
658</div>
659
660<div class="method">
Sai Cheemalapatiea3a5e12016-10-12 14:05:53 -0700[diff] [blame]661 <code class="details" id="list">list(studentId=None, pageSize=None, courseStates=None, teacherId=None, pageToken=None, x__xgafv=None)</code>
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]662 <pre>Returns a list of courses that the requesting user is permitted to view,
663restricted to those that match the request.
664
665This method returns the following error codes:
666
667* `PERMISSION_DENIED` for access errors.
668* `INVALID_ARGUMENT` if the query argument is malformed.
669* `NOT_FOUND` if any users specified in the query arguments do not exist.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]670
671Args:
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]672 studentId: string, Restricts returned courses to those having a student with the specified
673identifier. The identifier can be one of the following:
674
675* the numeric identifier for the user
676* the email address of the user
677* the string literal `"me"`, indicating the requesting user
678 pageSize: integer, Maximum number of items to return. Zero or unspecified indicates that the
679server may assign a maximum.
680
681The server may return fewer than the specified number of results.
682 courseStates: string, Restricts returned courses to those in one of the specified states
683The default value is ACTIVE, ARCHIVED, PROVISIONED, DECLINED. (repeated)
684 teacherId: string, Restricts returned courses to those having a teacher with the specified
685identifier. The identifier can be one of the following:
686
687* the numeric identifier for the user
688* the email address of the user
689* the string literal `"me"`, indicating the requesting user
690 pageToken: string, nextPageToken
691value returned from a previous
692list call,
693indicating that the subsequent page of results should be returned.
694
695The list request must be
696otherwise identical to the one that resulted in this token.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]697 x__xgafv: string, V1 error format.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]698 Allowed values
699 1 - v1 error format
700 2 - v2 error format
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]701
702Returns:
703 An object of the form:
704
705 { # Response when listing courses.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]706 "nextPageToken": "A String", # Token identifying the next page of results to return. If empty, no further
707 # results are available.
Jon Wayne Parrott36e41bc2016-02-19 16:02:29 -0800[diff] [blame]708 "courses": [ # Courses that match the list request.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]709 { # A Course in Classroom.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]710 "updateTime": "A String", # Time of the most recent update to this course.
711 # Specifying this field in a course update mask results in an error.
712 #
713 # Read-only.
714 "description": "A String", # Optional description.
715 # For example, "We'll be learning about the structure of living
716 # creatures from a combination of textbooks, guest lectures, and lab work.
717 # Expect to be excited!"
718 # If set, this field must be a valid UTF-8 string and no longer than 30,000
719 # characters.
720 "alternateLink": "A String", # Absolute link to this course in the Classroom web UI.
721 #
722 # Read-only.
723 "enrollmentCode": "A String", # Enrollment code to use when joining this course.
724 # Specifying this field in a course update mask results in an error.
725 #
726 # Read-only.
727 "creationTime": "A String", # Creation time of the course.
728 # Specifying this field in a course update mask results in an error.
729 #
730 # Read-only.
731 "section": "A String", # Section of the course.
732 # For example, "Period 2".
733 # If set, this field must be a valid UTF-8 string and no longer than 2800
734 # characters.
735 "guardiansEnabled": True or False, # Whether or not guardian notifications are enabled for this course.
736 #
737 # Read-only.
738 "courseGroupEmail": "A String", # The email address of a Google group containing all members of the course.
739 # This group does not accept email and can only be used for permissions.
740 #
741 # Read-only.
742 "name": "A String", # Name of the course.
743 # For example, "10th Grade Biology".
744 # The name is required. It must be between 1 and 750 characters and a valid
745 # UTF-8 string.
746 "teacherGroupEmail": "A String", # The email address of a Google group containing all teachers of the course.
747 # This group does not accept email and can only be used for permissions.
748 #
749 # Read-only.
750 "courseMaterialSets": [ # Sets of materials that appear on the "about" page of this course.
751 #
752 # Read-only.
753 { # A set of materials that appears on the "About" page of the course.
754 # These materials might include a syllabus, schedule, or other background
755 # information relating to the course as a whole.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]756 "materials": [ # Materials attached to this set.
757 { # A material attached to a course as part of a material set.
758 "link": { # URL item. # Link atatchment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]759 "url": "A String", # URL to link to.
760 # This must be a valid UTF-8 string containing between 1 and 2024 characters.
761 "thumbnailUrl": "A String", # URL of a thumbnail image of the target URL.
762 #
763 # Read-only.
764 "title": "A String", # Title of the target of the URL.
765 #
766 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]767 },
768 "driveFile": { # Representation of a Google Drive file. # Google Drive file attachment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]769 "alternateLink": "A String", # URL that can be used to access the Drive item.
770 #
771 # Read-only.
772 "thumbnailUrl": "A String", # URL of a thumbnail image of the Drive item.
773 #
774 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]775 "id": "A String", # Drive API resource ID.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]776 "title": "A String", # Title of the Drive item.
777 #
778 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]779 },
780 "youTubeVideo": { # YouTube video item. # Youtube video attachment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]781 "alternateLink": "A String", # URL that can be used to view the YouTube video.
782 #
783 # Read-only.
784 "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
785 #
786 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]787 "id": "A String", # YouTube API resource ID.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]788 "title": "A String", # Title of the YouTube video.
789 #
790 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]791 },
792 "form": { # Google Forms item. # Google Forms attachment.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]793 "formUrl": "A String", # URL of the form.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]794 "thumbnailUrl": "A String", # URL of a thumbnail image of the Form.
795 #
796 # Read-only.
797 "responseUrl": "A String", # URL of the form responses document.
798 # Only set if respsonses have been recorded and only when the
799 # requesting user is an editor of the form.
800 #
801 # Read-only.
802 "title": "A String", # Title of the Form.
803 #
804 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]805 },
806 },
807 ],
808 "title": "A String", # Title for this set.
809 },
810 ],
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]811 "teacherFolder": { # Representation of a Google Drive folder. # Information about a Drive Folder that is shared with all teachers of the
812 # course.
813 #
814 # This field will only be set for teachers of the course and domain administrators.
815 #
816 # Read-only.
817 "alternateLink": "A String", # URL that can be used to access the Drive folder.
818 #
819 # Read-only.
820 "id": "A String", # Drive API resource ID.
821 "title": "A String", # Title of the Drive folder.
822 #
823 # Read-only.
824 },
825 "courseState": "A String", # State of the course.
826 # If unspecified, the default state is `PROVISIONED`.
827 "ownerId": "A String", # The identifier of the owner of a course.
828 #
829 # When specified as a parameter of a
830 # create course request, this
831 # field is required.
832 # The identifier can be one of the following:
833 #
834 # * the numeric identifier for the user
835 # * the email address of the user
836 # * the string literal `"me"`, indicating the requesting user
837 #
838 # This must be set in a create request. Specifying this field in a course
839 # update mask results in an `INVALID_ARGUMENT` error.
840 "id": "A String", # Identifier for this course assigned by Classroom.
841 #
842 # When
843 # creating a course,
844 # you may optionally set this identifier to an
845 # alias string in the
846 # request to create a corresponding alias. The `id` is still assigned by
847 # Classroom and cannot be updated after the course is created.
848 #
849 # Specifying this field in a course update mask results in an error.
850 "descriptionHeading": "A String", # Optional heading for the description.
851 # For example, "Welcome to 10th Grade Biology."
852 # If set, this field must be a valid UTF-8 string and no longer than 3600
853 # characters.
854 "room": "A String", # Optional room location.
855 # For example, "301".
856 # If set, this field must be a valid UTF-8 string and no longer than 650
857 # characters.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]858 },
859 ],
860 }</pre>
861</div>
862
863<div class="method">
864 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
865 <pre>Retrieves the next page of results.
866
867Args:
868 previous_request: The request for the previous page. (required)
869 previous_response: The response from the request for the previous page. (required)
870
871Returns:
872 A request object that you can call 'execute()' on to request the next
873 page. Returns None if there are no more items in the collection.
874 </pre>
875</div>
876
877<div class="method">
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]878 <code class="details" id="patch">patch(id=None, body, updateMask=None, x__xgafv=None)</code>
879 <pre>Updates one or more fields in a course.
880
881This method returns the following error codes:
882
883* `PERMISSION_DENIED` if the requesting user is not permitted to modify the
884requested course or for access errors.
885* `NOT_FOUND` if no course exists with the requested ID.
886* `INVALID_ARGUMENT` if invalid fields are specified in the update mask or
887if no update mask is supplied.
888* `FAILED_PRECONDITION` for the following request errors:
889 * CourseNotModifiable
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]890
891Args:
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]892 id: string, Identifier of the course to update.
893This identifier can be either the Classroom-assigned identifier or an
894alias. (required)
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]895 body: object, The request body. (required)
896 The object takes the form of:
897
898{ # A Course in Classroom.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]899 "updateTime": "A String", # Time of the most recent update to this course.
900 # Specifying this field in a course update mask results in an error.
901 #
902 # Read-only.
903 "description": "A String", # Optional description.
904 # For example, "We'll be learning about the structure of living
905 # creatures from a combination of textbooks, guest lectures, and lab work.
906 # Expect to be excited!"
907 # If set, this field must be a valid UTF-8 string and no longer than 30,000
908 # characters.
909 "alternateLink": "A String", # Absolute link to this course in the Classroom web UI.
910 #
911 # Read-only.
912 "enrollmentCode": "A String", # Enrollment code to use when joining this course.
913 # Specifying this field in a course update mask results in an error.
914 #
915 # Read-only.
916 "creationTime": "A String", # Creation time of the course.
917 # Specifying this field in a course update mask results in an error.
918 #
919 # Read-only.
920 "section": "A String", # Section of the course.
921 # For example, "Period 2".
922 # If set, this field must be a valid UTF-8 string and no longer than 2800
923 # characters.
924 "guardiansEnabled": True or False, # Whether or not guardian notifications are enabled for this course.
925 #
926 # Read-only.
927 "courseGroupEmail": "A String", # The email address of a Google group containing all members of the course.
928 # This group does not accept email and can only be used for permissions.
929 #
930 # Read-only.
931 "name": "A String", # Name of the course.
932 # For example, "10th Grade Biology".
933 # The name is required. It must be between 1 and 750 characters and a valid
934 # UTF-8 string.
935 "teacherGroupEmail": "A String", # The email address of a Google group containing all teachers of the course.
936 # This group does not accept email and can only be used for permissions.
937 #
938 # Read-only.
939 "courseMaterialSets": [ # Sets of materials that appear on the "about" page of this course.
940 #
941 # Read-only.
942 { # A set of materials that appears on the "About" page of the course.
943 # These materials might include a syllabus, schedule, or other background
944 # information relating to the course as a whole.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]945 "materials": [ # Materials attached to this set.
946 { # A material attached to a course as part of a material set.
947 "link": { # URL item. # Link atatchment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]948 "url": "A String", # URL to link to.
949 # This must be a valid UTF-8 string containing between 1 and 2024 characters.
950 "thumbnailUrl": "A String", # URL of a thumbnail image of the target URL.
951 #
952 # Read-only.
953 "title": "A String", # Title of the target of the URL.
954 #
955 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]956 },
957 "driveFile": { # Representation of a Google Drive file. # Google Drive file attachment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]958 "alternateLink": "A String", # URL that can be used to access the Drive item.
959 #
960 # Read-only.
961 "thumbnailUrl": "A String", # URL of a thumbnail image of the Drive item.
962 #
963 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]964 "id": "A String", # Drive API resource ID.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]965 "title": "A String", # Title of the Drive item.
966 #
967 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]968 },
969 "youTubeVideo": { # YouTube video item. # Youtube video attachment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]970 "alternateLink": "A String", # URL that can be used to view the YouTube video.
971 #
972 # Read-only.
973 "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
974 #
975 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]976 "id": "A String", # YouTube API resource ID.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]977 "title": "A String", # Title of the YouTube video.
978 #
979 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]980 },
981 "form": { # Google Forms item. # Google Forms attachment.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]982 "formUrl": "A String", # URL of the form.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]983 "thumbnailUrl": "A String", # URL of a thumbnail image of the Form.
984 #
985 # Read-only.
986 "responseUrl": "A String", # URL of the form responses document.
987 # Only set if respsonses have been recorded and only when the
988 # requesting user is an editor of the form.
989 #
990 # Read-only.
991 "title": "A String", # Title of the Form.
992 #
993 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]994 },
995 },
996 ],
997 "title": "A String", # Title for this set.
998 },
999 ],
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1000 "teacherFolder": { # Representation of a Google Drive folder. # Information about a Drive Folder that is shared with all teachers of the
1001 # course.
1002 #
1003 # This field will only be set for teachers of the course and domain administrators.
1004 #
1005 # Read-only.
1006 "alternateLink": "A String", # URL that can be used to access the Drive folder.
1007 #
1008 # Read-only.
1009 "id": "A String", # Drive API resource ID.
1010 "title": "A String", # Title of the Drive folder.
1011 #
1012 # Read-only.
1013 },
1014 "courseState": "A String", # State of the course.
1015 # If unspecified, the default state is `PROVISIONED`.
1016 "ownerId": "A String", # The identifier of the owner of a course.
1017 #
1018 # When specified as a parameter of a
1019 # create course request, this
1020 # field is required.
1021 # The identifier can be one of the following:
1022 #
1023 # * the numeric identifier for the user
1024 # * the email address of the user
1025 # * the string literal `"me"`, indicating the requesting user
1026 #
1027 # This must be set in a create request. Specifying this field in a course
1028 # update mask results in an `INVALID_ARGUMENT` error.
1029 "id": "A String", # Identifier for this course assigned by Classroom.
1030 #
1031 # When
1032 # creating a course,
1033 # you may optionally set this identifier to an
1034 # alias string in the
1035 # request to create a corresponding alias. The `id` is still assigned by
1036 # Classroom and cannot be updated after the course is created.
1037 #
1038 # Specifying this field in a course update mask results in an error.
1039 "descriptionHeading": "A String", # Optional heading for the description.
1040 # For example, "Welcome to 10th Grade Biology."
1041 # If set, this field must be a valid UTF-8 string and no longer than 3600
1042 # characters.
1043 "room": "A String", # Optional room location.
1044 # For example, "301".
1045 # If set, this field must be a valid UTF-8 string and no longer than 650
1046 # characters.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]1047}
1048
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1049 updateMask: string, Mask that identifies which fields on the course to update.
1050This field is required to do an update. The update will fail if invalid
1051fields are specified. The following fields are valid:
1052
1053* `name`
1054* `section`
1055* `descriptionHeading`
1056* `description`
1057* `room`
1058* `courseState`
1059
1060When set in a query parameter, this field should be specified as
1061
1062`updateMask=<field1>,<field2>,...`
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]1063 x__xgafv: string, V1 error format.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1064 Allowed values
1065 1 - v1 error format
1066 2 - v2 error format
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]1067
1068Returns:
1069 An object of the form:
1070
1071 { # A Course in Classroom.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1072 "updateTime": "A String", # Time of the most recent update to this course.
1073 # Specifying this field in a course update mask results in an error.
1074 #
1075 # Read-only.
1076 "description": "A String", # Optional description.
1077 # For example, "We'll be learning about the structure of living
1078 # creatures from a combination of textbooks, guest lectures, and lab work.
1079 # Expect to be excited!"
1080 # If set, this field must be a valid UTF-8 string and no longer than 30,000
1081 # characters.
1082 "alternateLink": "A String", # Absolute link to this course in the Classroom web UI.
1083 #
1084 # Read-only.
1085 "enrollmentCode": "A String", # Enrollment code to use when joining this course.
1086 # Specifying this field in a course update mask results in an error.
1087 #
1088 # Read-only.
1089 "creationTime": "A String", # Creation time of the course.
1090 # Specifying this field in a course update mask results in an error.
1091 #
1092 # Read-only.
1093 "section": "A String", # Section of the course.
1094 # For example, "Period 2".
1095 # If set, this field must be a valid UTF-8 string and no longer than 2800
1096 # characters.
1097 "guardiansEnabled": True or False, # Whether or not guardian notifications are enabled for this course.
1098 #
1099 # Read-only.
1100 "courseGroupEmail": "A String", # The email address of a Google group containing all members of the course.
1101 # This group does not accept email and can only be used for permissions.
1102 #
1103 # Read-only.
1104 "name": "A String", # Name of the course.
1105 # For example, "10th Grade Biology".
1106 # The name is required. It must be between 1 and 750 characters and a valid
1107 # UTF-8 string.
1108 "teacherGroupEmail": "A String", # The email address of a Google group containing all teachers of the course.
1109 # This group does not accept email and can only be used for permissions.
1110 #
1111 # Read-only.
1112 "courseMaterialSets": [ # Sets of materials that appear on the "about" page of this course.
1113 #
1114 # Read-only.
1115 { # A set of materials that appears on the "About" page of the course.
1116 # These materials might include a syllabus, schedule, or other background
1117 # information relating to the course as a whole.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1118 "materials": [ # Materials attached to this set.
1119 { # A material attached to a course as part of a material set.
1120 "link": { # URL item. # Link atatchment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1121 "url": "A String", # URL to link to.
1122 # This must be a valid UTF-8 string containing between 1 and 2024 characters.
1123 "thumbnailUrl": "A String", # URL of a thumbnail image of the target URL.
1124 #
1125 # Read-only.
1126 "title": "A String", # Title of the target of the URL.
1127 #
1128 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1129 },
1130 "driveFile": { # Representation of a Google Drive file. # Google Drive file attachment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1131 "alternateLink": "A String", # URL that can be used to access the Drive item.
1132 #
1133 # Read-only.
1134 "thumbnailUrl": "A String", # URL of a thumbnail image of the Drive item.
1135 #
1136 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1137 "id": "A String", # Drive API resource ID.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1138 "title": "A String", # Title of the Drive item.
1139 #
1140 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1141 },
1142 "youTubeVideo": { # YouTube video item. # Youtube video attachment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1143 "alternateLink": "A String", # URL that can be used to view the YouTube video.
1144 #
1145 # Read-only.
1146 "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
1147 #
1148 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1149 "id": "A String", # YouTube API resource ID.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1150 "title": "A String", # Title of the YouTube video.
1151 #
1152 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1153 },
1154 "form": { # Google Forms item. # Google Forms attachment.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1155 "formUrl": "A String", # URL of the form.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1156 "thumbnailUrl": "A String", # URL of a thumbnail image of the Form.
1157 #
1158 # Read-only.
1159 "responseUrl": "A String", # URL of the form responses document.
1160 # Only set if respsonses have been recorded and only when the
1161 # requesting user is an editor of the form.
1162 #
1163 # Read-only.
1164 "title": "A String", # Title of the Form.
1165 #
1166 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1167 },
1168 },
1169 ],
1170 "title": "A String", # Title for this set.
1171 },
1172 ],
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1173 "teacherFolder": { # Representation of a Google Drive folder. # Information about a Drive Folder that is shared with all teachers of the
1174 # course.
1175 #
1176 # This field will only be set for teachers of the course and domain administrators.
1177 #
1178 # Read-only.
1179 "alternateLink": "A String", # URL that can be used to access the Drive folder.
1180 #
1181 # Read-only.
1182 "id": "A String", # Drive API resource ID.
1183 "title": "A String", # Title of the Drive folder.
1184 #
1185 # Read-only.
1186 },
1187 "courseState": "A String", # State of the course.
1188 # If unspecified, the default state is `PROVISIONED`.
1189 "ownerId": "A String", # The identifier of the owner of a course.
1190 #
1191 # When specified as a parameter of a
1192 # create course request, this
1193 # field is required.
1194 # The identifier can be one of the following:
1195 #
1196 # * the numeric identifier for the user
1197 # * the email address of the user
1198 # * the string literal `"me"`, indicating the requesting user
1199 #
1200 # This must be set in a create request. Specifying this field in a course
1201 # update mask results in an `INVALID_ARGUMENT` error.
1202 "id": "A String", # Identifier for this course assigned by Classroom.
1203 #
1204 # When
1205 # creating a course,
1206 # you may optionally set this identifier to an
1207 # alias string in the
1208 # request to create a corresponding alias. The `id` is still assigned by
1209 # Classroom and cannot be updated after the course is created.
1210 #
1211 # Specifying this field in a course update mask results in an error.
1212 "descriptionHeading": "A String", # Optional heading for the description.
1213 # For example, "Welcome to 10th Grade Biology."
1214 # If set, this field must be a valid UTF-8 string and no longer than 3600
1215 # characters.
1216 "room": "A String", # Optional room location.
1217 # For example, "301".
1218 # If set, this field must be a valid UTF-8 string and no longer than 650
1219 # characters.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]1220 }</pre>
1221</div>
1222
1223<div class="method">
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1224 <code class="details" id="update">update(id=None, body, x__xgafv=None)</code>
1225 <pre>Updates a course.
1226
1227This method returns the following error codes:
1228
1229* `PERMISSION_DENIED` if the requesting user is not permitted to modify the
1230requested course or for access errors.
1231* `NOT_FOUND` if no course exists with the requested ID.
1232* `FAILED_PRECONDITION` for the following request errors:
1233 * CourseNotModifiable
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]1234
1235Args:
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1236 id: string, Identifier of the course to update.
1237This identifier can be either the Classroom-assigned identifier or an
1238alias. (required)
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]1239 body: object, The request body. (required)
1240 The object takes the form of:
1241
1242{ # A Course in Classroom.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1243 "updateTime": "A String", # Time of the most recent update to this course.
1244 # Specifying this field in a course update mask results in an error.
1245 #
1246 # Read-only.
1247 "description": "A String", # Optional description.
1248 # For example, "We'll be learning about the structure of living
1249 # creatures from a combination of textbooks, guest lectures, and lab work.
1250 # Expect to be excited!"
1251 # If set, this field must be a valid UTF-8 string and no longer than 30,000
1252 # characters.
1253 "alternateLink": "A String", # Absolute link to this course in the Classroom web UI.
1254 #
1255 # Read-only.
1256 "enrollmentCode": "A String", # Enrollment code to use when joining this course.
1257 # Specifying this field in a course update mask results in an error.
1258 #
1259 # Read-only.
1260 "creationTime": "A String", # Creation time of the course.
1261 # Specifying this field in a course update mask results in an error.
1262 #
1263 # Read-only.
1264 "section": "A String", # Section of the course.
1265 # For example, "Period 2".
1266 # If set, this field must be a valid UTF-8 string and no longer than 2800
1267 # characters.
1268 "guardiansEnabled": True or False, # Whether or not guardian notifications are enabled for this course.
1269 #
1270 # Read-only.
1271 "courseGroupEmail": "A String", # The email address of a Google group containing all members of the course.
1272 # This group does not accept email and can only be used for permissions.
1273 #
1274 # Read-only.
1275 "name": "A String", # Name of the course.
1276 # For example, "10th Grade Biology".
1277 # The name is required. It must be between 1 and 750 characters and a valid
1278 # UTF-8 string.
1279 "teacherGroupEmail": "A String", # The email address of a Google group containing all teachers of the course.
1280 # This group does not accept email and can only be used for permissions.
1281 #
1282 # Read-only.
1283 "courseMaterialSets": [ # Sets of materials that appear on the "about" page of this course.
1284 #
1285 # Read-only.
1286 { # A set of materials that appears on the "About" page of the course.
1287 # These materials might include a syllabus, schedule, or other background
1288 # information relating to the course as a whole.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1289 "materials": [ # Materials attached to this set.
1290 { # A material attached to a course as part of a material set.
1291 "link": { # URL item. # Link atatchment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1292 "url": "A String", # URL to link to.
1293 # This must be a valid UTF-8 string containing between 1 and 2024 characters.
1294 "thumbnailUrl": "A String", # URL of a thumbnail image of the target URL.
1295 #
1296 # Read-only.
1297 "title": "A String", # Title of the target of the URL.
1298 #
1299 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1300 },
1301 "driveFile": { # Representation of a Google Drive file. # Google Drive file attachment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1302 "alternateLink": "A String", # URL that can be used to access the Drive item.
1303 #
1304 # Read-only.
1305 "thumbnailUrl": "A String", # URL of a thumbnail image of the Drive item.
1306 #
1307 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1308 "id": "A String", # Drive API resource ID.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1309 "title": "A String", # Title of the Drive item.
1310 #
1311 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1312 },
1313 "youTubeVideo": { # YouTube video item. # Youtube video attachment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1314 "alternateLink": "A String", # URL that can be used to view the YouTube video.
1315 #
1316 # Read-only.
1317 "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
1318 #
1319 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1320 "id": "A String", # YouTube API resource ID.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1321 "title": "A String", # Title of the YouTube video.
1322 #
1323 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1324 },
1325 "form": { # Google Forms item. # Google Forms attachment.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1326 "formUrl": "A String", # URL of the form.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1327 "thumbnailUrl": "A String", # URL of a thumbnail image of the Form.
1328 #
1329 # Read-only.
1330 "responseUrl": "A String", # URL of the form responses document.
1331 # Only set if respsonses have been recorded and only when the
1332 # requesting user is an editor of the form.
1333 #
1334 # Read-only.
1335 "title": "A String", # Title of the Form.
1336 #
1337 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1338 },
1339 },
1340 ],
1341 "title": "A String", # Title for this set.
1342 },
1343 ],
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1344 "teacherFolder": { # Representation of a Google Drive folder. # Information about a Drive Folder that is shared with all teachers of the
1345 # course.
1346 #
1347 # This field will only be set for teachers of the course and domain administrators.
1348 #
1349 # Read-only.
1350 "alternateLink": "A String", # URL that can be used to access the Drive folder.
1351 #
1352 # Read-only.
1353 "id": "A String", # Drive API resource ID.
1354 "title": "A String", # Title of the Drive folder.
1355 #
1356 # Read-only.
1357 },
1358 "courseState": "A String", # State of the course.
1359 # If unspecified, the default state is `PROVISIONED`.
1360 "ownerId": "A String", # The identifier of the owner of a course.
1361 #
1362 # When specified as a parameter of a
1363 # create course request, this
1364 # field is required.
1365 # The identifier can be one of the following:
1366 #
1367 # * the numeric identifier for the user
1368 # * the email address of the user
1369 # * the string literal `"me"`, indicating the requesting user
1370 #
1371 # This must be set in a create request. Specifying this field in a course
1372 # update mask results in an `INVALID_ARGUMENT` error.
1373 "id": "A String", # Identifier for this course assigned by Classroom.
1374 #
1375 # When
1376 # creating a course,
1377 # you may optionally set this identifier to an
1378 # alias string in the
1379 # request to create a corresponding alias. The `id` is still assigned by
1380 # Classroom and cannot be updated after the course is created.
1381 #
1382 # Specifying this field in a course update mask results in an error.
1383 "descriptionHeading": "A String", # Optional heading for the description.
1384 # For example, "Welcome to 10th Grade Biology."
1385 # If set, this field must be a valid UTF-8 string and no longer than 3600
1386 # characters.
1387 "room": "A String", # Optional room location.
1388 # For example, "301".
1389 # If set, this field must be a valid UTF-8 string and no longer than 650
1390 # characters.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]1391}
1392
1393 x__xgafv: string, V1 error format.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1394 Allowed values
1395 1 - v1 error format
1396 2 - v2 error format
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]1397
1398Returns:
1399 An object of the form:
1400
1401 { # A Course in Classroom.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1402 "updateTime": "A String", # Time of the most recent update to this course.
1403 # Specifying this field in a course update mask results in an error.
1404 #
1405 # Read-only.
1406 "description": "A String", # Optional description.
1407 # For example, "We'll be learning about the structure of living
1408 # creatures from a combination of textbooks, guest lectures, and lab work.
1409 # Expect to be excited!"
1410 # If set, this field must be a valid UTF-8 string and no longer than 30,000
1411 # characters.
1412 "alternateLink": "A String", # Absolute link to this course in the Classroom web UI.
1413 #
1414 # Read-only.
1415 "enrollmentCode": "A String", # Enrollment code to use when joining this course.
1416 # Specifying this field in a course update mask results in an error.
1417 #
1418 # Read-only.
1419 "creationTime": "A String", # Creation time of the course.
1420 # Specifying this field in a course update mask results in an error.
1421 #
1422 # Read-only.
1423 "section": "A String", # Section of the course.
1424 # For example, "Period 2".
1425 # If set, this field must be a valid UTF-8 string and no longer than 2800
1426 # characters.
1427 "guardiansEnabled": True or False, # Whether or not guardian notifications are enabled for this course.
1428 #
1429 # Read-only.
1430 "courseGroupEmail": "A String", # The email address of a Google group containing all members of the course.
1431 # This group does not accept email and can only be used for permissions.
1432 #
1433 # Read-only.
1434 "name": "A String", # Name of the course.
1435 # For example, "10th Grade Biology".
1436 # The name is required. It must be between 1 and 750 characters and a valid
1437 # UTF-8 string.
1438 "teacherGroupEmail": "A String", # The email address of a Google group containing all teachers of the course.
1439 # This group does not accept email and can only be used for permissions.
1440 #
1441 # Read-only.
1442 "courseMaterialSets": [ # Sets of materials that appear on the "about" page of this course.
1443 #
1444 # Read-only.
1445 { # A set of materials that appears on the "About" page of the course.
1446 # These materials might include a syllabus, schedule, or other background
1447 # information relating to the course as a whole.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1448 "materials": [ # Materials attached to this set.
1449 { # A material attached to a course as part of a material set.
1450 "link": { # URL item. # Link atatchment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1451 "url": "A String", # URL to link to.
1452 # This must be a valid UTF-8 string containing between 1 and 2024 characters.
1453 "thumbnailUrl": "A String", # URL of a thumbnail image of the target URL.
1454 #
1455 # Read-only.
1456 "title": "A String", # Title of the target of the URL.
1457 #
1458 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1459 },
1460 "driveFile": { # Representation of a Google Drive file. # Google Drive file attachment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1461 "alternateLink": "A String", # URL that can be used to access the Drive item.
1462 #
1463 # Read-only.
1464 "thumbnailUrl": "A String", # URL of a thumbnail image of the Drive item.
1465 #
1466 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1467 "id": "A String", # Drive API resource ID.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1468 "title": "A String", # Title of the Drive item.
1469 #
1470 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1471 },
1472 "youTubeVideo": { # YouTube video item. # Youtube video attachment.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1473 "alternateLink": "A String", # URL that can be used to view the YouTube video.
1474 #
1475 # Read-only.
1476 "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
1477 #
1478 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1479 "id": "A String", # YouTube API resource ID.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1480 "title": "A String", # Title of the YouTube video.
1481 #
1482 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1483 },
1484 "form": { # Google Forms item. # Google Forms attachment.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1485 "formUrl": "A String", # URL of the form.
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1486 "thumbnailUrl": "A String", # URL of a thumbnail image of the Form.
1487 #
1488 # Read-only.
1489 "responseUrl": "A String", # URL of the form responses document.
1490 # Only set if respsonses have been recorded and only when the
1491 # requesting user is an editor of the form.
1492 #
1493 # Read-only.
1494 "title": "A String", # Title of the Form.
1495 #
1496 # Read-only.
Jon Wayne Parrott0a471d32016-05-19 10:54:38 -0700[diff] [blame]1497 },
1498 },
1499 ],
1500 "title": "A String", # Title for this set.
1501 },
1502 ],
Sai Cheemalapatie833b792017-03-24 15:06:46 -0700[diff] [blame^]1503 "teacherFolder": { # Representation of a Google Drive folder. # Information about a Drive Folder that is shared with all teachers of the
1504 # course.
1505 #
1506 # This field will only be set for teachers of the course and domain administrators.
1507 #
1508 # Read-only.
1509 "alternateLink": "A String", # URL that can be used to access the Drive folder.
1510 #
1511 # Read-only.
1512 "id": "A String", # Drive API resource ID.
1513 "title": "A String", # Title of the Drive folder.
1514 #
1515 # Read-only.
1516 },
1517 "courseState": "A String", # State of the course.
1518 # If unspecified, the default state is `PROVISIONED`.
1519 "ownerId": "A String", # The identifier of the owner of a course.
1520 #
1521 # When specified as a parameter of a
1522 # create course request, this
1523 # field is required.
1524 # The identifier can be one of the following:
1525 #
1526 # * the numeric identifier for the user
1527 # * the email address of the user
1528 # * the string literal `"me"`, indicating the requesting user
1529 #
1530 # This must be set in a create request. Specifying this field in a course
1531 # update mask results in an `INVALID_ARGUMENT` error.
1532 "id": "A String", # Identifier for this course assigned by Classroom.
1533 #
1534 # When
1535 # creating a course,
1536 # you may optionally set this identifier to an
1537 # alias string in the
1538 # request to create a corresponding alias. The `id` is still assigned by
1539 # Classroom and cannot be updated after the course is created.
1540 #
1541 # Specifying this field in a course update mask results in an error.
1542 "descriptionHeading": "A String", # Optional heading for the description.
1543 # For example, "Welcome to 10th Grade Biology."
1544 # If set, this field must be a valid UTF-8 string and no longer than 3600
1545 # characters.
1546 "room": "A String", # Optional room location.
1547 # For example, "301".
1548 # If set, this field must be a valid UTF-8 string and no longer than 650
1549 # characters.
Takashi Matsuo06694102015-09-11 13:55:40 -0700[diff] [blame]1550 }</pre>
1551</div>
1552
1553</body></html>