Opens project's Google Drive folder in browser.
Arguments
- path
(optional) Path inside the Google Drive folder to open. Defaults to the root level (path = "") of the project's folder.
- root
Google Drive ID or URL of the project root. This serves as the reference point for all relative paths. When left as
NULL
, the root is automatically derived from thecloudfs.drive
field of the project's DESCRIPTION file.
Value
Invisibly returns NULL
. The primary purpose of this function is its
side effect: opening the specified Google Drive folder in a browser.
Details
Google Drive file structure is different from the usual file structure like e.g. on Linux or Windows. A folder on Google Drive can have two or more child folders with the same name. Google Drive marks files and folders with so-called id values to distinguish between them. These values are always unique. You can see them in browser URL for example. The concept of "name" is in the first place for convenience of the end user.
In such a setup a relative file path may correspond to multiple files or folders. This function however works under assumption that the relative path you pass to it defines strictly one object. If there's any ambiguity it throws an error.