docs: docs update (#911)

Thank you for opening a Pull Request! Before submitting your PR, there are a few things you can do to make sure it goes smoothly:
- [ ] Make sure to open an issue as a [bug/issue](https://github.com/googleapis/google-api-python-client/issues/new/choose) before writing your code!  That way we can discuss the change, evaluate designs, and agree on the general idea
- [ ] Ensure the tests and linter pass
- [ ] Code coverage does not decrease (if any source code was changed)
- [ ] Appropriate docs were updated (if necessary)

Fixes #<issue_number_goes_here> 🦕
diff --git a/docs/dyn/analytics_v3.management.segments.html b/docs/dyn/analytics_v3.management.segments.html
index e4949bf..599d062 100644
--- a/docs/dyn/analytics_v3.management.segments.html
+++ b/docs/dyn/analytics_v3.management.segments.html
@@ -75,41 +75,41 @@
 <h1><a href="analytics_v3.html">Google Analytics API</a> . <a href="analytics_v3.management.html">management</a> . <a href="analytics_v3.management.segments.html">segments</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#list">list(max_results=None, start_index=None)</a></code></p>
+  <code><a href="#list">list(start_index=None, max_results=None)</a></code></p>
 <p class="firstline">Lists segments to which the user has access.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="list">list(max_results=None, start_index=None)</code>
+    <code class="details" id="list">list(start_index=None, max_results=None)</code>
   <pre>Lists segments to which the user has access.
 
 Args:
-  max_results: integer, The maximum number of segments to include in this response.
   start_index: integer, An index of the first segment to retrieve. Use this parameter as a pagination mechanism along with the max-results parameter.
+  max_results: integer, The maximum number of segments to include in this response.
 
 Returns:
   An object of the form:
 
     { # An segment collection lists Analytics segments that the user has access to. Each resource in the collection corresponds to a single Analytics segment.
-    "username": "A String", # Email ID of the authenticated user
-    "kind": "analytics#segments", # Collection type for segments.
-    "items": [ # A list of segments.
+    &quot;username&quot;: &quot;A String&quot;, # Email ID of the authenticated user
+    &quot;startIndex&quot;: 42, # The starting index of the resources, which is 1 by default or otherwise specified by the start-index query parameter.
+    &quot;itemsPerPage&quot;: 42, # The maximum number of resources the response can contain, regardless of the actual number of resources returned. Its value ranges from 1 to 1000 with a value of 1000 by default, or otherwise specified by the max-results query parameter.
+    &quot;kind&quot;: &quot;analytics#segments&quot;, # Collection type for segments.
+    &quot;nextLink&quot;: &quot;A String&quot;, # Link to next page for this segment collection.
+    &quot;previousLink&quot;: &quot;A String&quot;, # Link to previous page for this segment collection.
+    &quot;totalResults&quot;: 42, # The total number of results for the query, regardless of the number of results in the response.
+    &quot;items&quot;: [ # A list of segments.
       { # JSON template for an Analytics segment.
-        "definition": "A String", # Segment definition.
-        "kind": "analytics#segment", # Resource type for Analytics segment.
-        "name": "A String", # Segment name.
-        "created": "A String", # Time the segment was created.
-        "updated": "A String", # Time the segment was last modified.
-        "type": "A String", # Type for a segment. Possible values are "BUILT_IN" or "CUSTOM".
-        "id": "A String", # Segment ID.
-        "selfLink": "A String", # Link for this segment.
-        "segmentId": "A String", # Segment ID. Can be used with the 'segment' parameter in Core Reporting API.
+        &quot;kind&quot;: &quot;analytics#segment&quot;, # Resource type for Analytics segment.
+        &quot;created&quot;: &quot;A String&quot;, # Time the segment was created.
+        &quot;name&quot;: &quot;A String&quot;, # Segment name.
+        &quot;segmentId&quot;: &quot;A String&quot;, # Segment ID. Can be used with the &#x27;segment&#x27; parameter in Core Reporting API.
+        &quot;type&quot;: &quot;A String&quot;, # Type for a segment. Possible values are &quot;BUILT_IN&quot; or &quot;CUSTOM&quot;.
+        &quot;selfLink&quot;: &quot;A String&quot;, # Link for this segment.
+        &quot;id&quot;: &quot;A String&quot;, # Segment ID.
+        &quot;updated&quot;: &quot;A String&quot;, # Time the segment was last modified.
+        &quot;definition&quot;: &quot;A String&quot;, # Segment definition.
       },
     ],
-    "itemsPerPage": 42, # The maximum number of resources the response can contain, regardless of the actual number of resources returned. Its value ranges from 1 to 1000 with a value of 1000 by default, or otherwise specified by the max-results query parameter.
-    "previousLink": "A String", # Link to previous page for this segment collection.
-    "startIndex": 42, # The starting index of the resources, which is 1 by default or otherwise specified by the start-index query parameter.
-    "nextLink": "A String", # Link to next page for this segment collection.
-    "totalResults": 42, # The total number of results for the query, regardless of the number of results in the response.
   }</pre>
 </div>