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/drive_v2.about.html b/docs/dyn/drive_v2.about.html
index a20d9b2..612d09a 100644
--- a/docs/dyn/drive_v2.about.html
+++ b/docs/dyn/drive_v2.about.html
@@ -75,119 +75,119 @@
<h1><a href="drive_v2.html">Drive API</a> . <a href="drive_v2.about.html">about</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
- <code><a href="#get">get(includeSubscribed=None, startChangeId=None, maxChangeIdCount=None)</a></code></p>
+ <code><a href="#get">get(includeSubscribed=None, maxChangeIdCount=None, startChangeId=None)</a></code></p>
<p class="firstline">Gets the information about the current user along with Drive API settings</p>
<h3>Method Details</h3>
<div class="method">
- <code class="details" id="get">get(includeSubscribed=None, startChangeId=None, maxChangeIdCount=None)</code>
+ <code class="details" id="get">get(includeSubscribed=None, maxChangeIdCount=None, startChangeId=None)</code>
<pre>Gets the information about the current user along with Drive API settings
Args:
includeSubscribed: boolean, Whether to count changes outside the My Drive hierarchy. When set to false, changes to files such as those in the Application Data folder or shared files which have not been added to My Drive will be omitted from the maxChangeIdCount.
- startChangeId: string, Change ID to start counting from when calculating number of remaining change IDs
maxChangeIdCount: string, Maximum number of remaining change IDs to count
+ startChangeId: string, Change ID to start counting from when calculating number of remaining change IDs
Returns:
An object of the form:
{ # An item with user information and settings.
- "languageCode": "A String", # The user's language or locale code, as defined by BCP 47, with some extensions from Unicode's LDML format (http://www.unicode.org/reports/tr35/).
- "quotaBytesByService": [ # The amount of storage quota used by different Google services.
+ "additionalRoleInfo": [ # Information about supported additional roles per file type. The most specific type takes precedence.
{
- "serviceName": "A String", # The service's name, e.g. DRIVE, GMAIL, or PHOTOS.
- "bytesUsed": "A String", # The storage quota bytes used by the service.
+ "roleSets": [ # The supported additional roles per primary role.
+ {
+ "additionalRoles": [ # The supported additional roles with the primary role.
+ "A String",
+ ],
+ "primaryRole": "A String", # A primary permission role.
+ },
+ ],
+ "type": "A String", # The content type that this additional role info applies to.
},
],
- "features": [ # List of additional features enabled on this account.
- {
- "featureName": "A String", # The name of the feature.
- "featureRate": 3.14, # The request limit rate for this feature, in queries per second.
- },
- ],
- "folderColorPalette": [ # The palette of allowable folder colors as RGB hex strings.
- "A String",
- ],
- "quotaBytesUsedAggregate": "A String", # The number of quota bytes used by all Google apps (Drive, Picasa, etc.).
- "permissionId": "A String", # The current user's ID as visible in the permissions collection.
- "teamDriveThemes": [ # Deprecated - use driveThemes instead.
- {
- "colorRgb": "A String", # Deprecated - use driveThemes/colorRgb instead.
- "backgroundImageLink": "A String", # Deprecated - use driveThemes/backgroundImageLink instead.
- "id": "A String", # Deprecated - use driveThemes/id instead.
- },
- ],
- "etag": "A String", # The ETag of the item.
- "largestChangeId": "A String", # The largest change id.
- "quotaBytesUsedInTrash": "A String", # The number of quota bytes used by trashed items.
- "domainSharingPolicy": "A String", # The domain sharing policy for the current user. Possible values are:
+ "canCreateDrives": True or False, # Whether the user can create shared drives.
+ "canCreateTeamDrives": True or False, # Deprecated - use canCreateDrives instead.
+ "domainSharingPolicy": "A String", # The domain sharing policy for the current user. Possible values are:
# - allowed
# - allowedWithWarning
# - incomingOnly
# - disallowed
- "isCurrentAppInstalled": True or False, # A boolean indicating whether the authenticated app is installed by the authenticated user.
- "additionalRoleInfo": [ # Information about supported additional roles per file type. The most specific type takes precedence.
+ "driveThemes": [ # A list of themes that are supported for shared drives.
{
- "roleSets": [ # The supported additional roles per primary role.
- {
- "primaryRole": "A String", # A primary permission role.
- "additionalRoles": [ # The supported additional roles with the primary role.
- "A String",
- ],
- },
+ "backgroundImageLink": "A String", # A link to this theme's background image.
+ "colorRgb": "A String", # The color of this theme as an RGB hex string.
+ "id": "A String", # The ID of the theme.
+ },
+ ],
+ "etag": "A String", # The ETag of the item.
+ "exportFormats": [ # The allowable export formats.
+ {
+ "source": "A String", # The content type to convert from.
+ "targets": [ # The possible content types to convert to.
+ "A String",
],
- "type": "A String", # The content type that this additional role info applies to.
},
],
- "driveThemes": [ # A list of themes that are supported for shared drives.
+ "features": [ # List of additional features enabled on this account.
{
- "colorRgb": "A String", # The color of this theme as an RGB hex string.
- "backgroundImageLink": "A String", # A link to this theme's background image.
- "id": "A String", # The ID of the theme.
+ "featureName": "A String", # The name of the feature.
+ "featureRate": 3.14, # The request limit rate for this feature, in queries per second.
},
],
- "quotaType": "A String", # The type of the user's storage quota. Possible values are:
+ "folderColorPalette": [ # The palette of allowable folder colors as RGB hex strings.
+ "A String",
+ ],
+ "importFormats": [ # The allowable import formats.
+ {
+ "source": "A String", # The imported file's content type to convert from.
+ "targets": [ # The possible content types to convert to.
+ "A String",
+ ],
+ },
+ ],
+ "isCurrentAppInstalled": True or False, # A boolean indicating whether the authenticated app is installed by the authenticated user.
+ "kind": "drive#about", # This is always drive#about.
+ "languageCode": "A String", # The user's language or locale code, as defined by BCP 47, with some extensions from Unicode's LDML format (http://www.unicode.org/reports/tr35/).
+ "largestChangeId": "A String", # The largest change id.
+ "maxUploadSizes": [ # List of max upload sizes for each file type. The most specific type takes precedence.
+ {
+ "size": "A String", # The max upload size for this type.
+ "type": "A String", # The file type.
+ },
+ ],
+ "name": "A String", # The name of the current user.
+ "permissionId": "A String", # The current user's ID as visible in the permissions collection.
+ "quotaBytesByService": [ # The amount of storage quota used by different Google services.
+ {
+ "bytesUsed": "A String", # The storage quota bytes used by the service.
+ "serviceName": "A String", # The service's name, e.g. DRIVE, GMAIL, or PHOTOS.
+ },
+ ],
+ "quotaBytesTotal": "A String", # The total number of quota bytes. This is only relevant when quotaType is LIMITED.
+ "quotaBytesUsed": "A String", # The number of quota bytes used by Google Drive.
+ "quotaBytesUsedAggregate": "A String", # The number of quota bytes used by all Google apps (Drive, Picasa, etc.).
+ "quotaBytesUsedInTrash": "A String", # The number of quota bytes used by trashed items.
+ "quotaType": "A String", # The type of the user's storage quota. Possible values are:
# - LIMITED
# - UNLIMITED
- "maxUploadSizes": [ # List of max upload sizes for each file type. The most specific type takes precedence.
+ "remainingChangeIds": "A String", # The number of remaining change ids, limited to no more than 2500.
+ "rootFolderId": "A String", # The id of the root folder.
+ "selfLink": "A String", # A link back to this item.
+ "teamDriveThemes": [ # Deprecated - use driveThemes instead.
{
- "type": "A String", # The file type.
- "size": "A String", # The max upload size for this type.
+ "backgroundImageLink": "A String", # Deprecated - use driveThemes/backgroundImageLink instead.
+ "colorRgb": "A String", # Deprecated - use driveThemes/colorRgb instead.
+ "id": "A String", # Deprecated - use driveThemes/id instead.
},
],
- "kind": "drive#about", # This is always drive#about.
- "name": "A String", # The name of the current user.
- "quotaBytesTotal": "A String", # The total number of quota bytes. This is only relevant when quotaType is LIMITED.
- "remainingChangeIds": "A String", # The number of remaining change ids, limited to no more than 2500.
- "importFormats": [ # The allowable import formats.
- {
- "source": "A String", # The imported file's content type to convert from.
- "targets": [ # The possible content types to convert to.
- "A String",
- ],
+ "user": { # Information about a Drive user. # The authenticated user.
+ "displayName": "A String", # A plain text displayable name for this user.
+ "emailAddress": "A String", # The email address of the user.
+ "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
+ "kind": "drive#user", # This is always drive#user.
+ "permissionId": "A String", # The user's ID as visible in the permissions collection.
+ "picture": { # The user's profile picture.
+ "url": "A String", # A URL that points to a profile picture of this user.
},
- ],
- "canCreateTeamDrives": True or False, # Deprecated - use canCreateDrives instead.
- "canCreateDrives": True or False, # Whether the user can create shared drives.
- "rootFolderId": "A String", # The id of the root folder.
- "quotaBytesUsed": "A String", # The number of quota bytes used by Google Drive.
- "exportFormats": [ # The allowable export formats.
- {
- "source": "A String", # The content type to convert from.
- "targets": [ # The possible content types to convert to.
- "A String",
- ],
- },
- ],
- "selfLink": "A String", # A link back to this item.
- "user": { # Information about a Drive user. # The authenticated user.
- "picture": { # The user's profile picture.
- "url": "A String", # A URL that points to a profile picture of this user.
- },
- "kind": "drive#user", # This is always drive#user.
- "displayName": "A String", # A plain text displayable name for this user.
- "permissionId": "A String", # The user's ID as visible in the permissions collection.
- "isAuthenticatedUser": True or False, # Whether this user is the same as the authenticated user for whom the request was made.
- "emailAddress": "A String", # The email address of the user.
},
}</pre>
</div>