chore: regens API reference docs (#889)
diff --git a/docs/dyn/drive_v3.permissions.html b/docs/dyn/drive_v3.permissions.html
index 5caebe3..df2239e 100644
--- a/docs/dyn/drive_v3.permissions.html
+++ b/docs/dyn/drive_v3.permissions.html
@@ -75,7 +75,7 @@
<h1><a href="drive_v3.html">Drive API</a> . <a href="drive_v3.permissions.html">permissions</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
- <code><a href="#create">create(fileId, body, sendNotificationEmail=None, supportsTeamDrives=None, supportsAllDrives=None, transferOwnership=None, emailMessage=None, useDomainAdminAccess=None)</a></code></p>
+ <code><a href="#create">create(fileId, body=None, moveToNewOwnersRoot=None, enforceSingleParent=None, sendNotificationEmail=None, supportsTeamDrives=None, supportsAllDrives=None, transferOwnership=None, emailMessage=None, useDomainAdminAccess=None)</a></code></p>
<p class="firstline">Creates a permission for a file or shared drive.</p>
<p class="toc_element">
<code><a href="#delete">delete(fileId, permissionId, supportsTeamDrives=None, supportsAllDrives=None, useDomainAdminAccess=None)</a></code></p>
@@ -90,21 +90,25 @@
<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="#update">update(fileId, permissionId, body, removeExpiration=None, supportsTeamDrives=None, supportsAllDrives=None, useDomainAdminAccess=None, transferOwnership=None)</a></code></p>
+ <code><a href="#update">update(fileId, permissionId, body=None, removeExpiration=None, supportsTeamDrives=None, supportsAllDrives=None, useDomainAdminAccess=None, transferOwnership=None)</a></code></p>
<p class="firstline">Updates a permission with patch semantics.</p>
<h3>Method Details</h3>
<div class="method">
- <code class="details" id="create">create(fileId, body, sendNotificationEmail=None, supportsTeamDrives=None, supportsAllDrives=None, transferOwnership=None, emailMessage=None, useDomainAdminAccess=None)</code>
+ <code class="details" id="create">create(fileId, body=None, moveToNewOwnersRoot=None, enforceSingleParent=None, sendNotificationEmail=None, supportsTeamDrives=None, supportsAllDrives=None, transferOwnership=None, emailMessage=None, useDomainAdminAccess=None)</code>
<pre>Creates a permission for a file or shared drive.
Args:
fileId: string, The ID of the file or shared drive. (required)
- body: object, The request body. (required)
+ body: object, The request body.
The object takes the form of:
{ # A permission for a file. A permission grants a user, group, domain or the world access to a file or a folder hierarchy.
"domain": "A String", # The domain to which this permission refers.
- "displayName": "A String", # A displayable name for users, groups or domains.
+ "displayName": "A String", # The "pretty" name of the value of the permission. The following is a list of examples for each type of permission:
+ # - user - User's full name, as defined for their Google account, such as "Joe Smith."
+ # - group - Name of the Google Group, such as "The Company Administrators."
+ # - domain - String domain name, such as "thecompany.com."
+ # - anyone - No displayName is present.
"teamDrivePermissionDetails": [ # Deprecated - use permissionDetails instead.
{
"inheritedFrom": "A String", # Deprecated - use permissionDetails/inheritedFrom instead.
@@ -126,7 +130,7 @@
# - writer
# - commenter
# - reader
- "inheritedFrom": "A String", # The ID of the item from which this permission is inherited. This is an output-only field and is only populated for members of the shared drive.
+ "inheritedFrom": "A String", # The ID of the item from which this permission is inherited. This is an output-only field.
"permissionType": "A String", # The permission type for this user. While new values may be added in future, the following are currently possible:
# - file
# - member
@@ -148,10 +152,12 @@
# - user
# - group
# - domain
- # - anyone
- "id": "A String", # The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId.
+ # - anyone When creating a permission, if type is user or group, you must provide an emailAddress for the user or group. When type is domain, you must provide a domain. There isn't extra information required for a anyone type.
+ "id": "A String", # The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId. IDs should be treated as opaque values.
}
+ moveToNewOwnersRoot: boolean, This parameter only takes effect if the item is not in a shared drive and the request is attempting to transfer the ownership of the item. When set to true, the item is moved to the new owner's My Drive root folder and all prior parents removed. If set to false, when enforceSingleParent=true, parents are not changed. If set to false, when enforceSingleParent=false, existing parents are not changed; however, the file will be added to the new owner's My Drive root folder, unless it is already in the new owner's My Drive.
+ enforceSingleParent: boolean, Set to true to opt in to API behavior that aims for all items to have exactly one parent. This parameter only takes effect if the item is not in a shared drive. See moveToNewOwnersRoot for details.
sendNotificationEmail: boolean, Whether to send a notification email when sharing to users or groups. This defaults to true for users and groups, and is not allowed for other requests. It must not be disabled for ownership transfers.
supportsTeamDrives: boolean, Deprecated use supportsAllDrives instead.
supportsAllDrives: boolean, Deprecated - Whether the requesting application supports both My Drives and shared drives. This parameter will only be effective until June 1, 2020. Afterwards all applications are assumed to support shared drives.
@@ -164,7 +170,11 @@
{ # A permission for a file. A permission grants a user, group, domain or the world access to a file or a folder hierarchy.
"domain": "A String", # The domain to which this permission refers.
- "displayName": "A String", # A displayable name for users, groups or domains.
+ "displayName": "A String", # The "pretty" name of the value of the permission. The following is a list of examples for each type of permission:
+ # - user - User's full name, as defined for their Google account, such as "Joe Smith."
+ # - group - Name of the Google Group, such as "The Company Administrators."
+ # - domain - String domain name, such as "thecompany.com."
+ # - anyone - No displayName is present.
"teamDrivePermissionDetails": [ # Deprecated - use permissionDetails instead.
{
"inheritedFrom": "A String", # Deprecated - use permissionDetails/inheritedFrom instead.
@@ -186,7 +196,7 @@
# - writer
# - commenter
# - reader
- "inheritedFrom": "A String", # The ID of the item from which this permission is inherited. This is an output-only field and is only populated for members of the shared drive.
+ "inheritedFrom": "A String", # The ID of the item from which this permission is inherited. This is an output-only field.
"permissionType": "A String", # The permission type for this user. While new values may be added in future, the following are currently possible:
# - file
# - member
@@ -208,8 +218,8 @@
# - user
# - group
# - domain
- # - anyone
- "id": "A String", # The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId.
+ # - anyone When creating a permission, if type is user or group, you must provide an emailAddress for the user or group. When type is domain, you must provide a domain. There isn't extra information required for a anyone type.
+ "id": "A String", # The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId. IDs should be treated as opaque values.
}</pre>
</div>
@@ -242,7 +252,11 @@
{ # A permission for a file. A permission grants a user, group, domain or the world access to a file or a folder hierarchy.
"domain": "A String", # The domain to which this permission refers.
- "displayName": "A String", # A displayable name for users, groups or domains.
+ "displayName": "A String", # The "pretty" name of the value of the permission. The following is a list of examples for each type of permission:
+ # - user - User's full name, as defined for their Google account, such as "Joe Smith."
+ # - group - Name of the Google Group, such as "The Company Administrators."
+ # - domain - String domain name, such as "thecompany.com."
+ # - anyone - No displayName is present.
"teamDrivePermissionDetails": [ # Deprecated - use permissionDetails instead.
{
"inheritedFrom": "A String", # Deprecated - use permissionDetails/inheritedFrom instead.
@@ -264,7 +278,7 @@
# - writer
# - commenter
# - reader
- "inheritedFrom": "A String", # The ID of the item from which this permission is inherited. This is an output-only field and is only populated for members of the shared drive.
+ "inheritedFrom": "A String", # The ID of the item from which this permission is inherited. This is an output-only field.
"permissionType": "A String", # The permission type for this user. While new values may be added in future, the following are currently possible:
# - file
# - member
@@ -286,8 +300,8 @@
# - user
# - group
# - domain
- # - anyone
- "id": "A String", # The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId.
+ # - anyone When creating a permission, if type is user or group, you must provide an emailAddress for the user or group. When type is domain, you must provide a domain. There isn't extra information required for a anyone type.
+ "id": "A String", # The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId. IDs should be treated as opaque values.
}</pre>
</div>
@@ -312,7 +326,11 @@
"permissions": [ # The list of permissions. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.
{ # A permission for a file. A permission grants a user, group, domain or the world access to a file or a folder hierarchy.
"domain": "A String", # The domain to which this permission refers.
- "displayName": "A String", # A displayable name for users, groups or domains.
+ "displayName": "A String", # The "pretty" name of the value of the permission. The following is a list of examples for each type of permission:
+ # - user - User's full name, as defined for their Google account, such as "Joe Smith."
+ # - group - Name of the Google Group, such as "The Company Administrators."
+ # - domain - String domain name, such as "thecompany.com."
+ # - anyone - No displayName is present.
"teamDrivePermissionDetails": [ # Deprecated - use permissionDetails instead.
{
"inheritedFrom": "A String", # Deprecated - use permissionDetails/inheritedFrom instead.
@@ -334,7 +352,7 @@
# - writer
# - commenter
# - reader
- "inheritedFrom": "A String", # The ID of the item from which this permission is inherited. This is an output-only field and is only populated for members of the shared drive.
+ "inheritedFrom": "A String", # The ID of the item from which this permission is inherited. This is an output-only field.
"permissionType": "A String", # The permission type for this user. While new values may be added in future, the following are currently possible:
# - file
# - member
@@ -356,8 +374,8 @@
# - user
# - group
# - domain
- # - anyone
- "id": "A String", # The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId.
+ # - anyone When creating a permission, if type is user or group, you must provide an emailAddress for the user or group. When type is domain, you must provide a domain. There isn't extra information required for a anyone type.
+ "id": "A String", # The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId. IDs should be treated as opaque values.
},
],
}</pre>
@@ -378,18 +396,22 @@
</div>
<div class="method">
- <code class="details" id="update">update(fileId, permissionId, body, removeExpiration=None, supportsTeamDrives=None, supportsAllDrives=None, useDomainAdminAccess=None, transferOwnership=None)</code>
+ <code class="details" id="update">update(fileId, permissionId, body=None, removeExpiration=None, supportsTeamDrives=None, supportsAllDrives=None, useDomainAdminAccess=None, transferOwnership=None)</code>
<pre>Updates a permission with patch semantics.
Args:
fileId: string, The ID of the file or shared drive. (required)
permissionId: string, The ID of the permission. (required)
- body: object, The request body. (required)
+ body: object, The request body.
The object takes the form of:
{ # A permission for a file. A permission grants a user, group, domain or the world access to a file or a folder hierarchy.
"domain": "A String", # The domain to which this permission refers.
- "displayName": "A String", # A displayable name for users, groups or domains.
+ "displayName": "A String", # The "pretty" name of the value of the permission. The following is a list of examples for each type of permission:
+ # - user - User's full name, as defined for their Google account, such as "Joe Smith."
+ # - group - Name of the Google Group, such as "The Company Administrators."
+ # - domain - String domain name, such as "thecompany.com."
+ # - anyone - No displayName is present.
"teamDrivePermissionDetails": [ # Deprecated - use permissionDetails instead.
{
"inheritedFrom": "A String", # Deprecated - use permissionDetails/inheritedFrom instead.
@@ -411,7 +433,7 @@
# - writer
# - commenter
# - reader
- "inheritedFrom": "A String", # The ID of the item from which this permission is inherited. This is an output-only field and is only populated for members of the shared drive.
+ "inheritedFrom": "A String", # The ID of the item from which this permission is inherited. This is an output-only field.
"permissionType": "A String", # The permission type for this user. While new values may be added in future, the following are currently possible:
# - file
# - member
@@ -433,8 +455,8 @@
# - user
# - group
# - domain
- # - anyone
- "id": "A String", # The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId.
+ # - anyone When creating a permission, if type is user or group, you must provide an emailAddress for the user or group. When type is domain, you must provide a domain. There isn't extra information required for a anyone type.
+ "id": "A String", # The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId. IDs should be treated as opaque values.
}
removeExpiration: boolean, Whether to remove the expiration date.
@@ -448,7 +470,11 @@
{ # A permission for a file. A permission grants a user, group, domain or the world access to a file or a folder hierarchy.
"domain": "A String", # The domain to which this permission refers.
- "displayName": "A String", # A displayable name for users, groups or domains.
+ "displayName": "A String", # The "pretty" name of the value of the permission. The following is a list of examples for each type of permission:
+ # - user - User's full name, as defined for their Google account, such as "Joe Smith."
+ # - group - Name of the Google Group, such as "The Company Administrators."
+ # - domain - String domain name, such as "thecompany.com."
+ # - anyone - No displayName is present.
"teamDrivePermissionDetails": [ # Deprecated - use permissionDetails instead.
{
"inheritedFrom": "A String", # Deprecated - use permissionDetails/inheritedFrom instead.
@@ -470,7 +496,7 @@
# - writer
# - commenter
# - reader
- "inheritedFrom": "A String", # The ID of the item from which this permission is inherited. This is an output-only field and is only populated for members of the shared drive.
+ "inheritedFrom": "A String", # The ID of the item from which this permission is inherited. This is an output-only field.
"permissionType": "A String", # The permission type for this user. While new values may be added in future, the following are currently possible:
# - file
# - member
@@ -492,8 +518,8 @@
# - user
# - group
# - domain
- # - anyone
- "id": "A String", # The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId.
+ # - anyone When creating a permission, if type is user or group, you must provide an emailAddress for the user or group. When type is domain, you must provide a domain. There isn't extra information required for a anyone type.
+ "id": "A String", # The ID of this permission. This is a unique identifier for the grantee, and is published in User resources as permissionId. IDs should be treated as opaque values.
}</pre>
</div>