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/cloudidentity_v1.groups.memberships.html b/docs/dyn/cloudidentity_v1.groups.memberships.html
index 0c358d0..21b6269 100644
--- a/docs/dyn/cloudidentity_v1.groups.memberships.html
+++ b/docs/dyn/cloudidentity_v1.groups.memberships.html
@@ -84,13 +84,13 @@
   <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
 <p class="firstline">Retrieves a Membership.</p>
 <p class="toc_element">
-  <code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None, view=None)</a></code></p>
+  <code><a href="#list">list(parent, view=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Lists Memberships within a Group.</p>
 <p class="toc_element">
   <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="#lookup">lookup(parent, memberKey_namespace=None, memberKey_id=None, x__xgafv=None)</a></code></p>
+  <code><a href="#lookup">lookup(parent, memberKey_id=None, memberKey_namespace=None, x__xgafv=None)</a></code></p>
 <p class="firstline">Looks up [resource</p>
 <h3>Method Details</h3>
 <div class="method">
@@ -105,39 +105,39 @@
     The object takes the form of:
 
 { # Resource representing a Membership within a Group
-    "updateTime": "A String", # Output only. Last updated timestamp of the Membership. Output only.
-    "preferredMemberKey": { # An EntityKey uniquely identifies an Entity. Namespaces are used to provide # Required. Immutable. EntityKey of the entity to be added as the member. Must be set while
-        # creating a Membership, read-only afterwards.
-        # 
-        # Currently allowed entity types: `Users`, `Groups`.
-        # isolation for IDs. A single ID can be reused across namespaces but the
-        # combination of a namespace and an ID must be unique.
-      "namespace": "A String", # Namespaces provide isolation for IDs, so an ID only needs to be unique
-          # within its namespace.
+  &quot;roles&quot;: [ # Roles for a member within the Group.
+      # 
+      # Currently supported MembershipRoles: `&quot;MEMBER&quot;`.
+    { # Resource representing a role within a Membership.
+      &quot;name&quot;: &quot;A String&quot;, # MembershipRole in string format.
           #
-          # Namespaces are currently only created as part of IdentitySource creation
-          # from Admin Console. A namespace `"identitysources/{identity_source_id}"` is
-          # created corresponding to every Identity Source `identity_source_id`.
-      "id": "A String", # The ID of the entity within the given namespace. The ID must be unique
-          # within its namespace.
+          # Currently supported MembershipRoles: `&quot;MEMBER&quot;`.
     },
-    "name": "A String", # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the
-        # Membership in the format: `groups/{group_id}/memberships/{member_id}`,
-        # where group_id is the unique ID assigned to the Group to which Membership
-        # belongs to, and member_id is the unique ID assigned to the member
-        # 
-        # Must be left blank while creating a Membership.
-    "roles": [ # Roles for a member within the Group.
-        # 
-        # Currently supported MembershipRoles: `"MEMBER"`.
-      { # Resource representing a role within a Membership.
-        "name": "A String", # MembershipRole in string format.
-            #
-            # Currently supported MembershipRoles: `"MEMBER"`.
-      },
-    ],
-    "createTime": "A String", # Output only. Creation timestamp of the Membership. Output only.
-  }
+  ],
+  &quot;preferredMemberKey&quot;: { # An EntityKey uniquely identifies an Entity. Namespaces are used to provide # Required. Immutable. EntityKey of the entity to be added as the member. Must be set while
+      # creating a Membership, read-only afterwards.
+      # 
+      # Currently allowed entity types: `Users`, `Groups`.
+      # isolation for IDs. A single ID can be reused across namespaces but the
+      # combination of a namespace and an ID must be unique.
+    &quot;id&quot;: &quot;A String&quot;, # The ID of the entity within the given namespace. The ID must be unique
+        # within its namespace.
+    &quot;namespace&quot;: &quot;A String&quot;, # Namespaces provide isolation for IDs, so an ID only needs to be unique
+        # within its namespace.
+        #
+        # Namespaces are currently only created as part of IdentitySource creation
+        # from Admin Console. A namespace `&quot;identitysources/{identity_source_id}&quot;` is
+        # created corresponding to every Identity Source `identity_source_id`.
+  },
+  &quot;createTime&quot;: &quot;A String&quot;, # Output only. Creation timestamp of the Membership. Output only.
+  &quot;name&quot;: &quot;A String&quot;, # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the
+      # Membership in the format: `groups/{group_id}/memberships/{member_id}`,
+      # where group_id is the unique ID assigned to the Group to which Membership
+      # belongs to, and member_id is the unique ID assigned to the member
+      # 
+      # Must be left blank while creating a Membership.
+  &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last updated timestamp of the Membership. Output only.
+}
 
   x__xgafv: string, V1 error format.
     Allowed values
@@ -149,34 +149,10 @@
 
     { # This resource represents a long-running operation that is the result of a
       # network API call.
-    "metadata": { # Service-specific metadata associated with the operation.  It typically
-        # contains progress information and common metadata such as create time.
-        # Some services might not provide such metadata.  Any method that returns a
-        # long-running operation should document the metadata type, if any.
-      "a_key": "", # Properties of the object. Contains field @type with type URL.
-    },
-    "error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
-        # different programming environments, including REST APIs and RPC APIs. It is
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-        # three pieces of data: error code, error message, and error details.
-        #
-        # You can find out more about this error model and how to work with it in the
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
-      "message": "A String", # A developer-facing error message, which should be in English. Any
-          # user-facing error message should be localized and sent in the
-          # google.rpc.Status.details field, or localized by the client.
-      "code": 42, # The status code, which should be an enum value of google.rpc.Code.
-      "details": [ # A list of messages that carry the error details.  There is a common set of
-          # message types for APIs to use.
-        {
-          "a_key": "", # Properties of the object. Contains field @type with type URL.
-        },
-      ],
-    },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress.
+    &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
         # If `true`, the operation is completed, and either `error` or `response` is
         # available.
-    "response": { # The normal response of the operation in case of success.  If the original
+    &quot;response&quot;: { # The normal response of the operation in case of success.  If the original
         # method returns no data on success, such as `Delete`, the response is
         # `google.protobuf.Empty`.  If the original method is standard
         # `Get`/`Create`/`Update`, the response should be the resource.  For other
@@ -184,11 +160,35 @@
         # is the original method name.  For example, if the original method name
         # is `TakeSnapshot()`, the inferred response type is
         # `TakeSnapshotResponse`.
-      "a_key": "", # Properties of the object. Contains field @type with type URL.
+      &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
     },
-    "name": "A String", # The server-assigned name, which is only unique within the same service that
+    &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
         # originally returns it. If you use the default HTTP mapping, the
         # `name` should be a resource name ending with `operations/{unique_id}`.
+    &quot;metadata&quot;: { # Service-specific metadata associated with the operation.  It typically
+        # contains progress information and common metadata such as create time.
+        # Some services might not provide such metadata.  Any method that returns a
+        # long-running operation should document the metadata type, if any.
+      &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
+    },
+    &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
+        # different programming environments, including REST APIs and RPC APIs. It is
+        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+        # three pieces of data: error code, error message, and error details.
+        #
+        # You can find out more about this error model and how to work with it in the
+        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
+          # user-facing error message should be localized and sent in the
+          # google.rpc.Status.details field, or localized by the client.
+      &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
+      &quot;details&quot;: [ # A list of messages that carry the error details.  There is a common set of
+          # message types for APIs to use.
+        {
+          &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
+        },
+      ],
+    },
   }</pre>
 </div>
 
@@ -213,34 +213,10 @@
 
     { # This resource represents a long-running operation that is the result of a
       # network API call.
-    "metadata": { # Service-specific metadata associated with the operation.  It typically
-        # contains progress information and common metadata such as create time.
-        # Some services might not provide such metadata.  Any method that returns a
-        # long-running operation should document the metadata type, if any.
-      "a_key": "", # Properties of the object. Contains field @type with type URL.
-    },
-    "error": { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
-        # different programming environments, including REST APIs and RPC APIs. It is
-        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
-        # three pieces of data: error code, error message, and error details.
-        #
-        # You can find out more about this error model and how to work with it in the
-        # [API Design Guide](https://cloud.google.com/apis/design/errors).
-      "message": "A String", # A developer-facing error message, which should be in English. Any
-          # user-facing error message should be localized and sent in the
-          # google.rpc.Status.details field, or localized by the client.
-      "code": 42, # The status code, which should be an enum value of google.rpc.Code.
-      "details": [ # A list of messages that carry the error details.  There is a common set of
-          # message types for APIs to use.
-        {
-          "a_key": "", # Properties of the object. Contains field @type with type URL.
-        },
-      ],
-    },
-    "done": True or False, # If the value is `false`, it means the operation is still in progress.
+    &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
         # If `true`, the operation is completed, and either `error` or `response` is
         # available.
-    "response": { # The normal response of the operation in case of success.  If the original
+    &quot;response&quot;: { # The normal response of the operation in case of success.  If the original
         # method returns no data on success, such as `Delete`, the response is
         # `google.protobuf.Empty`.  If the original method is standard
         # `Get`/`Create`/`Update`, the response should be the resource.  For other
@@ -248,11 +224,35 @@
         # is the original method name.  For example, if the original method name
         # is `TakeSnapshot()`, the inferred response type is
         # `TakeSnapshotResponse`.
-      "a_key": "", # Properties of the object. Contains field @type with type URL.
+      &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
     },
-    "name": "A String", # The server-assigned name, which is only unique within the same service that
+    &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
         # originally returns it. If you use the default HTTP mapping, the
         # `name` should be a resource name ending with `operations/{unique_id}`.
+    &quot;metadata&quot;: { # Service-specific metadata associated with the operation.  It typically
+        # contains progress information and common metadata such as create time.
+        # Some services might not provide such metadata.  Any method that returns a
+        # long-running operation should document the metadata type, if any.
+      &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
+    },
+    &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
+        # different programming environments, including REST APIs and RPC APIs. It is
+        # used by [gRPC](https://github.com/grpc). Each `Status` message contains
+        # three pieces of data: error code, error message, and error details.
+        #
+        # You can find out more about this error model and how to work with it in the
+        # [API Design Guide](https://cloud.google.com/apis/design/errors).
+      &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
+          # user-facing error message should be localized and sent in the
+          # google.rpc.Status.details field, or localized by the client.
+      &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
+      &quot;details&quot;: [ # A list of messages that carry the error details.  There is a common set of
+          # message types for APIs to use.
+        {
+          &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
+        },
+      ],
+    },
   }</pre>
 </div>
 
@@ -276,43 +276,43 @@
   An object of the form:
 
     { # Resource representing a Membership within a Group
-      "updateTime": "A String", # Output only. Last updated timestamp of the Membership. Output only.
-      "preferredMemberKey": { # An EntityKey uniquely identifies an Entity. Namespaces are used to provide # Required. Immutable. EntityKey of the entity to be added as the member. Must be set while
-          # creating a Membership, read-only afterwards.
-          #
-          # Currently allowed entity types: `Users`, `Groups`.
-          # isolation for IDs. A single ID can be reused across namespaces but the
-          # combination of a namespace and an ID must be unique.
-        "namespace": "A String", # Namespaces provide isolation for IDs, so an ID only needs to be unique
-            # within its namespace.
+    &quot;roles&quot;: [ # Roles for a member within the Group.
+        #
+        # Currently supported MembershipRoles: `&quot;MEMBER&quot;`.
+      { # Resource representing a role within a Membership.
+        &quot;name&quot;: &quot;A String&quot;, # MembershipRole in string format.
             #
-            # Namespaces are currently only created as part of IdentitySource creation
-            # from Admin Console. A namespace `"identitysources/{identity_source_id}"` is
-            # created corresponding to every Identity Source `identity_source_id`.
-        "id": "A String", # The ID of the entity within the given namespace. The ID must be unique
-            # within its namespace.
+            # Currently supported MembershipRoles: `&quot;MEMBER&quot;`.
       },
-      "name": "A String", # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the
-          # Membership in the format: `groups/{group_id}/memberships/{member_id}`,
-          # where group_id is the unique ID assigned to the Group to which Membership
-          # belongs to, and member_id is the unique ID assigned to the member
+    ],
+    &quot;preferredMemberKey&quot;: { # An EntityKey uniquely identifies an Entity. Namespaces are used to provide # Required. Immutable. EntityKey of the entity to be added as the member. Must be set while
+        # creating a Membership, read-only afterwards.
+        #
+        # Currently allowed entity types: `Users`, `Groups`.
+        # isolation for IDs. A single ID can be reused across namespaces but the
+        # combination of a namespace and an ID must be unique.
+      &quot;id&quot;: &quot;A String&quot;, # The ID of the entity within the given namespace. The ID must be unique
+          # within its namespace.
+      &quot;namespace&quot;: &quot;A String&quot;, # Namespaces provide isolation for IDs, so an ID only needs to be unique
+          # within its namespace.
           #
-          # Must be left blank while creating a Membership.
-      "roles": [ # Roles for a member within the Group.
-          #
-          # Currently supported MembershipRoles: `"MEMBER"`.
-        { # Resource representing a role within a Membership.
-          "name": "A String", # MembershipRole in string format.
-              #
-              # Currently supported MembershipRoles: `"MEMBER"`.
-        },
-      ],
-      "createTime": "A String", # Output only. Creation timestamp of the Membership. Output only.
-    }</pre>
+          # Namespaces are currently only created as part of IdentitySource creation
+          # from Admin Console. A namespace `&quot;identitysources/{identity_source_id}&quot;` is
+          # created corresponding to every Identity Source `identity_source_id`.
+    },
+    &quot;createTime&quot;: &quot;A String&quot;, # Output only. Creation timestamp of the Membership. Output only.
+    &quot;name&quot;: &quot;A String&quot;, # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the
+        # Membership in the format: `groups/{group_id}/memberships/{member_id}`,
+        # where group_id is the unique ID assigned to the Group to which Membership
+        # belongs to, and member_id is the unique ID assigned to the member
+        #
+        # Must be left blank while creating a Membership.
+    &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last updated timestamp of the Membership. Output only.
+  }</pre>
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None, view=None)</code>
+    <code class="details" id="list">list(parent, view=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
   <pre>Lists Memberships within a Group.
 
 Args:
@@ -321,6 +321,7 @@
 
 Format: `groups/{group_id}`, where `group_id` is the unique ID assigned to
 the Group. (required)
+  view: string, Membership resource view to be returned. Defaults to View.BASIC.
   pageSize: integer, The default page size is 200 (max 1000) for the BASIC view, and 50
 (max 500) for the FULL view.
   pageToken: string, The next_page_token value returned from a previous list request, if any.
@@ -328,50 +329,49 @@
     Allowed values
       1 - v1 error format
       2 - v2 error format
-  view: string, Membership resource view to be returned. Defaults to View.BASIC.
 
 Returns:
   An object of the form:
 
     {
-    "nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no
-        # more results available for listing.
-    "memberships": [ # List of Memberships.
+    &quot;memberships&quot;: [ # List of Memberships.
       { # Resource representing a Membership within a Group
-          "updateTime": "A String", # Output only. Last updated timestamp of the Membership. Output only.
-          "preferredMemberKey": { # An EntityKey uniquely identifies an Entity. Namespaces are used to provide # Required. Immutable. EntityKey of the entity to be added as the member. Must be set while
-              # creating a Membership, read-only afterwards.
-              #
-              # Currently allowed entity types: `Users`, `Groups`.
-              # isolation for IDs. A single ID can be reused across namespaces but the
-              # combination of a namespace and an ID must be unique.
-            "namespace": "A String", # Namespaces provide isolation for IDs, so an ID only needs to be unique
-                # within its namespace.
+        &quot;roles&quot;: [ # Roles for a member within the Group.
+            #
+            # Currently supported MembershipRoles: `&quot;MEMBER&quot;`.
+          { # Resource representing a role within a Membership.
+            &quot;name&quot;: &quot;A String&quot;, # MembershipRole in string format.
                 #
-                # Namespaces are currently only created as part of IdentitySource creation
-                # from Admin Console. A namespace `"identitysources/{identity_source_id}"` is
-                # created corresponding to every Identity Source `identity_source_id`.
-            "id": "A String", # The ID of the entity within the given namespace. The ID must be unique
-                # within its namespace.
+                # Currently supported MembershipRoles: `&quot;MEMBER&quot;`.
           },
-          "name": "A String", # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the
-              # Membership in the format: `groups/{group_id}/memberships/{member_id}`,
-              # where group_id is the unique ID assigned to the Group to which Membership
-              # belongs to, and member_id is the unique ID assigned to the member
+        ],
+        &quot;preferredMemberKey&quot;: { # An EntityKey uniquely identifies an Entity. Namespaces are used to provide # Required. Immutable. EntityKey of the entity to be added as the member. Must be set while
+            # creating a Membership, read-only afterwards.
+            #
+            # Currently allowed entity types: `Users`, `Groups`.
+            # isolation for IDs. A single ID can be reused across namespaces but the
+            # combination of a namespace and an ID must be unique.
+          &quot;id&quot;: &quot;A String&quot;, # The ID of the entity within the given namespace. The ID must be unique
+              # within its namespace.
+          &quot;namespace&quot;: &quot;A String&quot;, # Namespaces provide isolation for IDs, so an ID only needs to be unique
+              # within its namespace.
               #
-              # Must be left blank while creating a Membership.
-          "roles": [ # Roles for a member within the Group.
-              #
-              # Currently supported MembershipRoles: `"MEMBER"`.
-            { # Resource representing a role within a Membership.
-              "name": "A String", # MembershipRole in string format.
-                  #
-                  # Currently supported MembershipRoles: `"MEMBER"`.
-            },
-          ],
-          "createTime": "A String", # Output only. Creation timestamp of the Membership. Output only.
+              # Namespaces are currently only created as part of IdentitySource creation
+              # from Admin Console. A namespace `&quot;identitysources/{identity_source_id}&quot;` is
+              # created corresponding to every Identity Source `identity_source_id`.
         },
+        &quot;createTime&quot;: &quot;A String&quot;, # Output only. Creation timestamp of the Membership. Output only.
+        &quot;name&quot;: &quot;A String&quot;, # Output only. [Resource name](https://cloud.google.com/apis/design/resource_names) of the
+            # Membership in the format: `groups/{group_id}/memberships/{member_id}`,
+            # where group_id is the unique ID assigned to the Group to which Membership
+            # belongs to, and member_id is the unique ID assigned to the member
+            #
+            # Must be left blank while creating a Membership.
+        &quot;updateTime&quot;: &quot;A String&quot;, # Output only. Last updated timestamp of the Membership. Output only.
+      },
     ],
+    &quot;nextPageToken&quot;: &quot;A String&quot;, # Token to retrieve the next page of results, or empty if there are no
+        # more results available for listing.
   }</pre>
 </div>
 
@@ -384,16 +384,16 @@
   previous_response: The response from the request for the previous page. (required)
 
 Returns:
-  A request object that you can call 'execute()' on to request the next
+  A request object that you can call &#x27;execute()&#x27; on to request the next
   page. Returns None if there are no more items in the collection.
     </pre>
 </div>
 
 <div class="method">
-    <code class="details" id="lookup">lookup(parent, memberKey_namespace=None, memberKey_id=None, x__xgafv=None)</code>
+    <code class="details" id="lookup">lookup(parent, memberKey_id=None, memberKey_namespace=None, x__xgafv=None)</code>
   <pre>Looks up [resource
 name](https://cloud.google.com/apis/design/resource_names) of a Membership
-within a Group by member's EntityKey.
+within a Group by member&#x27;s EntityKey.
 
 Args:
   parent: string, Required. [Resource name](https://cloud.google.com/apis/design/resource_names) of the
@@ -401,14 +401,14 @@
 
 Format: `groups/{group_id}`, where `group_id` is the unique ID assigned to
 the Group. (required)
+  memberKey_id: string, The ID of the entity within the given namespace. The ID must be unique
+within its namespace.
   memberKey_namespace: string, Namespaces provide isolation for IDs, so an ID only needs to be unique
 within its namespace.
 
 Namespaces are currently only created as part of IdentitySource creation
-from Admin Console. A namespace `"identitysources/{identity_source_id}"` is
+from Admin Console. A namespace `&quot;identitysources/{identity_source_id}&quot;` is
 created corresponding to every Identity Source `identity_source_id`.
-  memberKey_id: string, The ID of the entity within the given namespace. The ID must be unique
-within its namespace.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -418,7 +418,7 @@
   An object of the form:
 
     {
-    "name": "A String", # [Resource name](https://cloud.google.com/apis/design/resource_names) of the
+    &quot;name&quot;: &quot;A String&quot;, # [Resource name](https://cloud.google.com/apis/design/resource_names) of the
         # Membership being looked up.
         #
         # Format: `groups/{group_id}/memberships/{member_id}`, where `group_id` is