{"openapi":"3.0.0","info":{"description":"File storage","version":[{"name":"v3","value":"v3"}]},"servers":[{"description":"File storage","url":"https://api.apirails.com/googledrive"}],"paths":{"/drive/v3/about":{"get":{"tags":["About"],"parameters":[{"name":"fields","in":"query","description":"Required. The paths of the fields you want included in the response, e.g. '*' or 'comments'. If omitted the method returns 400 ('The fields parameter is required for this method'). See https://developers.google.com/drive/api/guides/fields-sharing.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/about/get","api_endpoint":"https://www.googleapis.com/drive/v3/about"},"summary":"Gets information about the user the user's Drive and system capabilities.","description":"Gets information about the user the user's Drive and system capabilities.","security":[{"bearerAuth":[]}]}},"/drive/v3/apps/{app_id}":{"get":{"tags":["Apps"],"parameters":[{"name":"app_id","in":"path","description":"The ID of the app","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/apps/get","api_endpoint":"https://www.googleapis.com/drive/v3/apps/{app_id}"},"summary":"Gets a specific app.","description":"Gets a specific app.","security":[{"bearerAuth":[]}]}},"/drive/v3/apps":{"get":{"tags":["Apps"],"parameters":[{"name":"appFilterExtensions","in":"query","description":"A comma-separated list of file extensions to limit returned results. All results within the given app query scope which can open any of the given file extensions are included in the response. If appFilterMimeTypes are provided as well, the result is a union of the two resulting app lists.","schema":{"type":"string","example":""}},{"name":"appFilterMimeTypes","in":"query","description":"A comma-separated list of file extensions to limit returned results. All results within the given app query scope which can open any of the given MIME types will be included in the response. If appFilterExtensions are provided as well, the result is a union of the two resulting app lists.","schema":{"type":"string","example":""}},{"name":"languageCode","in":"query","description":"A language or locale code, as defined by BCP 47, with some extensions from Unicode's LDML format (http://www.unicode.org/reports/tr35/).","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/apps/list","api_endpoint":"https://www.googleapis.com/drive/v3/apps"},"summary":"Lists a user's installed apps.","description":"Lists a user's installed apps.","security":[{"bearerAuth":[]}]}},"/drive/v3/changes/startPageToken":{"get":{"tags":["Changes"],"parameters":[{"name":"driveId","in":"query","description":"The ID of the shared drive for which the starting pageToken for listing future changes from that shared drive is returned","schema":{"type":"string","example":""}},{"name":"supportsAllDrives","in":"query","description":"Whether the requesting application supports both My Drives and shared drives","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/changes/getStartPageToken","api_endpoint":"https://www.googleapis.com/drive/v3/changes/startPageToken"},"summary":"Gets the starting pageToken for listing future changes.","description":"Gets the starting pageToken for listing future changes.","security":[{"bearerAuth":[]}]}},"/drive/v3/changes":{"get":{"tags":["Changes"],"parameters":[{"name":"driveId","in":"query","description":"The shared drive from which changes are returned","schema":{"type":"string","example":""}},{"name":"includeCorpusRemovals","in":"query","description":"Whether changes should include the file resource if the file is still accessible by the user at the time of the request even when a file was removed from the list of changes and there will be no further change entries for this file","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"includeItemsFromAllDrives","in":"query","description":"Whether both My Drive and shared drive items should be included in results","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"includeLabels","in":"query","description":"A comma-separated list of IDs of labels to include in the labelInfo part of the response","schema":{"type":"string","example":""}},{"name":"includePermissionsForView","in":"query","description":"Specifies which additional view's permissions to include in the response","schema":{"type":"string","example":""}},{"name":"includeRemoved","in":"query","description":"Whether to include changes indicating that items have been removed from the list of changes for example by deletion or loss of access","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"pageSize","in":"query","description":"The maximum number of changes to return per page","schema":{"type":"integer","example":""}},{"name":"pageToken","in":"query","description":"The token for continuing a previous list request on the next page","required":true,"schema":{"type":"string","example":""}},{"name":"restrictToMyDrive","in":"query","description":"Whether to restrict the results to changes inside the My Drive hierarchy","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"spaces","in":"query","description":"A comma-separated list of spaces to query within the corpora","schema":{"type":"string","example":""}},{"name":"supportsAllDrives","in":"query","description":"Whether the requesting application supports both My Drives and shared drives","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/changes/list","api_endpoint":"https://www.googleapis.com/drive/v3/changes"},"summary":"Lists the changes for a user or shared drive.","description":"Lists the changes for a user or shared drive.","security":[{"bearerAuth":[]}]}},"/drive/v3/changes/watch":{"post":{"tags":["Changes"],"parameters":[{"name":"driveId","in":"query","description":"The shared drive from which changes are returned","schema":{"type":"string","example":""}},{"name":"includeCorpusRemovals","in":"query","description":"Whether changes should include the file resource if the file is still accessible by the user at the time of the request even when a file was removed from the list of changes and there will be no further change entries for this file","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"includeItemsFromAllDrives","in":"query","description":"Whether both My Drive and shared drive items should be included in results","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"includeLabels","in":"query","description":"A comma-separated list of IDs of labels to include in the labelInfo part of the response","schema":{"type":"string","example":""}},{"name":"includePermissionsForView","in":"query","description":"Specifies which additional view's permissions to include in the response","schema":{"type":"string","example":""}},{"name":"includeRemoved","in":"query","description":"Whether to include changes indicating that items have been removed from the list of changes for example by deletion or loss of access","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"pageSize","in":"query","description":"The maximum number of changes to return per page","schema":{"type":"integer","example":""}},{"name":"pageToken","in":"query","description":"The token for continuing a previous list request on the next page","required":true,"schema":{"type":"string","example":""}},{"name":"restrictToMyDrive","in":"query","description":"Whether to restrict the results to changes inside the My Drive hierarchy","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"spaces","in":"query","description":"A comma-separated list of spaces to query within the corpora","schema":{"type":"string","example":""}},{"name":"supportsAllDrives","in":"query","description":"Whether the requesting application supports both My Drives and shared drives","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/changes/watch","api_endpoint":"https://www.googleapis.com/drive/v3/changes/watch"},"summary":"Subscribes to changes for a user.","description":"Subscribes to changes for a user.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"type":{"type":"string","description":"The type of delivery mechanism used for this channel. Valid values are 'web_hook' or 'webhook'.","required":true},"params":{"type":"object","description":"Additional parameters controlling delivery channel behavior. An object containing a list of 'key': value pairs. Example: { 'name': 'wrench', 'mass': '1.3kg', 'count': '3' }.","properties":{}},"address":{"type":"string","description":"The address where notifications are delivered for this channel.","required":true},"expiration":{"type":"string","description":"Date and time of notification channel expiration, expressed as a Unix timestamp, in milliseconds."},"id":{"type":"string","description":"A UUID or similar unique string that identifies this channel.","required":true},"kind":{"type":"string","description":"Identifies this as a notification channel used to watch for changes to a resource, which is api#channel.","required":true},"payload":{"type":"boolean","description":"A Boolean value to indicate whether payload is wanted.","enum":[true,false]},"resourceId":{"type":"string","description":"An opaque ID that identifies the resource being watched on this channel. Stable across different API versions.","required":true},"resourceUri":{"type":"string","description":"A version-specific identifier for the watched resource.","required":true},"token":{"type":"string","description":"An arbitrary string delivered to the target address with each notification delivered over this channel."}}},"example":{"type":"","params":{},"address":"","expiration":"","id":"","kind":"","payload":"","resourceId":"","resourceUri":"","token":""}}}}}},"/drive/v3/channels/stop":{"post":{"tags":["Channels"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/channels/stop","api_endpoint":"https://www.googleapis.com/drive/v3/channels/stop"},"summary":"Stop watching resources through this channel.","description":"Stop watching resources through this channel.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"type":{"type":"string","description":"The type of delivery mechanism used for this channel. Valid values are 'web_hook' or 'webhook'.","required":true},"params":{"type":"object","description":"Additional parameters controlling delivery channel behavior. An object containing a list of 'key': value pairs. Example: { 'name': 'wrench', 'mass': '1.3kg', 'count': '3' }.","properties":{}},"address":{"type":"string","description":"The address where notifications are delivered for this channel.","required":true},"expiration":{"type":"string","description":"Date and time of notification channel expiration, expressed as a Unix timestamp, in milliseconds."},"id":{"type":"string","description":"A UUID or similar unique string that identifies this channel.","required":true},"kind":{"type":"string","description":"Identifies this as a notification channel used to watch for changes to a resource, which is api#channel.","required":true},"payload":{"type":"boolean","description":"A Boolean value to indicate whether payload is wanted.","enum":[true,false]},"resourceId":{"type":"string","description":"An opaque ID that identifies the resource being watched on this channel. Stable across different API versions.","required":true},"resourceUri":{"type":"string","description":"A version-specific identifier for the watched resource.","required":true},"token":{"type":"string","description":"An arbitrary string delivered to the target address with each notification delivered over this channel."}}},"example":{"type":"","params":{},"address":"","expiration":"","id":"","kind":"","payload":"","resourceId":"","resourceUri":"","token":""}}}}}},"/drive/v3/files/{file_id}/comments":{"post":{"tags":["Comments"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"fields","in":"query","description":"Required. The paths of the fields you want included in the response, e.g. '*' or 'id'. If omitted the method returns 400 ('The fields parameter is required for this method'). See https://developers.google.com/drive/api/guides/fields-sharing.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/comments/create","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/comments"},"summary":"Creates a comment on a file.","description":"Creates a comment on a file.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"anchor":{"type":"string","description":"A region of the document represented as a JSON string. For details on defining anchor properties, refer to Manage comments and replies."},"content":{"type":"string","description":"The plain text content of the comment. This field is used for setting the content, while htmlContent should be displayed.","required":true},"quotedFileContent":{"type":"object","description":"The file content to which the comment refers, typically within the anchor region. For a text file, for example, this would be the text at the location of the comment.","properties":{"mimeType":{"type":"string","description":"The MIME type of the quoted content."},"value":{"type":"string","description":"The quoted content itself. Interpreted as plain text when set through the API."}}}}},"example":{"anchor":"","content":"","quotedFileContent":{}}}}}},"get":{"tags":["Comments"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"includeDeleted","in":"query","description":"Whether to include deleted comments","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"pageSize","in":"query","description":"The maximum number of comments to return per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"The token for continuing a previous list request on the next page","schema":{"type":"string","example":""}},{"name":"startModifiedTime","in":"query","description":"The minimum value of 'modifiedTime' for the result comments (RFC 3339 date-time)","schema":{"type":"string","example":""}},{"name":"fields","in":"query","description":"Required. The paths of the fields you want included in the response, e.g. '*' or 'comments'. If omitted the method returns 400 ('The fields parameter is required for this method'). See https://developers.google.com/drive/api/guides/fields-sharing.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/comments/list","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/comments"},"summary":"Lists a file's comments.","description":"Lists a file's comments.","security":[{"bearerAuth":[]}]}},"/drive/v3/files/{file_id}/comments/{comment_id}":{"delete":{"tags":["Comments"],"parameters":[{"name":"comment_id","in":"path","description":"The ID of the comment","required":true,"schema":{"type":"string","example":""}},{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/comments/delete","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/comments/{comment_id}"},"summary":"Deletes a comment.","description":"Deletes a comment.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Comments"],"parameters":[{"name":"comment_id","in":"path","description":"The ID of the comment","required":true,"schema":{"type":"string","example":""}},{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"includeDeleted","in":"query","description":"Whether to return deleted comments","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"fields","in":"query","description":"Required. The paths of the fields you want included in the response, e.g. '*' or 'comments'. If omitted the method returns 400 ('The fields parameter is required for this method'). See https://developers.google.com/drive/api/guides/fields-sharing.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/comments/get","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/comments/{comment_id}"},"summary":"Gets a comment by ID.","description":"Gets a comment by ID.","security":[{"bearerAuth":[]}]},"patch":{"tags":["Comments"],"parameters":[{"name":"comment_id","in":"path","description":"The ID of the comment","required":true,"schema":{"type":"string","example":""}},{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"fields","in":"query","description":"Required. The paths of the fields you want included in the response, e.g. '*' or 'id'. If omitted the method returns 400 ('The fields parameter is required for this method'). See https://developers.google.com/drive/api/guides/fields-sharing.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/comments/update","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/comments/{comment_id}"},"summary":"Updates a comment with patch semantics.","description":"Updates a comment with patch semantics.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"anchor":{"type":"string","description":"A region of the document represented as a JSON string. For details on defining anchor properties, refer to Manage comments and replies."},"content":{"type":"string","description":"The plain text content of the comment. This field is used for setting the content, while htmlContent should be displayed.","required":true},"quotedFileContent":{"type":"object","description":"The file content to which the comment refers, typically within the anchor region. For a text file, for example, this would be the text at the location of the comment.","properties":{"mimeType":{"type":"string","description":"The MIME type of the quoted content."},"value":{"type":"string","description":"The quoted content itself. Interpreted as plain text when set through the API."}}}}},"example":{"anchor":"","content":"","quotedFileContent":{}}}}}}},"/drive/v3/drives":{"post":{"tags":["Drives"],"parameters":[{"name":"requestId","in":"query","description":"An ID such as a random UUID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/drives/create","api_endpoint":"https://www.googleapis.com/drive/v3/drives"},"summary":"Creates a shared drive.","description":"Creates a shared drive.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"backgroundImageFile":{"type":"object","description":"An image file and cropping parameters from which a background image for this shared drive is set. This is a write only field; it can only be set on drive.drives.update requests that don't set themeId. When specified, all fields of the backgroundImageFile must be set.","properties":{"id":{"type":"string","description":"The ID of an image file in Google Drive to use for the background image."},"width":{"type":"number","description":"The width of the cropped image in range 0 to 1. Resulting image must be at least 1280px wide and 144px high."},"xCoordinate":{"type":"number","description":"The X coordinate of the upper left corner of the cropping area. Value in range 0 to 1."},"yCoordinate":{"type":"number","description":"The Y coordinate of the upper left corner of the cropping area. Value in range 0 to 1."}}},"colorRgb":{"type":"string","description":"The color of this shared drive as an RGB hex string. It can only be set on a drive.drives.update request that does not set themeId."},"hidden":{"type":"boolean","description":"Whether the shared drive is hidden from default view.","enum":[true,false]},"name":{"type":"string","description":"The name of this shared drive.","required":true},"restrictions":{"type":"object","description":"A set of restrictions that apply to this shared drive or items inside this shared drive. Note that restrictions can't be set when creating a shared drive. To add a restriction, first create a shared drive and then use drives.update to add restrictions.","properties":{"adminManagedRestrictions":{"type":"boolean","description":"Whether administrative privileges on this shared drive are required to modify restrictions."},"copyRequiresWriterPermission":{"type":"boolean","description":"Whether the options to copy, print, or download files inside this shared drive should be disabled for readers and commenters."},"domainUsersOnly":{"type":"boolean","description":"Whether access to this shared drive and items inside is restricted to users of the domain."},"driveMembersOnly":{"type":"boolean","description":"Whether access to items inside this shared drive is restricted to its members."},"sharingFoldersRequiresOrganizerPermission":{"type":"boolean","description":"If true, only users with the organizer role can share folders."}}},"themeId":{"type":"string","description":"The ID of the theme from which the background image and color will be set. The set of possible driveThemes can be retrieved from a drive.about.get response. When not specified on a drive.drives.create request, a random theme is chosen from which the background image and color are set. This is a write-only field; it can only be set on requests that don't set colorRgb or backgroundImageFile."}}},"example":{"backgroundImageFile":{},"colorRgb":"","hidden":"","name":"","restrictions":{},"themeId":""}}}}},"get":{"tags":["Drives"],"parameters":[{"name":"pageSize","in":"query","description":"Maximum number of shared drives to return per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"Page token for shared drives","schema":{"type":"string","example":""}},{"name":"q","in":"query","description":"Query string for searching shared drives","schema":{"type":"string","example":""}},{"name":"useDomainAdminAccess","in":"query","description":"Issue the request as a domain administrator; if set to true then all shared drives of the domain in which the requester is an administrator are returned","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/drives/list","api_endpoint":"https://www.googleapis.com/drive/v3/drives"},"summary":"Lists the user's shared drives.","description":"Lists the user's shared drives.","security":[{"bearerAuth":[]}]}},"/drive/v3/drives/{drive_id}":{"delete":{"tags":["Drives"],"parameters":[{"name":"drive_id","in":"path","description":"The ID of the shared drive","required":true,"schema":{"type":"string","example":""}},{"name":"allowItemDeletion","in":"query","description":"Whether any items inside the shared drive should also be deleted","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"useDomainAdminAccess","in":"query","description":"Issue the request as a domain administrator; if set to true then the requester will be granted access if they are an administrator of the domain to which the shared drive belongs","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/drives/delete","api_endpoint":"https://www.googleapis.com/drive/v3/drives/{drive_id}"},"summary":"Permanently deletes a shared drive for which the user is an organizer.","description":"Permanently deletes a shared drive for which the user is an organizer.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Drives"],"parameters":[{"name":"drive_id","in":"path","description":"The ID of the shared drive","required":true,"schema":{"type":"string","example":""}},{"name":"useDomainAdminAccess","in":"query","description":"Issue the request as a domain administrator; if set to true then the requester will be granted access if they are an administrator of the domain to which the shared drive belongs","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/drives/get","api_endpoint":"https://www.googleapis.com/drive/v3/drives/{drive_id}"},"summary":"Gets a shared drive's metadata by ID.","description":"Gets a shared drive's metadata by ID.","security":[{"bearerAuth":[]}]},"patch":{"tags":["Drives"],"parameters":[{"name":"drive_id","in":"path","description":"The ID of the shared drive","required":true,"schema":{"type":"string","example":""}},{"name":"useDomainAdminAccess","in":"query","description":"Issue the request as a domain administrator","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/drives/update","api_endpoint":"https://www.googleapis.com/drive/v3/drives/{drive_id}"},"summary":"Updates the metadata for a shared drive.","description":"Updates the metadata for a shared drive.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"backgroundImageFile":{"type":"object","description":"An image file and cropping parameters from which a background image for this shared drive is set. This is a write only field; it can only be set on drive.drives.update requests that don't set themeId. When specified, all fields of the backgroundImageFile must be set.","properties":{"id":{"type":"string","description":"The ID of an image file in Google Drive to use for the background image."},"width":{"type":"number","description":"The width of the cropped image in range 0 to 1. Resulting image must be at least 1280px wide and 144px high."},"xCoordinate":{"type":"number","description":"The X coordinate of the upper left corner of the cropping area. Value in range 0 to 1."},"yCoordinate":{"type":"number","description":"The Y coordinate of the upper left corner of the cropping area. Value in range 0 to 1."}}},"colorRgb":{"type":"string","description":"The color of this shared drive as an RGB hex string. It can only be set on a drive.drives.update request that does not set themeId."},"hidden":{"type":"boolean","description":"Whether the shared drive is hidden from default view.","enum":[true,false]},"name":{"type":"string","description":"The name of this shared drive.","required":true},"restrictions":{"type":"object","description":"A set of restrictions that apply to this shared drive or items inside this shared drive. Note that restrictions can't be set when creating a shared drive. To add a restriction, first create a shared drive and then use drives.update to add restrictions.","properties":{"adminManagedRestrictions":{"type":"boolean","description":"Whether administrative privileges on this shared drive are required to modify restrictions."},"copyRequiresWriterPermission":{"type":"boolean","description":"Whether the options to copy, print, or download files inside this shared drive should be disabled for readers and commenters."},"domainUsersOnly":{"type":"boolean","description":"Whether access to this shared drive and items inside is restricted to users of the domain."},"driveMembersOnly":{"type":"boolean","description":"Whether access to items inside this shared drive is restricted to its members."},"sharingFoldersRequiresOrganizerPermission":{"type":"boolean","description":"If true, only users with the organizer role can share folders."}}},"themeId":{"type":"string","description":"The ID of the theme from which the background image and color will be set. The set of possible driveThemes can be retrieved from a drive.about.get response. When not specified on a drive.drives.create request, a random theme is chosen from which the background image and color are set. This is a write-only field; it can only be set on requests that don't set colorRgb or backgroundImageFile."}}},"example":{"backgroundImageFile":{},"colorRgb":"","hidden":"","name":"","restrictions":{},"themeId":""}}}}}},"/drive/v3/drives/{drive_id}/hide":{"post":{"tags":["Drives"],"parameters":[{"name":"drive_id","in":"path","description":"The ID of the shared drive","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/drives/hide","api_endpoint":"https://www.googleapis.com/drive/v3/drives/{drive_id}/hide"},"summary":"Hides a shared drive from the default view.","description":"Hides a shared drive from the default view.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/drive/v3/drives/{drive_id}/unhide":{"post":{"tags":["Drives"],"parameters":[{"name":"drive_id","in":"path","description":"The ID of the shared drive","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/drives/unhide","api_endpoint":"https://www.googleapis.com/drive/v3/drives/{drive_id}/unhide"},"summary":"Restores a shared drive to the default view.","description":"Restores a shared drive to the default view.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/drive/v3/files/{file_id}/copy":{"post":{"tags":["Files"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"ignoreDefaultVisibility","in":"query","description":"Whether to ignore the domain's default visibility settings for the created file","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"includeLabels","in":"query","description":"A comma-separated list of IDs of labels to include in the labelInfo part of the response","schema":{"type":"string","example":""}},{"name":"includePermissionsForView","in":"query","description":"Specifies which additional view's permissions to include in the response","schema":{"type":"string","example":"","items":{"type":"string","enum":["published"]}}},{"name":"keepRevisionForever","in":"query","description":"Whether to set the 'keepForever' field in the new head revision","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"ocrLanguage","in":"query","description":"A language hint for OCR processing during image import (ISO 639-1 code)","schema":{"type":"string","example":""}},{"name":"supportsAllDrives","in":"query","description":"Whether the requesting application supports both My Drives and shared drives","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/files/copy","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/copy"},"summary":"Creates a copy of a file and applies any requested updates with patch semantics.","description":"Creates a copy of a file and applies any requested updates with patch semantics.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"appProperties":{"type":"object","description":"A collection of arbitrary key-value pairs which are private to the requesting app. Entries with null values are cleared in update and copy requests. These properties can only be retrieved using an authenticated request. An authenticated request uses an access token obtained with an OAuth 2 client ID. You cannot use an API key to retrieve private properties. An object containing a list of 'key': value pairs. Example: { 'name': 'wrench', 'mass': '1.3kg', 'count': '3' }.","properties":{}},"contentHints":{"type":"object","description":"Additional information about the content of the file. These fields are never populated in responses.","properties":{"indexableText":{"type":"string","description":"Text to be indexed for the file to improve fullText queries. Limited to 128 KB, may contain HTML elements."},"thumbnail":{"type":"object","description":"A thumbnail for the file. Used only if Google Drive cannot generate a standard thumbnail."}}},"contentRestrictions":{"type":"array","description":"Restrictions for accessing the content of the file. Only populated if such a restriction exists.","items":{"type":"object","properties":{"type":{"type":"string","description":"The type of content restriction. The only supported value is globalContentRestriction.","enum":["globalContentRestriction"]},"expiryDate":{"type":"string","description":"The time at which the content restriction was set (RFC 3339 date-time). Only mutable on requests that also set readOnly=true."},"ownerRestricted":{"type":"boolean","description":"Whether the content restriction can only be modified or removed by a user who owns the file."},"readOnly":{"type":"boolean","description":"Whether the content of the file is read-only. If a file is read-only, a new revision cannot be added to the file, comments cannot be added or modified, and the file cannot be moved."},"reason":{"type":"string","description":"Reason for the content restriction. This is only mutable on requests that also set readOnly=true."},"systemRestricted":{"type":"boolean","description":"Output only. Whether the content restriction was applied by the system, for example due to an Enterprise Mobility Management policy."}}}},"copyRequiresWriterPermission":{"type":"boolean","description":"Whether the options to copy, print, or download this file, should be disabled for readers and commenters.","enum":[true,false]},"createdTime":{"type":"string","description":"The time at which the file was created (RFC 3339 date-time)."},"description":{"type":"string","description":"A short description of the file."},"folderColorRgb":{"type":"string","description":"The color for a folder or a shortcut to a folder as an RGB hex string. The supported colors are published in the folderColorPalette field of the About resource. If an unsupported color is specified, the closest color in the palette is used instead."},"id":{"type":"string","description":"The ID of the file."},"mimeType":{"type":"string","description":"The MIME type of the file. Google Drive attempts to automatically detect an appropriate value from uploaded content, if no value is provided. The value cannot be changed unless a new revision is uploaded. If a file is created with a Google Doc MIME type, the uploaded content is imported, if possible. The supported import formats are published in the About resource."},"modifiedTime":{"type":"string","description":"The last time the file was modified by anyone (RFC 3339 date-time). Note that setting modifiedTime also updates modifiedByMeTime for the user."},"name":{"type":"string","description":"The name of the file. This is not necessarily unique within a folder. Note that for immutable items such as the top level folders of shared drives, My Drive root folder, and Application Data folder the name is constant."},"originalFilename":{"type":"string","description":"The original filename of the uploaded content if available, or else the original value of the name field. This is only available for files with binary content in Google Drive."},"parents":{"type":"array","description":"The ID of the parent folder containing the file. A file can only have one parent folder; specifying multiple parents isn't supported. If not specified as part of a create request, the file is placed directly in the user's My Drive folder. If not specified as part of a copy request, the file inherits any discoverable parent of the source file. files.update requests must use the addParents and removeParents parameters to modify the parents list.","items":{"type":"string"}},"properties":{"type":"object","description":"A collection of arbitrary key-value pairs which are visible to all apps. Entries with null values are cleared in update and copy requests. An object containing a list of 'key': value pairs. Example: { 'name': 'wrench', 'mass': '1.3kg', 'count': '3' }.","properties":{}},"starred":{"type":"boolean","description":"Whether the user has starred the file.","enum":[true,false]},"trashed":{"type":"boolean","description":"Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner may trash a file, and other users cannot see files in the owner's trash.","enum":[true,false]},"viewedByMeTime":{"type":"string","description":"The last time the file was viewed by the user (RFC 3339 date-time)."},"writersCanShare":{"type":"boolean","description":"Whether users with only writer permission can modify the file's permissions. Not populated for items in shared drives.","enum":[true,false]}}},"example":{"appProperties":{},"contentHints":{},"contentRestrictions":[],"copyRequiresWriterPermission":"","createdTime":"","description":"","folderColorRgb":"","id":"","mimeType":"","modifiedTime":"","name":"","originalFilename":"","parents":[],"properties":{},"starred":"","trashed":"","viewedByMeTime":"","writersCanShare":""}}}}}},"/drive/v3/files":{"post":{"tags":["Files"],"parameters":[{"name":"ignoreDefaultVisibility","in":"query","description":"Whether to ignore the domain's default visibility settings for the created file","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"includeLabels","in":"query","description":"A comma-separated list of IDs of labels to include in the labelInfo part of the response","schema":{"type":"string","example":""}},{"name":"includePermissionsForView","in":"query","description":"Specifies which additional view's permissions to include in the response","schema":{"type":"string","example":""}},{"name":"keepRevisionForever","in":"query","description":"Whether to set the 'keepForever' field in the new head revision","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"ocrLanguage","in":"query","description":"A language hint for OCR processing during image import (ISO 639-1 code)","schema":{"type":"string","example":""}},{"name":"supportsAllDrives","in":"query","description":"Whether the requesting application supports both My Drives and shared drives","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"uploadType","in":"query","description":"The type of upload request to the /upload URI. If you are uploading data with an /upload URI, this field is required. If you are creating a metadata-only file, this field is not required. Additionally, this field is not shown in the 'Try this method' widget because the widget doesn't support data uploads.","schema":{"type":"string","example":"","items":{"type":"string","enum":["media","multipart","resumable"]}}},{"name":"useContentAsIndexableText","in":"query","description":"Whether to use the uploaded content as indexable text","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/files/create","api_endpoint":"https://www.googleapis.com/drive/v3/files"},"summary":"Creates a file.","description":"Creates a file.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"appProperties":{"type":"object","description":"A collection of arbitrary key-value pairs which are private to the requesting app. Entries with null values are cleared in update and copy requests. These properties can only be retrieved using an authenticated request. An authenticated request uses an access token obtained with an OAuth 2 client ID. You cannot use an API key to retrieve private properties. An object containing a list of 'key': value pairs. Example: { 'name': 'wrench', 'mass': '1.3kg', 'count': '3' }.","properties":{}},"contentHints":{"type":"object","description":"Additional information about the content of the file. These fields are never populated in responses.","properties":{"indexableText":{"type":"string","description":"Text to be indexed for the file to improve fullText queries. Limited to 128 KB, may contain HTML elements."},"thumbnail":{"type":"object","description":"A thumbnail for the file. Used only if Google Drive cannot generate a standard thumbnail."}}},"contentRestrictions":{"type":"array","description":"Restrictions for accessing the content of the file. Only populated if such a restriction exists.","items":{"type":"object","properties":{"type":{"type":"string","description":"The type of content restriction. The only supported value is globalContentRestriction.","enum":["globalContentRestriction"]},"expiryDate":{"type":"string","description":"The time at which the content restriction was set (RFC 3339 date-time). Only mutable on requests that also set readOnly=true."},"ownerRestricted":{"type":"boolean","description":"Whether the content restriction can only be modified or removed by a user who owns the file."},"readOnly":{"type":"boolean","description":"Whether the content of the file is read-only. If a file is read-only, a new revision cannot be added to the file, comments cannot be added or modified, and the file cannot be moved."},"reason":{"type":"string","description":"Reason for the content restriction. This is only mutable on requests that also set readOnly=true."},"systemRestricted":{"type":"boolean","description":"Output only. Whether the content restriction was applied by the system, for example due to an Enterprise Mobility Management policy."}}}},"copyRequiresWriterPermission":{"type":"boolean","description":"Whether the options to copy, print, or download this file, should be disabled for readers and commenters.","enum":[true,false]},"createdTime":{"type":"string","description":"The time at which the file was created (RFC 3339 date-time)."},"description":{"type":"string","description":"A short description of the file."},"folderColorRgb":{"type":"string","description":"The color for a folder or a shortcut to a folder as an RGB hex string. The supported colors are published in the folderColorPalette field of the About resource. If an unsupported color is specified, the closest color in the palette is used instead."},"id":{"type":"string","description":"The ID of the file."},"mimeType":{"type":"string","description":"The MIME type of the file. Google Drive attempts to automatically detect an appropriate value from uploaded content, if no value is provided. The value cannot be changed unless a new revision is uploaded. If a file is created with a Google Doc MIME type, the uploaded content is imported, if possible. The supported import formats are published in the About resource."},"modifiedTime":{"type":"string","description":"The last time the file was modified by anyone (RFC 3339 date-time). Note that setting modifiedTime also updates modifiedByMeTime for the user."},"name":{"type":"string","description":"The name of the file. This is not necessarily unique within a folder. Note that for immutable items such as the top level folders of shared drives, My Drive root folder, and Application Data folder the name is constant."},"originalFilename":{"type":"string","description":"The original filename of the uploaded content if available, or else the original value of the name field. This is only available for files with binary content in Google Drive."},"parents":{"type":"array","description":"The ID of the parent folder containing the file. A file can only have one parent folder; specifying multiple parents isn't supported. If not specified as part of a create request, the file is placed directly in the user's My Drive folder. If not specified as part of a copy request, the file inherits any discoverable parent of the source file. files.update requests must use the addParents and removeParents parameters to modify the parents list.","items":{"type":"string"}},"properties":{"type":"object","description":"A collection of arbitrary key-value pairs which are visible to all apps. Entries with null values are cleared in update and copy requests. An object containing a list of 'key': value pairs. Example: { 'name': 'wrench', 'mass': '1.3kg', 'count': '3' }.","properties":{}},"starred":{"type":"boolean","description":"Whether the user has starred the file.","enum":[true,false]},"trashed":{"type":"boolean","description":"Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner may trash a file, and other users cannot see files in the owner's trash.","enum":[true,false]},"viewedByMeTime":{"type":"string","description":"The last time the file was viewed by the user (RFC 3339 date-time)."},"writersCanShare":{"type":"boolean","description":"Whether users with only writer permission can modify the file's permissions. Not populated for items in shared drives.","enum":[true,false]}}},"example":{"appProperties":{},"contentHints":{},"contentRestrictions":[],"copyRequiresWriterPermission":"","createdTime":"","description":"","folderColorRgb":"","id":"","mimeType":"","modifiedTime":"","name":"","originalFilename":"","parents":[],"properties":{},"starred":"","trashed":"","viewedByMeTime":"","writersCanShare":""}}}}},"get":{"tags":["Files"],"parameters":[{"name":"corpora","in":"query","description":"Groupings of files to which the query applies","schema":{"type":"string","example":""}},{"name":"driveId","in":"query","description":"ID of the shared drive to search","schema":{"type":"string","example":""}},{"name":"includeItemsFromAllDrives","in":"query","description":"Whether both My Drive and shared drive items should be included in results","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"includeLabels","in":"query","description":"A comma-separated list of IDs of labels to include in the labelInfo part of the response","schema":{"type":"string","example":""}},{"name":"includePermissionsForView","in":"query","description":"Specifies which additional view's permissions to include in the response","schema":{"type":"string","example":""}},{"name":"orderBy","in":"query","description":"A comma-separated list of sort keys","schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"The maximum number of files to return per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"The token for continuing a previous list request on the next page","schema":{"type":"string","example":""}},{"name":"q","in":"query","description":"A query for filtering the file results","schema":{"type":"string","example":""}},{"name":"spaces","in":"query","description":"A comma-separated list of spaces to query within the corpora","schema":{"type":"string","example":""}},{"name":"supportsAllDrives","in":"query","description":"Whether the requesting application supports both My Drives and shared drives","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/files/list","api_endpoint":"https://www.googleapis.com/drive/v3/files"},"summary":"Lists or searches files.","description":"Lists or searches files.","security":[{"bearerAuth":[]}]}},"/drive/v3/files/{file_id}":{"delete":{"tags":["Files"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"supportsAllDrives","in":"query","description":"Whether the requesting application supports both My Drives and shared drives","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/files/delete","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}"},"summary":"Permanently deletes a file owned by the user without moving it to the trash.","description":"Permanently deletes a file owned by the user without moving it to the trash.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Files"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"acknowledgeAbuse","in":"query","description":"Whether the user is acknowledging the risk of downloading known malware or other abusive files","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"includeLabels","in":"query","description":"A comma-separated list of IDs of labels to include in the labelInfo part of the response","schema":{"type":"string","example":""}},{"name":"includePermissionsForView","in":"query","description":"Specifies which additional view's permissions to include in the response. Only 'published' is supported.","schema":{"type":"string","example":"","items":{"type":"string","enum":["published"]}}},{"name":"supportsAllDrives","in":"query","description":"Whether the requesting application supports both My Drives and shared drives","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"alt","in":"query","description":"Returns the file's content as raw bytes instead of the JSON File metadata. Only files with binary content can be downloaded this way - Google-native files (Docs/Sheets/Slides) return 403 fileNotDownloadable; use the export endpoint for those. Omit to get the metadata JSON.","required":false,"schema":{"type":"string","example":"","items":{"type":"string","enum":["media"]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/files/get","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}"},"summary":"Gets a file's metadata or content by ID.","description":"Gets a file's metadata or content by ID.","security":[{"bearerAuth":[]}]},"patch":{"tags":["Files"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"addParents","in":"query","description":"A comma-separated list of parent IDs to add","schema":{"type":"string","example":""}},{"name":"includeLabels","in":"query","description":"A comma-separated list of IDs of labels to include in the labelInfo part of the response","schema":{"type":"string","example":""}},{"name":"includePermissionsForView","in":"query","description":"Specifies which additional view's permissions to include in the response","schema":{"type":"string","example":""}},{"name":"keepRevisionForever","in":"query","description":"Whether to set the 'keepForever' field in the new head revision","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"ocrLanguage","in":"query","description":"A language hint for OCR processing during image import (ISO 639-1 code)","schema":{"type":"string","example":""}},{"name":"removeParents","in":"query","description":"A comma-separated list of parent IDs to remove","schema":{"type":"string","example":""}},{"name":"supportsAllDrives","in":"query","description":"Whether the requesting application supports both My Drives and shared drives","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"uploadType","in":"query","description":"The type of upload request to the /upload URI. If you are uploading data with an /upload URI, this field is required. If you are creating a metadata-only file, this field is not required. Additionally, this field is not shown in the 'Try this method' widget because the widget doesn't support data uploads.","schema":{"type":"string","example":"","items":{"type":"string","enum":["media","multipart","resumable"]}}},{"name":"useContentAsIndexableText","in":"query","description":"Whether to use the uploaded content as indexable text","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/files/update","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}"},"summary":"Updates a file's metadata and/or content.","description":"Updates a file's metadata and/or content.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"appProperties":{"type":"object","description":"A collection of arbitrary key-value pairs which are private to the requesting app. Entries with null values are cleared in update and copy requests. These properties can only be retrieved using an authenticated request. An authenticated request uses an access token obtained with an OAuth 2 client ID. You cannot use an API key to retrieve private properties. An object containing a list of 'key': value pairs. Example: { 'name': 'wrench', 'mass': '1.3kg', 'count': '3' }.","properties":{}},"contentHints":{"type":"object","description":"Additional information about the content of the file. These fields are never populated in responses.","properties":{"indexableText":{"type":"string","description":"Text to be indexed for the file to improve fullText queries. Limited to 128 KB, may contain HTML elements."},"thumbnail":{"type":"object","description":"A thumbnail for the file. Used only if Google Drive cannot generate a standard thumbnail."}}},"contentRestrictions":{"type":"array","description":"Restrictions for accessing the content of the file. Only populated if such a restriction exists.","items":{"type":"object","properties":{"type":{"type":"string","description":"The type of content restriction. The only supported value is globalContentRestriction.","enum":["globalContentRestriction"]},"expiryDate":{"type":"string","description":"The time at which the content restriction was set (RFC 3339 date-time). Only mutable on requests that also set readOnly=true."},"ownerRestricted":{"type":"boolean","description":"Whether the content restriction can only be modified or removed by a user who owns the file."},"readOnly":{"type":"boolean","description":"Whether the content of the file is read-only. If a file is read-only, a new revision cannot be added to the file, comments cannot be added or modified, and the file cannot be moved."},"reason":{"type":"string","description":"Reason for the content restriction. This is only mutable on requests that also set readOnly=true."},"systemRestricted":{"type":"boolean","description":"Output only. Whether the content restriction was applied by the system, for example due to an Enterprise Mobility Management policy."}}}},"copyRequiresWriterPermission":{"type":"boolean","description":"Whether the options to copy, print, or download this file, should be disabled for readers and commenters.","enum":[true,false]},"createdTime":{"type":"string","description":"The time at which the file was created (RFC 3339 date-time)."},"description":{"type":"string","description":"A short description of the file."},"folderColorRgb":{"type":"string","description":"The color for a folder or a shortcut to a folder as an RGB hex string. The supported colors are published in the folderColorPalette field of the About resource. If an unsupported color is specified, the closest color in the palette is used instead."},"id":{"type":"string","description":"The ID of the file."},"mimeType":{"type":"string","description":"The MIME type of the file. Google Drive attempts to automatically detect an appropriate value from uploaded content, if no value is provided. The value cannot be changed unless a new revision is uploaded. If a file is created with a Google Doc MIME type, the uploaded content is imported, if possible. The supported import formats are published in the About resource."},"modifiedTime":{"type":"string","description":"The last time the file was modified by anyone (RFC 3339 date-time). Note that setting modifiedTime also updates modifiedByMeTime for the user."},"name":{"type":"string","description":"The name of the file. This is not necessarily unique within a folder. Note that for immutable items such as the top level folders of shared drives, My Drive root folder, and Application Data folder the name is constant."},"originalFilename":{"type":"string","description":"The original filename of the uploaded content if available, or else the original value of the name field. This is only available for files with binary content in Google Drive."},"parents":{"type":"array","description":"The ID of the parent folder containing the file. A file can only have one parent folder; specifying multiple parents isn't supported. If not specified as part of a create request, the file is placed directly in the user's My Drive folder. If not specified as part of a copy request, the file inherits any discoverable parent of the source file. files.update requests must use the addParents and removeParents parameters to modify the parents list.","items":{"type":"string"}},"properties":{"type":"object","description":"A collection of arbitrary key-value pairs which are visible to all apps. Entries with null values are cleared in update and copy requests. An object containing a list of 'key': value pairs. Example: { 'name': 'wrench', 'mass': '1.3kg', 'count': '3' }.","properties":{}},"starred":{"type":"boolean","description":"Whether the user has starred the file.","enum":[true,false]},"trashed":{"type":"boolean","description":"Whether the file has been trashed, either explicitly or from a trashed parent folder. Only the owner may trash a file, and other users cannot see files in the owner's trash.","enum":[true,false]},"viewedByMeTime":{"type":"string","description":"The last time the file was viewed by the user (RFC 3339 date-time)."},"writersCanShare":{"type":"boolean","description":"Whether users with only writer permission can modify the file's permissions. Not populated for items in shared drives.","enum":[true,false]}}},"example":{"appProperties":{},"contentHints":{},"contentRestrictions":[],"copyRequiresWriterPermission":"","createdTime":"","description":"","folderColorRgb":"","id":"","mimeType":"","modifiedTime":"","name":"","originalFilename":"","parents":[],"properties":{},"starred":"","trashed":"","viewedByMeTime":"","writersCanShare":""}}}}}},"/drive/v3/files/trash":{"delete":{"tags":["Files"],"parameters":[{"name":"driveId","in":"query","description":"If set empties the trash of the provided shared drive","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/files/emptyTrash","api_endpoint":"https://www.googleapis.com/drive/v3/files/trash"},"summary":"Permanently deletes all trashed files of a user or shared drive.","description":"Permanently deletes all trashed files of a user or shared drive.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/drive/v3/files/{file_id}/export":{"get":{"tags":["Files"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"mimeType","in":"query","description":"The MIME type of the format requested for this export","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/files/export","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/export"},"summary":"Exports a Google Workspace document to the requested MIME type and returns exported byte content.","description":"Exports a Google Workspace document to the requested MIME type and returns exported byte content.","security":[{"bearerAuth":[]}]}},"/drive/v3/files/generateIds":{"get":{"tags":["Files"],"parameters":[{"name":"type","in":"query","description":"The type of items which the IDs can be used for. Supported values are 'files' and 'shortcuts'. Note that 'shortcuts' are only supported in the drive 'space'. (Default: 'files')","schema":{"type":"string","example":"","items":{"type":"string","enum":["files","shortcuts"]}}},{"name":"count","in":"query","description":"The number of IDs to return","schema":{"type":"number","example":""}},{"name":"space","in":"query","description":"The space in which the IDs can be used to create new files. Supported values are 'drive' and 'appDataFolder'. (Default: 'drive')","schema":{"type":"string","example":"","items":{"type":"string","enum":["drive","appDataFolder"]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/files/generateIds","api_endpoint":"https://www.googleapis.com/drive/v3/files/generateIds"},"summary":"Generates a set of file IDs which can be provided in create or copy requests.","description":"Generates a set of file IDs which can be provided in create or copy requests.","security":[{"bearerAuth":[]}]}},"/drive/v3/files/{file_id}/listLabels":{"get":{"tags":["Files"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"maxResults","in":"query","description":"The maximum number of labels to return per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"The token for continuing a previous list request on the next page","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/files/listLabels","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/listLabels"},"summary":"Lists the labels on a file.","description":"Lists the labels on a file.","security":[{"bearerAuth":[]}]}},"/drive/v3/files/{file_id}/modifyLabels":{"post":{"tags":["Files"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file for which the labels are modified","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/files/modifyLabels","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/modifyLabels"},"summary":"Modifies the set of labels on a file.","description":"Modifies the set of labels on a file.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"kind":{"type":"string","description":"This is always drive#modifyLabelsRequest."},"labelModifications":{"type":"array","description":"The list of modifications to apply to the labels on the file.","items":{"type":"object","properties":{"fieldModifications":{"type":"array","description":"The list of modifications to this label's fields."},"labelId":{"type":"string","description":"The ID of the label to modify.","required":true},"removeLabel":{"type":"boolean","description":"If true, the label will be removed from the file."}}}}}},"example":{"kind":"","labelModifications":[]}}}}}},"/drive/v3/files/{file_id}/watch":{"post":{"tags":["Files"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"acknowledgeAbuse","in":"query","description":"Whether the user is acknowledging the risk of downloading known malware or other abusive files","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"includeLabels","in":"query","description":"A comma-separated list of IDs of labels to include in the labelInfo part of the response. Only 'published' is supported.","schema":{"type":"string","example":""}},{"name":"includePermissionsForView","in":"query","description":"Specifies which additional view's permissions to include in the response","schema":{"type":"string","example":""}},{"name":"supportsAllDrives","in":"query","description":"Whether the requesting application supports both My Drives and shared drives","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/files/watch","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/watch"},"summary":"Subscribe to changes on a file.","description":"Subscribe to changes on a file.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"type":{"type":"string","description":"The type of delivery mechanism used for this channel. Valid values are 'web_hook' or 'webhook'.","required":true},"params":{"type":"object","description":"Additional parameters controlling delivery channel behavior. An object containing a list of 'key': value pairs. Example: { 'name': 'wrench', 'mass': '1.3kg', 'count': '3' }.","properties":{}},"address":{"type":"string","description":"The address where notifications are delivered for this channel.","required":true},"expiration":{"type":"string","description":"Date and time of notification channel expiration, expressed as a Unix timestamp, in milliseconds."},"id":{"type":"string","description":"A UUID or similar unique string that identifies this channel.","required":true},"kind":{"type":"string","description":"Identifies this as a notification channel used to watch for changes to a resource, which is api#channel.","required":true},"payload":{"type":"boolean","description":"A Boolean value to indicate whether payload is wanted.","enum":[true,false]},"resourceId":{"type":"string","description":"An opaque ID that identifies the resource being watched on this channel. Stable across different API versions.","required":true},"resourceUri":{"type":"string","description":"A version-specific identifier for the watched resource.","required":true},"token":{"type":"string","description":"An arbitrary string delivered to the target address with each notification delivered over this channel."}}},"example":{"type":"","params":{},"address":"","expiration":"","id":"","kind":"","payload":"","resourceId":"","resourceUri":"","token":""}}}}}},"/drive/v3/files/{file_id}/permissions":{"post":{"tags":["Permissions"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file or shared drive","required":true,"schema":{"type":"string","example":""}},{"name":"emailMessage","in":"query","description":"A plain text custom message to include in the notification email","schema":{"type":"string","example":""}},{"name":"moveToNewOwnersRoot","in":"query","description":"This parameter will only take effect if the item is not in a shared drive and the request is attempting to transfer the ownership of the item","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"sendNotificationEmail","in":"query","description":"Whether to send a notification email when sharing to users or groups","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"supportsAllDrives","in":"query","description":"Whether the requesting application supports both My Drives and shared drives","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"transferOwnership","in":"query","description":"Whether to transfer ownership to the specified user and downgrade the current owner to a writer","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"useDomainAdminAccess","in":"query","description":"Issue the request as a domain administrator; if set to true then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/permissions/create","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/permissions"},"summary":"Creates a permission for a file or shared drive.","description":"Creates a permission for a file or shared drive.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"type":{"type":"string","description":"The type of the grantee. Valid values are: user, group, domain, anyone.","required":true},"allowFileDiscovery":{"type":"boolean","description":"Whether the permission allows the file to be discovered through search. Only applicable for type domain or anyone.","enum":[true,false]},"domain":{"type":"string","description":"The domain to which this permission refers. Required if type is domain."},"emailAddress":{"type":"string","description":"The email address of the user or group to which this permission refers. Required if type is user or group."},"expirationTime":{"type":"string","description":"The time at which this permission will expire (RFC 3339 date-time). Only settable on user and group permissions. Must be in the future and not more than a year in the future."},"role":{"type":"string","description":"The role granted by this permission. Valid values are: owner, organizer, fileOrganizer, writer, commenter, reader.","required":true}}},"example":{"type":"","allowFileDiscovery":"","domain":"","emailAddress":"","expirationTime":"","role":""}}}}},"get":{"tags":["Permissions"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file or shared drive","required":true,"schema":{"type":"string","example":""}},{"name":"includePermissionsForView","in":"query","description":"Specifies which additional view's permissions to include in the response","schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"The maximum number of permissions to return per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"The token for continuing a previous list request on the next page","schema":{"type":"string","example":""}},{"name":"supportsAllDrives","in":"query","description":"Whether the requesting application supports both My Drives and shared drives","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"useDomainAdminAccess","in":"query","description":"Issue the request as a domain administrator; if set to true then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/permissions/list","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/permissions"},"summary":"Lists a file's or shared drive's permissions.","description":"Lists a file's or shared drive's permissions.","security":[{"bearerAuth":[]}]}},"/drive/v3/files/{file_id}/permissions/{permission_id}":{"delete":{"tags":["Permissions"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file or shared drive","required":true,"schema":{"type":"string","example":""}},{"name":"permission_id","in":"path","description":"The ID of the permission","required":true,"schema":{"type":"string","example":""}},{"name":"supportsAllDrives","in":"query","description":"Whether the requesting application supports both My Drives and shared drives","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"useDomainAdminAccess","in":"query","description":"Issue the request as a domain administrator; if set to true then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/permissions/delete","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/permissions/{permission_id}"},"summary":"Deletes a permission.","description":"Deletes a permission.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Permissions"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"permission_id","in":"path","description":"The ID of the permission","required":true,"schema":{"type":"string","example":""}},{"name":"supportsAllDrives","in":"query","description":"Whether the requesting application supports both My Drives and shared drives","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"useDomainAdminAccess","in":"query","description":"Issue the request as a domain administrator; if set to true then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/permissions/get","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/permissions/{permission_id}"},"summary":"Gets a permission by ID.","description":"Gets a permission by ID.","security":[{"bearerAuth":[]}]},"patch":{"tags":["Permissions"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file or shared drive","required":true,"schema":{"type":"string","example":""}},{"name":"permission_id","in":"path","description":"The ID of the permission","required":true,"schema":{"type":"string","example":""}},{"name":"removeExpiration","in":"query","description":"Whether to remove the expiration date","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"supportsAllDrives","in":"query","description":"Whether the requesting application supports both My Drives and shared drives","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"transferOwnership","in":"query","description":"Whether to transfer ownership to the specified user and downgrade the current owner to a writer","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"useDomainAdminAccess","in":"query","description":"Issue the request as a domain administrator; if set to true then the requester will be granted access if the file ID parameter refers to a shared drive and the requester is an administrator of the domain to which the shared drive belongs","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/permissions/update","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/permissions/{permission_id}"},"summary":"Updates a permission with patch semantics.","description":"Updates a permission with patch semantics.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"type":{"type":"string","description":"The type of the grantee. Valid values are: user, group, domain, anyone.","required":true},"allowFileDiscovery":{"type":"boolean","description":"Whether the permission allows the file to be discovered through search. Only applicable for type domain or anyone.","enum":[true,false]},"domain":{"type":"string","description":"The domain to which this permission refers. Required if type is domain."},"emailAddress":{"type":"string","description":"The email address of the user or group to which this permission refers. Required if type is user or group."},"expirationTime":{"type":"string","description":"The time at which this permission will expire (RFC 3339 date-time). Only settable on user and group permissions. Must be in the future and not more than a year in the future."},"role":{"type":"string","description":"The role granted by this permission. Valid values are: owner, organizer, fileOrganizer, writer, commenter, reader.","required":true}}},"example":{"type":"","allowFileDiscovery":"","domain":"","emailAddress":"","expirationTime":"","role":""}}}}}},"/drive/v3/files/{file_id}/comments/{comment_id}/replies":{"post":{"tags":["Replies"],"parameters":[{"name":"comment_id","in":"path","description":"The ID of the comment","required":true,"schema":{"type":"string","example":""}},{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"fields","in":"query","description":"Required. The paths of the fields you want included in the response, e.g. '*' or 'id'. If omitted the method returns 400 ('The fields parameter is required for this method'). See https://developers.google.com/drive/api/guides/fields-sharing.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/replies/create","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/comments/{comment_id}/replies"},"summary":"Creates a reply to a comment.","description":"Creates a reply to a comment.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"action":{"type":"string","description":"The action the reply performed to the parent comment. Valid values are: resolve, reopen."},"content":{"type":"string","description":"The plain text content of the reply. This field is used for setting the content, while htmlContent should be displayed. This is required on creates if no action is specified.","required":true}}},"example":{"action":"","content":""}}}}},"get":{"tags":["Replies"],"parameters":[{"name":"comment_id","in":"path","description":"The ID of the comment","required":true,"schema":{"type":"string","example":""}},{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"includeDeleted","in":"query","description":"Whether to include deleted replies","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"pageSize","in":"query","description":"The maximum number of replies to return per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"The token for continuing a previous list request on the next page","schema":{"type":"string","example":""}},{"name":"fields","in":"query","description":"Required. The paths of the fields you want included in the response, e.g. '*' or 'comments'. If omitted the method returns 400 ('The fields parameter is required for this method'). See https://developers.google.com/drive/api/guides/fields-sharing.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/replies/list","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/comments/{comment_id}/replies"},"summary":"Lists a comment's replies.","description":"Lists a comment's replies.","security":[{"bearerAuth":[]}]}},"/drive/v3/files/{file_id}/comments/{comment_id}/replies/{reply_id}":{"delete":{"tags":["Replies"],"parameters":[{"name":"comment_id","in":"path","description":"The ID of the comment","required":true,"schema":{"type":"string","example":""}},{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"reply_id","in":"path","description":"The ID of the reply","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/replies/delete","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/comments/{comment_id}/replies/{reply_id}"},"summary":"Deletes a reply.","description":"Deletes a reply.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Replies"],"parameters":[{"name":"comment_id","in":"path","description":"The ID of the comment","required":true,"schema":{"type":"string","example":""}},{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"reply_id","in":"path","description":"The ID of the reply","required":true,"schema":{"type":"string","example":""}},{"name":"includeDeleted","in":"query","description":"Whether to return deleted replies","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}},{"name":"fields","in":"query","description":"Required. The paths of the fields you want included in the response, e.g. '*' or 'comments'. If omitted the method returns 400 ('The fields parameter is required for this method'). See https://developers.google.com/drive/api/guides/fields-sharing.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/replies/get","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/comments/{comment_id}/replies/{reply_id}"},"summary":"Gets a reply by ID.","description":"Gets a reply by ID.","security":[{"bearerAuth":[]}]},"patch":{"tags":["Replies"],"parameters":[{"name":"comment_id","in":"path","description":"The ID of the comment","required":true,"schema":{"type":"string","example":""}},{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"reply_id","in":"path","description":"The ID of the reply","required":true,"schema":{"type":"string","example":""}},{"name":"fields","in":"query","description":"Required. The paths of the fields you want included in the response, e.g. '*' or 'id'. If omitted the method returns 400 ('The fields parameter is required for this method'). See https://developers.google.com/drive/api/guides/fields-sharing.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/replies/update","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/comments/{comment_id}/replies/{reply_id}"},"summary":"Updates a reply with patch semantics.","description":"Updates a reply with patch semantics.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"action":{"type":"string","description":"The action the reply performed to the parent comment. Valid values are: resolve, reopen."},"content":{"type":"string","description":"The plain text content of the reply. This field is used for setting the content, while htmlContent should be displayed. This is required on creates if no action is specified.","required":true}}},"example":{"action":"","content":""}}}}}},"/drive/v3/files/{file_id}/revisions/{revision_id}":{"delete":{"tags":["Revisions"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"revision_id","in":"path","description":"The ID of the revision","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/revisions/delete","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/revisions/{revision_id}"},"summary":"Permanently deletes a file version.","description":"Permanently deletes a file version.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}},"get":{"tags":["Revisions"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"revision_id","in":"path","description":"The ID of the revision","required":true,"schema":{"type":"string","example":""}},{"name":"acknowledgeAbuse","in":"query","description":"Whether the user is acknowledging the risk of downloading known malware or other abusive files","schema":{"type":"boolean","example":"","items":{"type":"string","enum":[true,false]}}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/revisions/get","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/revisions/{revision_id}"},"summary":"Gets a revision's metadata or content by ID.","description":"Gets a revision's metadata or content by ID.","security":[{"bearerAuth":[]}]},"patch":{"tags":["Revisions"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"revision_id","in":"path","description":"The ID of the revision","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/revisions/update","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/revisions/{revision_id}"},"summary":"Updates a revision with patch semantics.","description":"Updates a revision with patch semantics.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"keepForever":{"type":"boolean","description":"Whether to keep this revision forever, even if it is no longer the head revision. If not set, the revision will be automatically purged 30 days after newer content is uploaded. This can be set on a maximum of 200 revisions for a file. This field is only applicable to files with binary content in Drive.","enum":[true,false]},"publishAuto":{"type":"boolean","description":"Whether subsequent revisions will be automatically republished. This is only applicable to Docs Editors files.","enum":[true,false]},"published":{"type":"boolean","description":"Whether this revision is published. This is only applicable to Docs Editors files.","enum":[true,false]},"publishedOutsideDomain":{"type":"boolean","description":"Whether this revision is published outside the domain. This is only applicable to Docs Editors files.","enum":[true,false]}}},"example":{"keepForever":"","publishAuto":"","published":"","publishedOutsideDomain":""}}}}}},"/drive/v3/files/{file_id}/revisions":{"get":{"tags":["Revisions"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file","required":true,"schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"The maximum number of revisions to return per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"The token for continuing a previous list request on the next page","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/revisions/list","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/revisions"},"summary":"Lists a file's revisions.","description":"Lists a file's revisions.","security":[{"bearerAuth":[]}]}},"/drive/v3/files/{file_id}/accessproposals":{"get":{"tags":["Access Proposals"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the item the request is on","required":true,"schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"The number of results per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"The continuation token on the list of access requests","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/accessproposals/list","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/accessproposals"},"summary":"List access proposals","description":"List the access proposals on a file. For more information, see Manage pending access proposals. Note: Only approvers are able to list access proposals on a file. If the user isn't an approver, a 403 error is returned.","security":[{"bearerAuth":[]}]}},"/drive/v3/files/{file_id}/accessproposals/{proposal_id}":{"get":{"tags":["Access Proposals"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the item the request is on","required":true,"schema":{"type":"string","example":""}},{"name":"proposal_id","in":"path","description":"The ID of the access proposal to retrieve","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/accessproposals/get","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/accessproposals/{proposal_id}"},"summary":"Get access proposal","description":"Retrieves an access proposal by ID. For more information, see Manage pending access proposals.","security":[{"bearerAuth":[]}]}},"/drive/v3/files/{file_id}/accessproposals/{proposal_id}/resolve":{"post":{"tags":["Access Proposals"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the item the request is on","required":true,"schema":{"type":"string","example":""}},{"name":"proposal_id","in":"path","description":"The ID of the access proposal to resolve","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/accessproposals/resolve","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/accessproposals/{proposal_id}:resolve"},"summary":"Resolve access proposal","description":"Approves or denies an access proposal. For more information, see Manage pending access proposals.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"action":{"type":"string","description":"The action to take on the access proposal","required":true,"enum":["ACTION_UNSPECIFIED","ACCEPT","DENY"]},"role":{"type":"array","description":"The roles that the approver has allowed, if any. For more information, see Roles and permissions. Note: This field is required for the ACCEPT action.","items":{"type":"string"}},"sendNotification":{"type":"boolean","description":"Whether to send an email to the requester when the access proposal is denied or accepted"},"view":{"type":"string","description":"Indicates the view for this access proposal. This should only be set when the proposal belongs to a view. Only published is supported."}}},"example":{"action":"","role":[],"sendNotification":"","view":""}}}}}},"/drive/v3/files/{file_id}/approvals":{"get":{"tags":["Approvals"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the item the request is on","required":true,"schema":{"type":"string","example":""}},{"name":"pageSize","in":"query","description":"The number of results per page","schema":{"type":"number","example":""}},{"name":"pageToken","in":"query","description":"The continuation token on the list of approvals","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/approvals/list","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/approvals"},"summary":"List approvals","description":"Lists the Approvals on a file.","security":[{"bearerAuth":[]}]}},"/drive/v3/files/{file_id}/approvals/{approval_id}":{"get":{"tags":["Approvals"],"parameters":[{"name":"approval_id","in":"path","description":"The ID of the approval to retrieve","required":true,"schema":{"type":"string","example":""}},{"name":"file_id","in":"path","description":"The ID of the item the request is on","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/approvals/get","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/approvals/{approval_id}"},"summary":"Get approval","description":"Gets an Approval by ID.","security":[{"bearerAuth":[]}]}},"/drive/v3/operations/{name}":{"get":{"tags":["Operations"],"parameters":[{"name":"name","in":"path","description":"The name of the operation resource","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/operations/get","api_endpoint":"https://www.googleapis.com/drive/v3/operations/{name}"},"summary":"Get operation","description":"Gets the latest state of a long-running operation. Clients can use this method to poll the operation result at intervals as recommended by the API service.","security":[{"bearerAuth":[]}]}},"/drive/v3/files/{file_id}/download":{"post":{"tags":["Files"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file to download","required":true,"schema":{"type":"string","example":""}},{"name":"mimeType","in":"query","description":"The MIME type the file should be downloaded as. This field can only be set when downloading Google Workspace documents. For a list of supported MIME types, see Export MIME types for Google Workspace documents. If not set, a Google Workspace document is downloaded with a default MIME type.","schema":{"type":"string","example":""}},{"name":"revisionId","in":"query","description":"The revision ID of the file to download. This field can only be set when downloading blob files, Google Docs, and Google Sheets. Returns INVALID_ARGUMENT if downloading a specific revision on the file is unsupported.","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/files/download","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/download"},"summary":"Download file","description":"Downloads the content of a file. For more information, see Download and export files. Operations are valid for 24 hours from the time of creation.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/batch/drive/v3":{"post":{"tags":["Batch"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/guides/batch","api_endpoint":"https://www.googleapis.com/batch/drive/v3"},"summary":"Batch requests","description":"Combines multiple API calls into a single HTTP request to reduce the number of HTTP connections","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"requests":{"type":"array","description":"Array of API requests to batch process. Each request should include method, path, and body/params as needed","required":true,"items":{"type":"object","properties":{"method":{"type":"string","description":"The HTTP method for the API request.","required":true,"enum":["GET","POST","PATCH","PUT","DELETE"]},"params":{"type":"object","description":"Query parameters for the request."},"path":{"type":"string","description":"The relative API path for the request.","required":true},"body":{"type":"object","description":"The request body payload."}}}}}},"example":{"requests":[{"method":"GET","params":{"q":"name contains 'test'"},"path":"/drive/v3/files"}]}}}}}},"/drive/v3/files/generateCseToken":{"get":{"tags":["Files"],"parameters":[{"name":"fileId","in":"query","description":"The ID of the file for which the JWT should be generated. If not provided, an id will be generated.","required":false,"schema":{"type":"string","example":""}},{"name":"parent","in":"query","description":"The ID of the expected parent of the file. Used when generating a JWT for a new CSE file. It is invalid to specify both fileId and parent in a single request.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/files/generateCseToken","api_endpoint":"https://www.googleapis.com/drive/v3/files/generateCseToken"},"summary":"Generate CSE token","description":"Generates a CSE token which can be used to create or update CSE files.","security":[{"bearerAuth":[]}]}},"/drive/v3/files/{file_id}/approvals/{approval_id}/approve":{"post":{"tags":["Approvals"],"parameters":[{"name":"approval_id","in":"path","description":"The ID of the approval to approve.","required":true,"schema":{"type":"string","example":""}},{"name":"file_id","in":"path","description":"The ID of the file that the approval is on.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/approvals/approve","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/approvals/{approval_id}:approve"},"summary":"Approve an approval","description":"Approves an approval. Updates the reviewer response to APPROVED.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"message":{"type":"string","description":"A message to accompany the reviewer response on the approval."}}},"example":{"message":["Looks good, approved."]}}}}}},"/drive/v3/files/{file_id}/approvals/{approval_id}/cancel":{"post":{"tags":["Approvals"],"parameters":[{"name":"approval_id","in":"path","description":"The ID of the approval to cancel.","required":true,"schema":{"type":"string","example":""}},{"name":"file_id","in":"path","description":"The ID of the file that the approval is on.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/approvals/cancel","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/approvals/{approval_id}:cancel"},"summary":"Cancel an approval","description":"Cancels an approval. Updates the approval status to CANCELLED.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"message":{"type":"string","description":"A message to accompany the cancellation of the approval."}}},"example":{"message":["Cancelling this approval."]}}}}}},"/drive/v3/files/{file_id}/approvals/{approval_id}/comment":{"post":{"tags":["Approvals"],"parameters":[{"name":"approval_id","in":"path","description":"The ID of the approval to comment on.","required":true,"schema":{"type":"string","example":""}},{"name":"file_id","in":"path","description":"The ID of the file that the approval is on.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/approvals/comment","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/approvals/{approval_id}:comment"},"summary":"Comment on an approval","description":"Comments on an approval.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"message":{"type":"string","description":"A message to comment on the approval.","required":true}}},"example":{"message":["Can you clarify this section?"]}}}}}},"/drive/v3/files/{file_id}/approvals/{approval_id}/decline":{"post":{"tags":["Approvals"],"parameters":[{"name":"approval_id","in":"path","description":"The ID of the approval to decline.","required":true,"schema":{"type":"string","example":""}},{"name":"file_id","in":"path","description":"The ID of the file that the approval is on.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/approvals/decline","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/approvals/{approval_id}:decline"},"summary":"Decline an approval","description":"Declines an approval. Updates the reviewer response to DECLINED and completes the approval.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"message":{"type":"string","description":"A message to accompany the reviewer response on the approval."}}},"example":{"message":["Needs revision before approval."]}}}}}},"/drive/v3/files/{file_id}/approvals/{approval_id}/reassign":{"post":{"tags":["Approvals"],"parameters":[{"name":"approval_id","in":"path","description":"The ID of the approval to reassign.","required":true,"schema":{"type":"string","example":""}},{"name":"file_id","in":"path","description":"The ID of the file that the approval is on.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/approvals/reassign","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/approvals/{approval_id}:reassign"},"summary":"Reassign reviewers on an approval","description":"Reassigns the reviewers on an approval. Adds or replaces reviewers.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"addReviewers":{"type":"array","description":"The list of reviewers to add.","items":{"type":"object","properties":{"addedReviewerEmail":{"type":"string","description":"The email of the reviewer to add.","required":true}}}},"message":{"type":"string","description":"A message to send to the new reviewers."},"replaceReviewers":{"type":"array","description":"The list of reviewer replacements.","items":{"type":"object","properties":{"newReviewerEmail":{"type":"string","description":"The email of the new reviewer.","required":true},"oldReviewerEmail":{"type":"string","description":"The email of the reviewer to replace.","required":true}}}}}},"example":{"addReviewers":[],"message":["Reassigned to you for review."],"replaceReviewers":[]}}}}}},"/drive/v3/files/{file_id}/approvals/start":{"post":{"tags":["Approvals"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file that the approval is created on.","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/approvals/start","api_endpoint":"https://www.googleapis.com/drive/v3/files/{file_id}/approvals:start"},"summary":"Start an approval","description":"Starts an approval on a file.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"dueTime":{"type":"string","description":"The time that the approval is due. Uses RFC 3339 format."},"lockFile":{"type":"boolean","description":"Whether to lock the file when starting the approval.","enum":[true,false]},"message":{"type":"string","description":"A message to send to reviewers when notifying them of the approval request."},"reviewerEmails":{"type":"array","description":"The emails of the users who are set to review the approval.","required":true,"items":{"type":"string"}}}},"example":{"dueTime":["2026-07-01T15:01:23Z"],"lockFile":"","message":["Please review this document."],"reviewerEmails":[["reviewer1@example.com","reviewer2@example.com"]]}}}}}},"/upload/drive/v3/files":{"post":{"tags":["Files"],"parameters":[{"name":"fields","in":"query","description":"The paths of the fields you want included in the response, e.g. 'id,name,size'. Optional.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/files/create","api_endpoint":"https://www.googleapis.com/upload/drive/v3/files?uploadType=media"},"summary":"Upload a file's content to Google Drive (raw media upload)","description":"Uploads raw file content to Google Drive via the media upload endpoint (uploadType=media). The request body is the file bytes themselves. Creates a file without a name (shows as 'Untitled') - follow up with PATCH /drive/v3/files/{file_id} to set name and other metadata.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","format":"binary","description":"The file content - sent as the raw request body (Content-Type should be the file's MIME type).","required":true}}},"example":{"file":"(binary)"}}}}}},"/upload/drive/v3/files/{file_id}":{"patch":{"tags":["Files"],"parameters":[{"name":"file_id","in":"path","description":"The ID of the file whose content is replaced","required":true,"schema":{"type":"string","example":""}},{"name":"fields","in":"query","description":"The paths of the fields you want included in the response, e.g. 'id,name,size'. Optional.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/files/update","api_endpoint":"https://www.googleapis.com/upload/drive/v3/files/{file_id}?uploadType=media"},"summary":"Replace a file's content in Google Drive (raw media upload)","description":"Replaces an existing file's content via the media upload endpoint (uploadType=media). The request body is the new file bytes. Metadata (name etc.) is unchanged - use PATCH /drive/v3/files/{file_id} for metadata.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","format":"binary","description":"The new file content - sent as the raw request body (Content-Type should be the file's MIME type).","required":true}}},"example":{"file":"(binary)"}}}}}},"/upload/drive/v3/files/multipart":{"post":{"tags":["Files"],"parameters":[{"name":"fields","in":"query","description":"The paths of the fields you want included in the response, e.g. 'id,name,size'. Optional.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/files/create","api_endpoint":"https://www.googleapis.com/upload/drive/v3/files?uploadType=multipart"},"summary":"Create a file with name and content in one call (multipart upload)","description":"Creates a file with metadata AND content in a single request (Google uploadType=multipart). Send the file plus metadata fields (name, mimeType, description) together - the platform builds the multipart/related envelope.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","format":"binary","description":"The file content.","required":true},"name":{"type":"string","description":"The name of the file (e.g. 'report.pdf').","required":true},"mimeType":{"type":"string","description":"The MIME type of the content (e.g. 'application/pdf')."},"description":{"type":"string","description":"A short description of the file."}}},"example":{"file":"(binary)","name":"","mimeType":"","description":""}}}}}},"/upload/drive/v3/files/resumable":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/reference/rest/v3/files/create","api_endpoint":"https://www.googleapis.com/upload/drive/v3/files?uploadType=resumable"},"summary":"Start a resumable upload session (step 1: metadata, get session URL)","description":"Step 1 of a resumable upload: send the file metadata as JSON; Google answers with the upload session URL in the X-Upload-Session response header. PUT the file bytes to that session via /upload/drive/v3/files/resumable/session.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"name":{"type":"string","description":"The name of the file (e.g. 'big-video.mp4').","required":true},"mimeType":{"type":"string","description":"The MIME type of the content."}}},"example":{"name":"","mimeType":""}}}}}},"/upload/drive/v3/files/resumable/session":{"put":{"tags":["Files"],"parameters":[{"name":"upload_url","in":"query","description":"The session URL from step 1's X-Upload-Session response header.","required":true,"schema":{"type":"string","example":""}},{"name":"fields","in":"query","description":"The paths of the fields you want included in the response. Optional.","required":false,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://developers.google.com/drive/api/guides/manage-uploads","api_endpoint":"https://www.googleapis.com/upload/drive/v3/files"},"summary":"Upload file bytes to a resumable session (step 2)","description":"Step 2 of a resumable upload: PUT the file bytes (whole file in one call) to the session opened by /upload/drive/v3/files/resumable. Pass the session URL from the X-Upload-Session response header as the upload_url query parameter.","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":false,"content":{"multipart/form-data":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","format":"binary","description":"The file content (sent as the raw request body).","required":true}}},"example":{"file":"(binary)"}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}