UNPKG

openapi-directory

Version:

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

1 lines 100 kB
{"openapi":"3.0.0","info":{"contact":{"name":"Google","url":"https://google.com"},"description":"Manages files in Drive including uploading, downloading, searching, detecting changes, and updating sharing permissions.","title":"Drive","version":"v3","x-apiClientRegistration":{"url":"https://console.developers.google.com"},"x-apisguru-categories":["storage"],"x-logo":{"url":"https://www.gstatic.com/images/icons/material/product/2x/drive_32dp.png"},"x-origin":[{"converter":{"url":"https://github.com/lucybot/api-spec-converter","version":"2.7.18"},"format":"google","url":"https://www.googleapis.com/discovery/v1/apis/drive/v3/rest","version":"v1"}],"x-preferred":true,"x-providerName":"googleapis.com","x-serviceName":"drive"},"externalDocs":{"url":"https://developers.google.com/drive/"},"tags":[{"name":"about"},{"name":"changes"},{"name":"channels"},{"name":"comments"},{"name":"files"},{"name":"permissions"},{"name":"replies"},{"name":"revisions"},{"name":"teamdrives"}],"paths":{"/about":{"get":{"description":"Gets information about the user, the user's Drive, and system capabilities.","operationId":"drive.about.get","responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/About"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.appdata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.photos.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.readonly"]}],"tags":["about"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]},"/changes":{"get":{"description":"Lists the changes for a user or Team Drive.","operationId":"drive.changes.list","parameters":[{"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.","in":"query","name":"includeCorpusRemovals","schema":{"type":"boolean","default":false}},{"description":"Whether to include changes indicating that items have been removed from the list of changes, for example by deletion or loss of access.","in":"query","name":"includeRemoved","schema":{"type":"boolean","default":true}},{"description":"Whether Team Drive files or changes should be included in results.","in":"query","name":"includeTeamDriveItems","schema":{"type":"boolean","default":false}},{"description":"The maximum number of changes to return per page.","in":"query","name":"pageSize","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}},{"description":"The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response or to the response from the getStartPageToken method.","in":"query","name":"pageToken","required":true,"schema":{"type":"string"}},{"description":"Whether to restrict the results to changes inside the My Drive hierarchy. This omits changes to files such as those in the Application Data folder or shared files which have not been added to My Drive.","in":"query","name":"restrictToMyDrive","schema":{"type":"boolean","default":false}},{"description":"A comma-separated list of spaces to query within the user corpus. Supported values are 'drive', 'appDataFolder' and 'photos'.","in":"query","name":"spaces","schema":{"type":"string","default":"drive"}},{"description":"Whether the requesting application supports Team Drives.","in":"query","name":"supportsTeamDrives","schema":{"type":"boolean","default":false}},{"description":"The Team Drive from which changes will be returned. If specified the change IDs will be reflective of the Team Drive; use the combined Team Drive ID and change ID as an identifier.","in":"query","name":"teamDriveId","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ChangeList"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.appdata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.photos.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.readonly"]}],"tags":["changes"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]},"/changes/startPageToken":{"get":{"description":"Gets the starting pageToken for listing future changes.","operationId":"drive.changes.getStartPageToken","parameters":[{"description":"Whether the requesting application supports Team Drives.","in":"query","name":"supportsTeamDrives","schema":{"type":"boolean","default":false}},{"description":"The ID of the Team Drive for which the starting pageToken for listing future changes from that Team Drive will be returned.","in":"query","name":"teamDriveId","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/StartPageToken"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.appdata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.photos.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.readonly"]}],"tags":["changes"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]},"/changes/watch":{"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"post":{"description":"Subscribes to changes for a user.","operationId":"drive.changes.watch","parameters":[{"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.","in":"query","name":"includeCorpusRemovals","schema":{"type":"boolean","default":false}},{"description":"Whether to include changes indicating that items have been removed from the list of changes, for example by deletion or loss of access.","in":"query","name":"includeRemoved","schema":{"type":"boolean","default":true}},{"description":"Whether Team Drive files or changes should be included in results.","in":"query","name":"includeTeamDriveItems","schema":{"type":"boolean","default":false}},{"description":"The maximum number of changes to return per page.","in":"query","name":"pageSize","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}},{"description":"The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response or to the response from the getStartPageToken method.","in":"query","name":"pageToken","required":true,"schema":{"type":"string"}},{"description":"Whether to restrict the results to changes inside the My Drive hierarchy. This omits changes to files such as those in the Application Data folder or shared files which have not been added to My Drive.","in":"query","name":"restrictToMyDrive","schema":{"type":"boolean","default":false}},{"description":"A comma-separated list of spaces to query within the user corpus. Supported values are 'drive', 'appDataFolder' and 'photos'.","in":"query","name":"spaces","schema":{"type":"string","default":"drive"}},{"description":"Whether the requesting application supports Team Drives.","in":"query","name":"supportsTeamDrives","schema":{"type":"boolean","default":false}},{"description":"The Team Drive from which changes will be returned. If specified the change IDs will be reflective of the Team Drive; use the combined Team Drive ID and change ID as an identifier.","in":"query","name":"teamDriveId","schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/Channel"},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Channel"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.appdata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.photos.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.readonly"]}],"tags":["changes"]}},"/channels/stop":{"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"post":{"description":"Stop watching resources through this channel","operationId":"drive.channels.stop","requestBody":{"$ref":"#/components/requestBodies/Channel"},"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.appdata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.photos.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.readonly"]}],"tags":["channels"]}},"/files":{"get":{"description":"Lists or searches files.","operationId":"drive.files.list","parameters":[{"description":"Comma-separated list of bodies of items (files/documents) to which the query applies. Supported bodies are 'user', 'domain', 'teamDrive' and 'allTeamDrives'. 'allTeamDrives' must be combined with 'user'; all other values must be used in isolation. Prefer 'user' or 'teamDrive' to 'allTeamDrives' for efficiency.","in":"query","name":"corpora","schema":{"type":"string"}},{"description":"The source of files to list. Deprecated: use 'corpora' instead.","in":"query","name":"corpus","schema":{"type":"string","enum":["domain","user"]}},{"description":"Whether Team Drive items should be included in results.","in":"query","name":"includeTeamDriveItems","schema":{"type":"boolean","default":false}},{"description":"A comma-separated list of sort keys. Valid keys are 'createdTime', 'folder', 'modifiedByMeTime', 'modifiedTime', 'name', 'name_natural', 'quotaBytesUsed', 'recency', 'sharedWithMeTime', 'starred', and 'viewedByMeTime'. Each key sorts ascending by default, but may be reversed with the 'desc' modifier. Example usage: ?orderBy=folder,modifiedTime desc,name. Please note that there is a current limitation for users with approximately one million files in which the requested sort order is ignored.","in":"query","name":"orderBy","schema":{"type":"string"}},{"description":"The maximum number of files to return per page. Partial or empty result pages are possible even before the end of the files list has been reached.","in":"query","name":"pageSize","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100}},{"description":"The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"A query for filtering the file results. See the \"Search for Files\" guide for supported syntax.","in":"query","name":"q","schema":{"type":"string"}},{"description":"A comma-separated list of spaces to query within the corpus. Supported values are 'drive', 'appDataFolder' and 'photos'.","in":"query","name":"spaces","schema":{"type":"string","default":"drive"}},{"description":"Whether the requesting application supports Team Drives.","in":"query","name":"supportsTeamDrives","schema":{"type":"boolean","default":false}},{"description":"ID of Team Drive to search.","in":"query","name":"teamDriveId","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/FileList"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.appdata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.photos.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.readonly"]}],"tags":["files"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"post":{"description":"Creates a new file.","operationId":"drive.files.create","parameters":[{"description":"Whether to ignore the domain's default visibility settings for the created file. Domain administrators can choose to make all uploaded files visible to the domain by default; this parameter bypasses that behavior for the request. Permissions are still inherited from parent folders.","in":"query","name":"ignoreDefaultVisibility","schema":{"type":"boolean","default":false}},{"description":"Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Drive.","in":"query","name":"keepRevisionForever","schema":{"type":"boolean","default":false}},{"description":"A language hint for OCR processing during image import (ISO 639-1 code).","in":"query","name":"ocrLanguage","schema":{"type":"string"}},{"description":"Whether the requesting application supports Team Drives.","in":"query","name":"supportsTeamDrives","schema":{"type":"boolean","default":false}},{"description":"Whether to use the uploaded content as indexable text.","in":"query","name":"useContentAsIndexableText","schema":{"type":"boolean","default":false}}],"requestBody":{"$ref":"#/components/requestBodies/File"},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/File"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.appdata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]}],"tags":["files"]}},"/files/generateIds":{"get":{"description":"Generates a set of file IDs which can be provided in create requests.","operationId":"drive.files.generateIds","parameters":[{"description":"The number of IDs to return.","in":"query","name":"count","schema":{"type":"integer","minimum":1,"maximum":1000,"default":10}},{"description":"The space in which the IDs can be used to create new files. Supported values are 'drive' and 'appDataFolder'.","in":"query","name":"space","schema":{"type":"string","default":"drive"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/GeneratedIds"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.appdata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]}],"tags":["files"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]},"/files/trash":{"delete":{"description":"Permanently deletes all of the user's trashed files.","operationId":"drive.files.emptyTrash","responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]}],"tags":["files"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]},"/files/{fileId}":{"delete":{"description":"Permanently deletes a file owned by the user without moving it to the trash. If the file belongs to a Team Drive the user must be an organizer on the parent. If the target is a folder, all descendants owned by the user are also deleted.","operationId":"drive.files.delete","parameters":[{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"Whether the requesting application supports Team Drives.","in":"query","name":"supportsTeamDrives","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.appdata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]}],"tags":["files"]},"get":{"description":"Gets a file's metadata or content by ID.","operationId":"drive.files.get","parameters":[{"description":"Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when alt=media.","in":"query","name":"acknowledgeAbuse","schema":{"type":"boolean","default":false}},{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"Whether the requesting application supports Team Drives.","in":"query","name":"supportsTeamDrives","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/File"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.appdata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.photos.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.readonly"]}],"tags":["files"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"patch":{"description":"Updates a file's metadata and/or content with patch semantics.","operationId":"drive.files.update","parameters":[{"description":"A comma-separated list of parent IDs to add.","in":"query","name":"addParents","schema":{"type":"string"}},{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Drive.","in":"query","name":"keepRevisionForever","schema":{"type":"boolean","default":false}},{"description":"A language hint for OCR processing during image import (ISO 639-1 code).","in":"query","name":"ocrLanguage","schema":{"type":"string"}},{"description":"A comma-separated list of parent IDs to remove.","in":"query","name":"removeParents","schema":{"type":"string"}},{"description":"Whether the requesting application supports Team Drives.","in":"query","name":"supportsTeamDrives","schema":{"type":"boolean","default":false}},{"description":"Whether to use the uploaded content as indexable text.","in":"query","name":"useContentAsIndexableText","schema":{"type":"boolean","default":false}}],"requestBody":{"$ref":"#/components/requestBodies/File"},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/File"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.appdata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.scripts"]}],"tags":["files"]}},"/files/{fileId}/comments":{"get":{"description":"Lists a file's comments.","operationId":"drive.comments.list","parameters":[{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"Whether to include deleted comments. Deleted comments will not include their original content.","in":"query","name":"includeDeleted","schema":{"type":"boolean","default":false}},{"description":"The maximum number of comments to return per page.","in":"query","name":"pageSize","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"description":"The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"The minimum value of 'modifiedTime' for the result comments (RFC 3339 date-time).","in":"query","name":"startModifiedTime","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/CommentList"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.readonly"]}],"tags":["comments"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"post":{"description":"Creates a new comment on a file.","operationId":"drive.comments.create","parameters":[{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/Comment"},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Comment"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]}],"tags":["comments"]}},"/files/{fileId}/comments/{commentId}":{"delete":{"description":"Deletes a comment.","operationId":"drive.comments.delete","parameters":[{"description":"The ID of the comment.","in":"path","name":"commentId","required":true,"schema":{"type":"string"}},{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]}],"tags":["comments"]},"get":{"description":"Gets a comment by ID.","operationId":"drive.comments.get","parameters":[{"description":"The ID of the comment.","in":"path","name":"commentId","required":true,"schema":{"type":"string"}},{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"Whether to return deleted comments. Deleted comments will not include their original content.","in":"query","name":"includeDeleted","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Comment"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.readonly"]}],"tags":["comments"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"patch":{"description":"Updates a comment with patch semantics.","operationId":"drive.comments.update","parameters":[{"description":"The ID of the comment.","in":"path","name":"commentId","required":true,"schema":{"type":"string"}},{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/Comment"},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Comment"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]}],"tags":["comments"]}},"/files/{fileId}/comments/{commentId}/replies":{"get":{"description":"Lists a comment's replies.","operationId":"drive.replies.list","parameters":[{"description":"The ID of the comment.","in":"path","name":"commentId","required":true,"schema":{"type":"string"}},{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"Whether to include deleted replies. Deleted replies will not include their original content.","in":"query","name":"includeDeleted","schema":{"type":"boolean","default":false}},{"description":"The maximum number of replies to return per page.","in":"query","name":"pageSize","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"description":"The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/ReplyList"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.readonly"]}],"tags":["replies"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"post":{"description":"Creates a new reply to a comment.","operationId":"drive.replies.create","parameters":[{"description":"The ID of the comment.","in":"path","name":"commentId","required":true,"schema":{"type":"string"}},{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/Reply"},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Reply"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]}],"tags":["replies"]}},"/files/{fileId}/comments/{commentId}/replies/{replyId}":{"delete":{"description":"Deletes a reply.","operationId":"drive.replies.delete","parameters":[{"description":"The ID of the comment.","in":"path","name":"commentId","required":true,"schema":{"type":"string"}},{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"The ID of the reply.","in":"path","name":"replyId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]}],"tags":["replies"]},"get":{"description":"Gets a reply by ID.","operationId":"drive.replies.get","parameters":[{"description":"The ID of the comment.","in":"path","name":"commentId","required":true,"schema":{"type":"string"}},{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"Whether to return deleted replies. Deleted replies will not include their original content.","in":"query","name":"includeDeleted","schema":{"type":"boolean","default":false}},{"description":"The ID of the reply.","in":"path","name":"replyId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Reply"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.readonly"]}],"tags":["replies"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"patch":{"description":"Updates a reply with patch semantics.","operationId":"drive.replies.update","parameters":[{"description":"The ID of the comment.","in":"path","name":"commentId","required":true,"schema":{"type":"string"}},{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"The ID of the reply.","in":"path","name":"replyId","required":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/Reply"},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Reply"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]}],"tags":["replies"]}},"/files/{fileId}/copy":{"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"post":{"description":"Creates a copy of a file and applies any requested updates with patch semantics.","operationId":"drive.files.copy","parameters":[{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"Whether to ignore the domain's default visibility settings for the created file. Domain administrators can choose to make all uploaded files visible to the domain by default; this parameter bypasses that behavior for the request. Permissions are still inherited from parent folders.","in":"query","name":"ignoreDefaultVisibility","schema":{"type":"boolean","default":false}},{"description":"Whether to set the 'keepForever' field in the new head revision. This is only applicable to files with binary content in Drive.","in":"query","name":"keepRevisionForever","schema":{"type":"boolean","default":false}},{"description":"A language hint for OCR processing during image import (ISO 639-1 code).","in":"query","name":"ocrLanguage","schema":{"type":"string"}},{"description":"Whether the requesting application supports Team Drives.","in":"query","name":"supportsTeamDrives","schema":{"type":"boolean","default":false}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/File"}}}},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/File"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.appdata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.photos.readonly"]}],"tags":["files"]}},"/files/{fileId}/export":{"get":{"description":"Exports a Google Doc to the requested MIME type and returns the exported content. Please note that the exported content is limited to 10MB.","operationId":"drive.files.export","parameters":[{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"The MIME type of the format requested for this export.","in":"query","name":"mimeType","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.readonly"]}],"tags":["files"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]},"/files/{fileId}/permissions":{"get":{"description":"Lists a file's or Team Drive's permissions.","operationId":"drive.permissions.list","parameters":[{"description":"The ID of the file or Team Drive.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"The maximum number of permissions to return per page. When not set for files in a Team Drive, at most 100 results will be returned. When not set for files that are not in a Team Drive, the entire list will be returned.","in":"query","name":"pageSize","schema":{"type":"integer","minimum":1,"maximum":100}},{"description":"The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"Whether the requesting application supports Team Drives.","in":"query","name":"supportsTeamDrives","schema":{"type":"boolean","default":false}},{"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 item belongs.","in":"query","name":"useDomainAdminAccess","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/PermissionList"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.photos.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.readonly"]}],"tags":["permissions"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"post":{"description":"Creates a permission for a file or Team Drive.","operationId":"drive.permissions.create","parameters":[{"description":"A plain text custom message to include in the notification email.","in":"query","name":"emailMessage","schema":{"type":"string"}},{"description":"The ID of the file or Team Drive.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"Whether to send a notification email when sharing to users or groups. This defaults to true for users and groups, and is not allowed for other requests. It must not be disabled for ownership transfers.","in":"query","name":"sendNotificationEmail","schema":{"type":"boolean"}},{"description":"Whether the requesting application supports Team Drives.","in":"query","name":"supportsTeamDrives","schema":{"type":"boolean","default":false}},{"description":"Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect.","in":"query","name":"transferOwnership","schema":{"type":"boolean","default":false}},{"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 item belongs.","in":"query","name":"useDomainAdminAccess","schema":{"type":"boolean","default":false}}],"requestBody":{"$ref":"#/components/requestBodies/Permission"},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Permission"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]}],"tags":["permissions"]}},"/files/{fileId}/permissions/{permissionId}":{"delete":{"description":"Deletes a permission.","operationId":"drive.permissions.delete","parameters":[{"description":"The ID of the file or Team Drive.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"The ID of the permission.","in":"path","name":"permissionId","required":true,"schema":{"type":"string"}},{"description":"Whether the requesting application supports Team Drives.","in":"query","name":"supportsTeamDrives","schema":{"type":"boolean","default":false}},{"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 item belongs.","in":"query","name":"useDomainAdminAccess","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]}],"tags":["permissions"]},"get":{"description":"Gets a permission by ID.","operationId":"drive.permissions.get","parameters":[{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"The ID of the permission.","in":"path","name":"permissionId","required":true,"schema":{"type":"string"}},{"description":"Whether the requesting application supports Team Drives.","in":"query","name":"supportsTeamDrives","schema":{"type":"boolean","default":false}},{"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 item belongs.","in":"query","name":"useDomainAdminAccess","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Permission"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.photos.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.readonly"]}],"tags":["permissions"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"patch":{"description":"Updates a permission with patch semantics.","operationId":"drive.permissions.update","parameters":[{"description":"The ID of the file or Team Drive.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"The ID of the permission.","in":"path","name":"permissionId","required":true,"schema":{"type":"string"}},{"description":"Whether to remove the expiration date.","in":"query","name":"removeExpiration","schema":{"type":"boolean","default":false}},{"description":"Whether the requesting application supports Team Drives.","in":"query","name":"supportsTeamDrives","schema":{"type":"boolean","default":false}},{"description":"Whether to transfer ownership to the specified user and downgrade the current owner to a writer. This parameter is required as an acknowledgement of the side effect.","in":"query","name":"transferOwnership","schema":{"type":"boolean","default":false}},{"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 item belongs.","in":"query","name":"useDomainAdminAccess","schema":{"type":"boolean","default":false}}],"requestBody":{"$ref":"#/components/requestBodies/Permission"},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Permission"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]}],"tags":["permissions"]}},"/files/{fileId}/revisions":{"get":{"description":"Lists a file's revisions.","operationId":"drive.revisions.list","parameters":[{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"The maximum number of revisions to return per page.","in":"query","name":"pageSize","schema":{"type":"integer","minimum":1,"maximum":1000,"default":200}},{"description":"The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response.","in":"query","name":"pageToken","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/RevisionList"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.appdata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.photos.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.readonly"]}],"tags":["revisions"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}]},"/files/{fileId}/revisions/{revisionId}":{"delete":{"description":"Permanently deletes a revision. This method is only applicable to files with binary content in Drive.","operationId":"drive.revisions.delete","parameters":[{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"The ID of the revision.","in":"path","name":"revisionId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response"}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.appdata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]}],"tags":["revisions"]},"get":{"description":"Gets a revision's metadata or content by ID.","operationId":"drive.revisions.get","parameters":[{"description":"Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when alt=media.","in":"query","name":"acknowledgeAbuse","schema":{"type":"boolean","default":false}},{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"The ID of the revision.","in":"path","name":"revisionId","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Revision"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.appdata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.photos.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.readonly"]}],"tags":["revisions"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"patch":{"description":"Updates a revision with patch semantics.","operationId":"drive.revisions.update","parameters":[{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"The ID of the revision.","in":"path","name":"revisionId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Revision"}}}},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Revision"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.appdata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]}],"tags":["revisions"]}},"/files/{fileId}/watch":{"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/parameters/prettyPrint"},{"$ref":"#/components/parameters/quotaUser"},{"$ref":"#/components/parameters/userIp"}],"post":{"description":"Subscribes to changes to a file","operationId":"drive.files.watch","parameters":[{"description":"Whether the user is acknowledging the risk of downloading known malware or other abusive files. This is only applicable when alt=media.","in":"query","name":"acknowledgeAbuse","schema":{"type":"boolean","default":false}},{"description":"The ID of the file.","in":"path","name":"fileId","required":true,"schema":{"type":"string"}},{"description":"Whether the requesting application supports Team Drives.","in":"query","name":"supportsTeamDrives","schema":{"type":"boolean","default":false}}],"requestBody":{"$ref":"#/components/requestBodies/Channel"},"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/Channel"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.appdata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.file"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata"]},{"Oauth2":["https://www.googleapis.com/auth/drive.metadata.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.photos.readonly"]},{"Oauth2":["https://www.googleapis.com/auth/drive.readonly"]}],"tags":["files"]}},"/teamdrives":{"get":{"description":"Lists the user's Team Drives.","operationId":"drive.teamdrives.list","parameters":[{"description":"Maximum number of Team Drives to return.","in":"query","name":"pageSize","schema":{"type":"integer","minimum":1,"maximum":100,"default":10}},{"description":"Page token for Team Drives.","in":"query","name":"pageToken","schema":{"type":"string"}},{"description":"Query string for searching Team Drives.","in":"query","name":"q","schema":{"type":"string"}},{"description":"Issue the request as a domain administrator; if set to true, then all Team Drives of the domain in which the requester is an administrator are returned.","in":"query","name":"useDomainAdminAccess","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Successful response","content":{"*/*":{"schema":{"$ref":"#/components/schemas/TeamDriveList"}}}}},"security":[{"Oauth2":["https://www.googleapis.com/auth/drive"]},{"Oauth2":["https://www.googleapis.com/auth/drive.readonly"]}],"tags":["teamdrives"]},"parameters":[{"$ref":"#/components/parameters/alt"},{"$ref":"#/components/parameters/fields"},{"$ref":"#/components/parameters/key"},{"$ref":"#/components/parameters/oauth_token"},{"$ref":"#/components/