build: run docs regen in synth.py (#1059)
diff --git a/docs/dyn/analyticsadmin_v1alpha.accounts.userLinks.html b/docs/dyn/analyticsadmin_v1alpha.accounts.userLinks.html
index b61f084..d323fbe 100644
--- a/docs/dyn/analyticsadmin_v1alpha.accounts.userLinks.html
+++ b/docs/dyn/analyticsadmin_v1alpha.accounts.userLinks.html
@@ -105,7 +105,7 @@
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Gets information about a user's link to an account or property.</p>
<p class="toc_element">
- <code><a href="#list">list(parent, pageToken=None, pageSize=None, x__xgafv=None)</a></code></p>
+ <code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists all user links on an account or property.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
@@ -124,8 +124,8 @@
The object takes the form of:
{ # Request message for AuditUserLinks RPC.
- "pageSize": 42, # The maximum number of user links to return. The service may return fewer than this value. If unspecified, at most 1000 user links will be returned. The maximum value is 5000; values above 5000 will be coerced to 5000.
"pageToken": "A String", # A page token, received from a previous `AuditUserLinks` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `AuditUserLinks` must match the call that provided the page token.
+ "pageSize": 42, # The maximum number of user links to return. The service may return fewer than this value. If unspecified, at most 1000 user links will be returned. The maximum value is 5000; values above 5000 will be coerced to 5000.
}
x__xgafv: string, V1 error format.
@@ -139,14 +139,14 @@
{ # Response message for AuditUserLinks RPC.
"userLinks": [ # List of AuditUserLinks. These will be ordered stably, but in an arbitrary order.
{ # Read-only resource used to summarize a principal's effective roles.
- "effectiveRoles": [ # Union of all permissions a user has at this account or property (includes direct permissions, group-inherited permissions, etc.). Format: predefinedRoles/read
- "A String",
- ],
+ "name": "A String", # Example format: properties/1234/userLinks/5678
+ "emailAddress": "A String", # Email address of the linked user
"directRoles": [ # Roles directly assigned to this user for this entity. Format: predefinedRoles/read Excludes roles that are inherited from an account (if this is for a property), group, or organization admin role.
"A String",
],
- "name": "A String", # Example format: properties/1234/userLinks/5678
- "emailAddress": "A String", # Email address of the linked user
+ "effectiveRoles": [ # Union of all permissions a user has at this account or property (includes direct permissions, group-inherited permissions, etc.). Format: predefinedRoles/read
+ "A String",
+ ],
},
],
"nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
@@ -177,17 +177,17 @@
The object takes the form of:
{ # Request message for BatchCreateUserLinks RPC.
- "notifyNewUsers": True or False, # Optional. If notify_new_users is set, then email new users that they've been given permissions on the resource.
- "requests": [ # The requests specifying the user links to create. A maximum of 1000 user links can be created in a batch.
+ "notifyNewUsers": True or False, # Optional. If set, then email the new users notifying them that they've been granted permissions to the resource. Regardless of whether this is set or not, notify_new_user field inside each individual request is ignored.
+ "requests": [ # Required. The requests specifying the user links to create. A maximum of 1000 user links can be created in a batch.
{ # Request message for CreateUserLink RPC. Users can have multiple email addresses associated with their Google account, and one of these email addresses is the "primary" email address. Any of the email addresses associated with a Google account may be used for a new UserLink, but the returned UserLink will always contain the "primary" email address. As a result, the input and output email address for this request may differ.
+ "notifyNewUser": True or False, # Optional. If set, then email the new user notifying them that they've been granted permissions to the resource.
"userLink": { # A resource message representing a user's permissions on an Account or Property resource. # Required. The user link to create.
+ "name": "A String", # Example format: properties/1234/userLinks/5678
+ "emailAddress": "A String", # Email address of the user to link
"directRoles": [ # Roles directly assigned to this user for this account or property. Valid values: predefinedRoles/read predefinedRoles/collaborate predefinedRoles/edit predefinedRoles/manage-users Excludes roles that are inherited from a higher-level entity, group, or organization admin role. A UserLink that is updated to have an empty list of direct_roles will be deleted.
"A String",
],
- "name": "A String", # Example format: properties/1234/userLinks/5678
- "emailAddress": "A String", # Email address of the user to link
},
- "notifyNewUser": True or False, # Optional. If notify_new_user is set, then email new user that they've been given permissions on the resource.
"parent": "A String", # Required. Example format: accounts/1234
},
],
@@ -204,11 +204,11 @@
{ # Response message for BatchCreateUserLinks RPC.
"userLinks": [ # The user links created.
{ # A resource message representing a user's permissions on an Account or Property resource.
+ "name": "A String", # Example format: properties/1234/userLinks/5678
+ "emailAddress": "A String", # Email address of the user to link
"directRoles": [ # Roles directly assigned to this user for this account or property. Valid values: predefinedRoles/read predefinedRoles/collaborate predefinedRoles/edit predefinedRoles/manage-users Excludes roles that are inherited from a higher-level entity, group, or organization admin role. A UserLink that is updated to have an empty list of direct_roles will be deleted.
"A String",
],
- "name": "A String", # Example format: properties/1234/userLinks/5678
- "emailAddress": "A String", # Email address of the user to link
},
],
}</pre>
@@ -224,7 +224,7 @@
The object takes the form of:
{ # Request message for BatchDeleteUserLinks RPC.
- "requests": [ # The requests specifying the user links to update. A maximum of 1000 user links can be updated in a batch.
+ "requests": [ # Required. The requests specifying the user links to update. A maximum of 1000 user links can be updated in a batch.
{ # Request message for DeleteUserLink RPC.
"name": "A String", # Required. Example format: accounts/1234/userLinks/5678
},
@@ -261,11 +261,11 @@
{ # Response message for BatchGetUserLinks RPC.
"userLinks": [ # The requested user links.
{ # A resource message representing a user's permissions on an Account or Property resource.
+ "name": "A String", # Example format: properties/1234/userLinks/5678
+ "emailAddress": "A String", # Email address of the user to link
"directRoles": [ # Roles directly assigned to this user for this account or property. Valid values: predefinedRoles/read predefinedRoles/collaborate predefinedRoles/edit predefinedRoles/manage-users Excludes roles that are inherited from a higher-level entity, group, or organization admin role. A UserLink that is updated to have an empty list of direct_roles will be deleted.
"A String",
],
- "name": "A String", # Example format: properties/1234/userLinks/5678
- "emailAddress": "A String", # Email address of the user to link
},
],
}</pre>
@@ -281,14 +281,14 @@
The object takes the form of:
{ # Request message for BatchUpdateUserLinks RPC.
- "requests": [ # The requests specifying the user links to update. A maximum of 1000 user links can be updated in a batch.
+ "requests": [ # Required. The requests specifying the user links to update. A maximum of 1000 user links can be updated in a batch.
{ # Request message for UpdateUserLink RPC.
"userLink": { # A resource message representing a user's permissions on an Account or Property resource. # Required. The user link to update.
+ "name": "A String", # Example format: properties/1234/userLinks/5678
+ "emailAddress": "A String", # Email address of the user to link
"directRoles": [ # Roles directly assigned to this user for this account or property. Valid values: predefinedRoles/read predefinedRoles/collaborate predefinedRoles/edit predefinedRoles/manage-users Excludes roles that are inherited from a higher-level entity, group, or organization admin role. A UserLink that is updated to have an empty list of direct_roles will be deleted.
"A String",
],
- "name": "A String", # Example format: properties/1234/userLinks/5678
- "emailAddress": "A String", # Email address of the user to link
},
},
],
@@ -305,11 +305,11 @@
{ # Response message for BatchUpdateUserLinks RPC.
"userLinks": [ # The user links updated.
{ # A resource message representing a user's permissions on an Account or Property resource.
+ "name": "A String", # Example format: properties/1234/userLinks/5678
+ "emailAddress": "A String", # Email address of the user to link
"directRoles": [ # Roles directly assigned to this user for this account or property. Valid values: predefinedRoles/read predefinedRoles/collaborate predefinedRoles/edit predefinedRoles/manage-users Excludes roles that are inherited from a higher-level entity, group, or organization admin role. A UserLink that is updated to have an empty list of direct_roles will be deleted.
"A String",
],
- "name": "A String", # Example format: properties/1234/userLinks/5678
- "emailAddress": "A String", # Email address of the user to link
},
],
}</pre>
@@ -330,14 +330,14 @@
The object takes the form of:
{ # A resource message representing a user's permissions on an Account or Property resource.
+ "name": "A String", # Example format: properties/1234/userLinks/5678
+ "emailAddress": "A String", # Email address of the user to link
"directRoles": [ # Roles directly assigned to this user for this account or property. Valid values: predefinedRoles/read predefinedRoles/collaborate predefinedRoles/edit predefinedRoles/manage-users Excludes roles that are inherited from a higher-level entity, group, or organization admin role. A UserLink that is updated to have an empty list of direct_roles will be deleted.
"A String",
],
- "name": "A String", # Example format: properties/1234/userLinks/5678
- "emailAddress": "A String", # Email address of the user to link
}
- notifyNewUser: boolean, Optional. If notify_new_user is set, then email new user that they've been given permissions on the resource.
+ notifyNewUser: boolean, Optional. If set, then email the new user notifying them that they've been granted permissions to the resource.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -347,11 +347,11 @@
An object of the form:
{ # A resource message representing a user's permissions on an Account or Property resource.
+ "name": "A String", # Example format: properties/1234/userLinks/5678
+ "emailAddress": "A String", # Email address of the user to link
"directRoles": [ # Roles directly assigned to this user for this account or property. Valid values: predefinedRoles/read predefinedRoles/collaborate predefinedRoles/edit predefinedRoles/manage-users Excludes roles that are inherited from a higher-level entity, group, or organization admin role. A UserLink that is updated to have an empty list of direct_roles will be deleted.
"A String",
],
- "name": "A String", # Example format: properties/1234/userLinks/5678
- "emailAddress": "A String", # Email address of the user to link
}</pre>
</div>
@@ -388,22 +388,22 @@
An object of the form:
{ # A resource message representing a user's permissions on an Account or Property resource.
+ "name": "A String", # Example format: properties/1234/userLinks/5678
+ "emailAddress": "A String", # Email address of the user to link
"directRoles": [ # Roles directly assigned to this user for this account or property. Valid values: predefinedRoles/read predefinedRoles/collaborate predefinedRoles/edit predefinedRoles/manage-users Excludes roles that are inherited from a higher-level entity, group, or organization admin role. A UserLink that is updated to have an empty list of direct_roles will be deleted.
"A String",
],
- "name": "A String", # Example format: properties/1234/userLinks/5678
- "emailAddress": "A String", # Email address of the user to link
}</pre>
</div>
<div class="method">
- <code class="details" id="list">list(parent, pageToken=None, pageSize=None, x__xgafv=None)</code>
+ <code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
<pre>Lists all user links on an account or property.
Args:
parent: string, Required. Example format: accounts/1234 (required)
- pageToken: string, A page token, received from a previous `ListUserLinks` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUserLinks` must match the call that provided the page token.
pageSize: integer, The maximum number of user links to return. The service may return fewer than this value. If unspecified, at most 200 user links will be returned. The maximum value is 500; values above 500 will be coerced to 500.
+ pageToken: string, A page token, received from a previous `ListUserLinks` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListUserLinks` must match the call that provided the page token.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -413,16 +413,16 @@
An object of the form:
{ # Response message for ListUserLinks RPC.
- "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
"userLinks": [ # List of UserLinks. These will be ordered stably, but in an arbitrary order.
{ # A resource message representing a user's permissions on an Account or Property resource.
+ "name": "A String", # Example format: properties/1234/userLinks/5678
+ "emailAddress": "A String", # Email address of the user to link
"directRoles": [ # Roles directly assigned to this user for this account or property. Valid values: predefinedRoles/read predefinedRoles/collaborate predefinedRoles/edit predefinedRoles/manage-users Excludes roles that are inherited from a higher-level entity, group, or organization admin role. A UserLink that is updated to have an empty list of direct_roles will be deleted.
"A String",
],
- "name": "A String", # Example format: properties/1234/userLinks/5678
- "emailAddress": "A String", # Email address of the user to link
},
],
+ "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
}</pre>
</div>
@@ -450,11 +450,11 @@
The object takes the form of:
{ # A resource message representing a user's permissions on an Account or Property resource.
+ "name": "A String", # Example format: properties/1234/userLinks/5678
+ "emailAddress": "A String", # Email address of the user to link
"directRoles": [ # Roles directly assigned to this user for this account or property. Valid values: predefinedRoles/read predefinedRoles/collaborate predefinedRoles/edit predefinedRoles/manage-users Excludes roles that are inherited from a higher-level entity, group, or organization admin role. A UserLink that is updated to have an empty list of direct_roles will be deleted.
"A String",
],
- "name": "A String", # Example format: properties/1234/userLinks/5678
- "emailAddress": "A String", # Email address of the user to link
}
x__xgafv: string, V1 error format.
@@ -466,11 +466,11 @@
An object of the form:
{ # A resource message representing a user's permissions on an Account or Property resource.
+ "name": "A String", # Example format: properties/1234/userLinks/5678
+ "emailAddress": "A String", # Email address of the user to link
"directRoles": [ # Roles directly assigned to this user for this account or property. Valid values: predefinedRoles/read predefinedRoles/collaborate predefinedRoles/edit predefinedRoles/manage-users Excludes roles that are inherited from a higher-level entity, group, or organization admin role. A UserLink that is updated to have an empty list of direct_roles will be deleted.
"A String",
],
- "name": "A String", # Example format: properties/1234/userLinks/5678
- "emailAddress": "A String", # Email address of the user to link
}</pre>
</div>