chore: regens API reference docs (#889)

diff --git a/docs/dyn/classroom_v1.courses.html b/docs/dyn/classroom_v1.courses.html
index e7242c3..bb1def8 100644
--- a/docs/dyn/classroom_v1.courses.html
+++ b/docs/dyn/classroom_v1.courses.html
@@ -105,7 +105,7 @@
 <p class="firstline">Returns the topics Resource.</p>
 
 <p class="toc_element">
-  <code><a href="#create">create(body, x__xgafv=None)</a></code></p>
+  <code><a href="#create">create(body=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Creates a course.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(id, x__xgafv=None)</a></code></p>
@@ -120,14 +120,14 @@
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
-  <code><a href="#patch">patch(id, body, updateMask=None, x__xgafv=None)</a></code></p>
+  <code><a href="#patch">patch(id, body=None, updateMask=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Updates one or more fields in a course.</p>
 <p class="toc_element">
-  <code><a href="#update">update(id, body, x__xgafv=None)</a></code></p>
+  <code><a href="#update">update(id, body=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Updates a course.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="create">create(body, x__xgafv=None)</code>
+    <code class="details" id="create">create(body=None, x__xgafv=None)</code>
   <pre>Creates a course.
 
 The user specified in `ownerId` is the owner of the created course
@@ -145,7 +145,7 @@
 already exists.
 
 Args:
-  body: object, The request body. (required)
+  body: object, The request body.
     The object takes the form of:
 
 { # A Course in Classroom.
@@ -198,10 +198,10 @@
       "materials": [ # Materials attached to this set.
         { # A material attached to a course as part of a material set.
           "youTubeVideo": { # YouTube video item. # Youtube video attachment.
-            "alternateLink": "A String", # URL that can be used to view the YouTube video.
+            "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
                 #
                 # Read-only.
-            "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
+            "alternateLink": "A String", # URL that can be used to view the YouTube video.
                 #
                 # Read-only.
             "id": "A String", # YouTube API resource ID.
@@ -232,10 +232,10 @@
                 # Read-only.
           },
           "form": { # Google Forms item. # Google Forms attachment.
-            "formUrl": "A String", # URL of the form.
             "thumbnailUrl": "A String", # URL of a thumbnail image of the Form.
                 #
                 # Read-only.
+            "formUrl": "A String", # URL of the form.
             "responseUrl": "A String", # URL of the form responses document.
                 # Only set if respsonses have been recorded and only when the
                 # requesting user is an editor of the form.
@@ -250,20 +250,6 @@
       "title": "A String", # Title for this set.
     },
   ],
-  "ownerId": "A String", # The identifier of the owner of a course.
-      # 
-      # When specified as a parameter of a
-      # create course request, this
-      # field is required.
-      # The identifier can be one of the following:
-      # 
-      # * the numeric identifier for the user
-      # * the email address of the user
-      # * the string literal `"me"`, indicating the requesting user
-      # 
-      # This must be set in a create request. Admins can also specify this field
-      # in a patch course request to
-      # transfer ownership. In other contexts, it is read-only.
   "calendarId": "A String", # The Calendar ID for a calendar that all course members can see, to which
       # Classroom adds events for course work and announcements in the course.
       # 
@@ -283,6 +269,20 @@
         #
         # Read-only.
   },
+  "ownerId": "A String", # The identifier of the owner of a course.
+      # 
+      # When specified as a parameter of a
+      # create course request, this
+      # field is required.
+      # The identifier can be one of the following:
+      # 
+      # * the numeric identifier for the user
+      # * the email address of the user
+      # * the string literal `"me"`, indicating the requesting user
+      # 
+      # This must be set in a create request. Admins can also specify this field
+      # in a patch course request to
+      # transfer ownership. In other contexts, it is read-only.
   "courseState": "A String", # State of the course.
       # If unspecified, the default state is `PROVISIONED`.
   "id": "A String", # Identifier for this course assigned by Classroom.
@@ -363,10 +363,10 @@
         "materials": [ # Materials attached to this set.
           { # A material attached to a course as part of a material set.
             "youTubeVideo": { # YouTube video item. # Youtube video attachment.
-              "alternateLink": "A String", # URL that can be used to view the YouTube video.
+              "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
                   #
                   # Read-only.
-              "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
+              "alternateLink": "A String", # URL that can be used to view the YouTube video.
                   #
                   # Read-only.
               "id": "A String", # YouTube API resource ID.
@@ -397,10 +397,10 @@
                   # Read-only.
             },
             "form": { # Google Forms item. # Google Forms attachment.
-              "formUrl": "A String", # URL of the form.
               "thumbnailUrl": "A String", # URL of a thumbnail image of the Form.
                   #
                   # Read-only.
+              "formUrl": "A String", # URL of the form.
               "responseUrl": "A String", # URL of the form responses document.
                   # Only set if respsonses have been recorded and only when the
                   # requesting user is an editor of the form.
@@ -415,20 +415,6 @@
         "title": "A String", # Title for this set.
       },
     ],
-    "ownerId": "A String", # The identifier of the owner of a course.
-        #
-        # When specified as a parameter of a
-        # create course request, this
-        # field is required.
-        # The identifier can be one of the following:
-        #
-        # * the numeric identifier for the user
-        # * the email address of the user
-        # * the string literal `"me"`, indicating the requesting user
-        #
-        # This must be set in a create request. Admins can also specify this field
-        # in a patch course request to
-        # transfer ownership. In other contexts, it is read-only.
     "calendarId": "A String", # The Calendar ID for a calendar that all course members can see, to which
         # Classroom adds events for course work and announcements in the course.
         #
@@ -448,6 +434,20 @@
           #
           # Read-only.
     },
+    "ownerId": "A String", # The identifier of the owner of a course.
+        #
+        # When specified as a parameter of a
+        # create course request, this
+        # field is required.
+        # The identifier can be one of the following:
+        #
+        # * the numeric identifier for the user
+        # * the email address of the user
+        # * the string literal `"me"`, indicating the requesting user
+        #
+        # This must be set in a create request. Admins can also specify this field
+        # in a patch course request to
+        # transfer ownership. In other contexts, it is read-only.
     "courseState": "A String", # State of the course.
         # If unspecified, the default state is `PROVISIONED`.
     "id": "A String", # Identifier for this course assigned by Classroom.
@@ -577,10 +577,10 @@
         "materials": [ # Materials attached to this set.
           { # A material attached to a course as part of a material set.
             "youTubeVideo": { # YouTube video item. # Youtube video attachment.
-              "alternateLink": "A String", # URL that can be used to view the YouTube video.
+              "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
                   #
                   # Read-only.
-              "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
+              "alternateLink": "A String", # URL that can be used to view the YouTube video.
                   #
                   # Read-only.
               "id": "A String", # YouTube API resource ID.
@@ -611,10 +611,10 @@
                   # Read-only.
             },
             "form": { # Google Forms item. # Google Forms attachment.
-              "formUrl": "A String", # URL of the form.
               "thumbnailUrl": "A String", # URL of a thumbnail image of the Form.
                   #
                   # Read-only.
+              "formUrl": "A String", # URL of the form.
               "responseUrl": "A String", # URL of the form responses document.
                   # Only set if respsonses have been recorded and only when the
                   # requesting user is an editor of the form.
@@ -629,20 +629,6 @@
         "title": "A String", # Title for this set.
       },
     ],
-    "ownerId": "A String", # The identifier of the owner of a course.
-        #
-        # When specified as a parameter of a
-        # create course request, this
-        # field is required.
-        # The identifier can be one of the following:
-        #
-        # * the numeric identifier for the user
-        # * the email address of the user
-        # * the string literal `"me"`, indicating the requesting user
-        #
-        # This must be set in a create request. Admins can also specify this field
-        # in a patch course request to
-        # transfer ownership. In other contexts, it is read-only.
     "calendarId": "A String", # The Calendar ID for a calendar that all course members can see, to which
         # Classroom adds events for course work and announcements in the course.
         #
@@ -662,6 +648,20 @@
           #
           # Read-only.
     },
+    "ownerId": "A String", # The identifier of the owner of a course.
+        #
+        # When specified as a parameter of a
+        # create course request, this
+        # field is required.
+        # The identifier can be one of the following:
+        #
+        # * the numeric identifier for the user
+        # * the email address of the user
+        # * the string literal `"me"`, indicating the requesting user
+        #
+        # This must be set in a create request. Admins can also specify this field
+        # in a patch course request to
+        # transfer ownership. In other contexts, it is read-only.
     "courseState": "A String", # State of the course.
         # If unspecified, the default state is `PROVISIONED`.
     "id": "A String", # Identifier for this course assigned by Classroom.
@@ -785,10 +785,10 @@
             "materials": [ # Materials attached to this set.
               { # A material attached to a course as part of a material set.
                 "youTubeVideo": { # YouTube video item. # Youtube video attachment.
-                  "alternateLink": "A String", # URL that can be used to view the YouTube video.
+                  "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
                       #
                       # Read-only.
-                  "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
+                  "alternateLink": "A String", # URL that can be used to view the YouTube video.
                       #
                       # Read-only.
                   "id": "A String", # YouTube API resource ID.
@@ -819,10 +819,10 @@
                       # Read-only.
                 },
                 "form": { # Google Forms item. # Google Forms attachment.
-                  "formUrl": "A String", # URL of the form.
                   "thumbnailUrl": "A String", # URL of a thumbnail image of the Form.
                       #
                       # Read-only.
+                  "formUrl": "A String", # URL of the form.
                   "responseUrl": "A String", # URL of the form responses document.
                       # Only set if respsonses have been recorded and only when the
                       # requesting user is an editor of the form.
@@ -837,20 +837,6 @@
             "title": "A String", # Title for this set.
           },
         ],
-        "ownerId": "A String", # The identifier of the owner of a course.
-            #
-            # When specified as a parameter of a
-            # create course request, this
-            # field is required.
-            # The identifier can be one of the following:
-            #
-            # * the numeric identifier for the user
-            # * the email address of the user
-            # * the string literal `"me"`, indicating the requesting user
-            #
-            # This must be set in a create request. Admins can also specify this field
-            # in a patch course request to
-            # transfer ownership. In other contexts, it is read-only.
         "calendarId": "A String", # The Calendar ID for a calendar that all course members can see, to which
             # Classroom adds events for course work and announcements in the course.
             #
@@ -870,6 +856,20 @@
               #
               # Read-only.
         },
+        "ownerId": "A String", # The identifier of the owner of a course.
+            #
+            # When specified as a parameter of a
+            # create course request, this
+            # field is required.
+            # The identifier can be one of the following:
+            #
+            # * the numeric identifier for the user
+            # * the email address of the user
+            # * the string literal `"me"`, indicating the requesting user
+            #
+            # This must be set in a create request. Admins can also specify this field
+            # in a patch course request to
+            # transfer ownership. In other contexts, it is read-only.
         "courseState": "A String", # State of the course.
             # If unspecified, the default state is `PROVISIONED`.
         "id": "A String", # Identifier for this course assigned by Classroom.
@@ -910,7 +910,7 @@
 </div>
 
 <div class="method">
-    <code class="details" id="patch">patch(id, body, updateMask=None, x__xgafv=None)</code>
+    <code class="details" id="patch">patch(id, body=None, updateMask=None, x__xgafv=None)</code>
   <pre>Updates one or more fields in a course.
 
 This method returns the following error codes:
@@ -927,7 +927,7 @@
   id: string, Identifier of the course to update.
 This identifier can be either the Classroom-assigned identifier or an
 alias. (required)
-  body: object, The request body. (required)
+  body: object, The request body.
     The object takes the form of:
 
 { # A Course in Classroom.
@@ -980,10 +980,10 @@
       "materials": [ # Materials attached to this set.
         { # A material attached to a course as part of a material set.
           "youTubeVideo": { # YouTube video item. # Youtube video attachment.
-            "alternateLink": "A String", # URL that can be used to view the YouTube video.
+            "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
                 #
                 # Read-only.
-            "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
+            "alternateLink": "A String", # URL that can be used to view the YouTube video.
                 #
                 # Read-only.
             "id": "A String", # YouTube API resource ID.
@@ -1014,10 +1014,10 @@
                 # Read-only.
           },
           "form": { # Google Forms item. # Google Forms attachment.
-            "formUrl": "A String", # URL of the form.
             "thumbnailUrl": "A String", # URL of a thumbnail image of the Form.
                 #
                 # Read-only.
+            "formUrl": "A String", # URL of the form.
             "responseUrl": "A String", # URL of the form responses document.
                 # Only set if respsonses have been recorded and only when the
                 # requesting user is an editor of the form.
@@ -1032,20 +1032,6 @@
       "title": "A String", # Title for this set.
     },
   ],
-  "ownerId": "A String", # The identifier of the owner of a course.
-      # 
-      # When specified as a parameter of a
-      # create course request, this
-      # field is required.
-      # The identifier can be one of the following:
-      # 
-      # * the numeric identifier for the user
-      # * the email address of the user
-      # * the string literal `"me"`, indicating the requesting user
-      # 
-      # This must be set in a create request. Admins can also specify this field
-      # in a patch course request to
-      # transfer ownership. In other contexts, it is read-only.
   "calendarId": "A String", # The Calendar ID for a calendar that all course members can see, to which
       # Classroom adds events for course work and announcements in the course.
       # 
@@ -1065,6 +1051,20 @@
         #
         # Read-only.
   },
+  "ownerId": "A String", # The identifier of the owner of a course.
+      # 
+      # When specified as a parameter of a
+      # create course request, this
+      # field is required.
+      # The identifier can be one of the following:
+      # 
+      # * the numeric identifier for the user
+      # * the email address of the user
+      # * the string literal `"me"`, indicating the requesting user
+      # 
+      # This must be set in a create request. Admins can also specify this field
+      # in a patch course request to
+      # transfer ownership. In other contexts, it is read-only.
   "courseState": "A String", # State of the course.
       # If unspecified, the default state is `PROVISIONED`.
   "id": "A String", # Identifier for this course assigned by Classroom.
@@ -1105,7 +1105,7 @@
 
 When set in a query parameter, this field should be specified as
 
-`updateMask=<field1>,<field2>,...`
+`updateMask=&lt;field1&gt;,&lt;field2&gt;,...`
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -1164,10 +1164,10 @@
         "materials": [ # Materials attached to this set.
           { # A material attached to a course as part of a material set.
             "youTubeVideo": { # YouTube video item. # Youtube video attachment.
-              "alternateLink": "A String", # URL that can be used to view the YouTube video.
+              "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
                   #
                   # Read-only.
-              "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
+              "alternateLink": "A String", # URL that can be used to view the YouTube video.
                   #
                   # Read-only.
               "id": "A String", # YouTube API resource ID.
@@ -1198,10 +1198,10 @@
                   # Read-only.
             },
             "form": { # Google Forms item. # Google Forms attachment.
-              "formUrl": "A String", # URL of the form.
               "thumbnailUrl": "A String", # URL of a thumbnail image of the Form.
                   #
                   # Read-only.
+              "formUrl": "A String", # URL of the form.
               "responseUrl": "A String", # URL of the form responses document.
                   # Only set if respsonses have been recorded and only when the
                   # requesting user is an editor of the form.
@@ -1216,20 +1216,6 @@
         "title": "A String", # Title for this set.
       },
     ],
-    "ownerId": "A String", # The identifier of the owner of a course.
-        #
-        # When specified as a parameter of a
-        # create course request, this
-        # field is required.
-        # The identifier can be one of the following:
-        #
-        # * the numeric identifier for the user
-        # * the email address of the user
-        # * the string literal `"me"`, indicating the requesting user
-        #
-        # This must be set in a create request. Admins can also specify this field
-        # in a patch course request to
-        # transfer ownership. In other contexts, it is read-only.
     "calendarId": "A String", # The Calendar ID for a calendar that all course members can see, to which
         # Classroom adds events for course work and announcements in the course.
         #
@@ -1249,6 +1235,20 @@
           #
           # Read-only.
     },
+    "ownerId": "A String", # The identifier of the owner of a course.
+        #
+        # When specified as a parameter of a
+        # create course request, this
+        # field is required.
+        # The identifier can be one of the following:
+        #
+        # * the numeric identifier for the user
+        # * the email address of the user
+        # * the string literal `"me"`, indicating the requesting user
+        #
+        # This must be set in a create request. Admins can also specify this field
+        # in a patch course request to
+        # transfer ownership. In other contexts, it is read-only.
     "courseState": "A String", # State of the course.
         # If unspecified, the default state is `PROVISIONED`.
     "id": "A String", # Identifier for this course assigned by Classroom.
@@ -1273,7 +1273,7 @@
 </div>
 
 <div class="method">
-    <code class="details" id="update">update(id, body, x__xgafv=None)</code>
+    <code class="details" id="update">update(id, body=None, x__xgafv=None)</code>
   <pre>Updates a course.
 
 This method returns the following error codes:
@@ -1288,7 +1288,7 @@
   id: string, Identifier of the course to update.
 This identifier can be either the Classroom-assigned identifier or an
 alias. (required)
-  body: object, The request body. (required)
+  body: object, The request body.
     The object takes the form of:
 
 { # A Course in Classroom.
@@ -1341,10 +1341,10 @@
       "materials": [ # Materials attached to this set.
         { # A material attached to a course as part of a material set.
           "youTubeVideo": { # YouTube video item. # Youtube video attachment.
-            "alternateLink": "A String", # URL that can be used to view the YouTube video.
+            "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
                 #
                 # Read-only.
-            "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
+            "alternateLink": "A String", # URL that can be used to view the YouTube video.
                 #
                 # Read-only.
             "id": "A String", # YouTube API resource ID.
@@ -1375,10 +1375,10 @@
                 # Read-only.
           },
           "form": { # Google Forms item. # Google Forms attachment.
-            "formUrl": "A String", # URL of the form.
             "thumbnailUrl": "A String", # URL of a thumbnail image of the Form.
                 #
                 # Read-only.
+            "formUrl": "A String", # URL of the form.
             "responseUrl": "A String", # URL of the form responses document.
                 # Only set if respsonses have been recorded and only when the
                 # requesting user is an editor of the form.
@@ -1393,20 +1393,6 @@
       "title": "A String", # Title for this set.
     },
   ],
-  "ownerId": "A String", # The identifier of the owner of a course.
-      # 
-      # When specified as a parameter of a
-      # create course request, this
-      # field is required.
-      # The identifier can be one of the following:
-      # 
-      # * the numeric identifier for the user
-      # * the email address of the user
-      # * the string literal `"me"`, indicating the requesting user
-      # 
-      # This must be set in a create request. Admins can also specify this field
-      # in a patch course request to
-      # transfer ownership. In other contexts, it is read-only.
   "calendarId": "A String", # The Calendar ID for a calendar that all course members can see, to which
       # Classroom adds events for course work and announcements in the course.
       # 
@@ -1426,6 +1412,20 @@
         #
         # Read-only.
   },
+  "ownerId": "A String", # The identifier of the owner of a course.
+      # 
+      # When specified as a parameter of a
+      # create course request, this
+      # field is required.
+      # The identifier can be one of the following:
+      # 
+      # * the numeric identifier for the user
+      # * the email address of the user
+      # * the string literal `"me"`, indicating the requesting user
+      # 
+      # This must be set in a create request. Admins can also specify this field
+      # in a patch course request to
+      # transfer ownership. In other contexts, it is read-only.
   "courseState": "A String", # State of the course.
       # If unspecified, the default state is `PROVISIONED`.
   "id": "A String", # Identifier for this course assigned by Classroom.
@@ -1506,10 +1506,10 @@
         "materials": [ # Materials attached to this set.
           { # A material attached to a course as part of a material set.
             "youTubeVideo": { # YouTube video item. # Youtube video attachment.
-              "alternateLink": "A String", # URL that can be used to view the YouTube video.
+              "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
                   #
                   # Read-only.
-              "thumbnailUrl": "A String", # URL of a thumbnail image of the YouTube video.
+              "alternateLink": "A String", # URL that can be used to view the YouTube video.
                   #
                   # Read-only.
               "id": "A String", # YouTube API resource ID.
@@ -1540,10 +1540,10 @@
                   # Read-only.
             },
             "form": { # Google Forms item. # Google Forms attachment.
-              "formUrl": "A String", # URL of the form.
               "thumbnailUrl": "A String", # URL of a thumbnail image of the Form.
                   #
                   # Read-only.
+              "formUrl": "A String", # URL of the form.
               "responseUrl": "A String", # URL of the form responses document.
                   # Only set if respsonses have been recorded and only when the
                   # requesting user is an editor of the form.
@@ -1558,20 +1558,6 @@
         "title": "A String", # Title for this set.
       },
     ],
-    "ownerId": "A String", # The identifier of the owner of a course.
-        #
-        # When specified as a parameter of a
-        # create course request, this
-        # field is required.
-        # The identifier can be one of the following:
-        #
-        # * the numeric identifier for the user
-        # * the email address of the user
-        # * the string literal `"me"`, indicating the requesting user
-        #
-        # This must be set in a create request. Admins can also specify this field
-        # in a patch course request to
-        # transfer ownership. In other contexts, it is read-only.
     "calendarId": "A String", # The Calendar ID for a calendar that all course members can see, to which
         # Classroom adds events for course work and announcements in the course.
         #
@@ -1591,6 +1577,20 @@
           #
           # Read-only.
     },
+    "ownerId": "A String", # The identifier of the owner of a course.
+        #
+        # When specified as a parameter of a
+        # create course request, this
+        # field is required.
+        # The identifier can be one of the following:
+        #
+        # * the numeric identifier for the user
+        # * the email address of the user
+        # * the string literal `"me"`, indicating the requesting user
+        #
+        # This must be set in a create request. Admins can also specify this field
+        # in a patch course request to
+        # transfer ownership. In other contexts, it is read-only.
     "courseState": "A String", # State of the course.
         # If unspecified, the default state is `PROVISIONED`.
     "id": "A String", # Identifier for this course assigned by Classroom.