Share a Google Drive file
Input
fileId requiredDrive file id, i.e. the <id> in drive.google.com/file/d/<id>/view.
role optionalAccess level to grant/update when email is given. Ignored when revoke is true.
email optionalEmail to grant, update, or revoke access for. Combine with role to grant/update; combine with revoke:true to remove access.
notify optionalWhether to email the person when granting access. Defaults to Drive's own default (checked/true). Ignored for revoke/linkSharing.
revoke optionalWhen true (with email), removes that person's access instead of granting/updating it.
linkSharing optionalSets the file's general link-sharing mode. Provide this instead of email/role/revoke.
Output
action requiredfileId requiredconfirmed requiredTrue if the site's own response confirmed the change (a permission id for grant, 204/200 for revoke, the new access level for link sharing). Also true on a no-op linkSharing call, where alreadySet reports the mode was already in force so no request was needed.
role optionalemail optionalalreadySet optionallinkSharing only, and always present there: true when the requested mode was already the file's current one, so nothing changed and Drive issued no request; false when this call actually changed it. Absent for grant and revoke.
linkSharing optionalMove a Google Drive file to the Bin
Moves a file to Drive's Bin (never a permanent delete), given just the file's id — its parent folder is resolved automatically.
Upload a file to Google Drive
Upload a file into a Google Drive folder, or into My Drive when no folder is given. Pass the bytes inline as base64 for small files, or point fileUrl at the file served over http://127.0.0.1:<port>/ on the machine running the browser for larger ones. Before reporting success it waits for a row in the destination that was absent beforehand AND carries this call's own filename, so it cannot credit itself with a file another upload created; it returns that file's Drive id. A filename already present in the destination is refused up front, because a dropped file does NOT replace or get declined — Drive happily stores a second, separate file under the same name. For the same reason a lost upload is reported as a failure rather than retried: a re-drop would duplicate an upload that merely landed slowly.
List a Google Drive folder
List the files and sub-folders directly inside a Google Drive folder, without recursing or downloading anything. Returns each item's id, name, type, size, last-modified date, owner and link. Omit folderId to list My Drive's root.