drive_mkdir {googledrive} | R Documentation |
Creates a new Drive folder. To update the metadata of an existing Drive file,
including a folder, use drive_update()
.
drive_mkdir(name, path = NULL, ..., overwrite = NA, verbose = deprecated())
name |
Name for the new folder or, optionally, a path that specifies an existing parent folder, as well as the new name. |
path |
Target destination for the new folder, i.e. a folder or a
shared drive. Can be given as an actual path (character), a file id or URL
marked with |
... |
Named parameters to pass along to the Drive API. Has dynamic dots semantics. You can affect the metadata of the target file by
specifying properties of the Files resource via |
overwrite |
Logical, indicating whether to check for a pre-existing file
at the targetted "filepath". The quotes around "filepath" refer to the fact
that Drive does not impose a 1-to-1 relationship between filepaths and files,
like a typical file system; read more about that in
Note that existence checks, based on filepath, are expensive operations, i.e. they require additional API calls. |
verbose |
|
An object of class dribble
, a tibble with one row per file.
Wraps the files.create
endpoint:
# Create folder named 'ghi', then another below named it 'jkl' and star it ghi <- drive_mkdir("ghi") jkl <- drive_mkdir("ghi/jkl", starred = TRUE) # is 'jkl' really starred? YES purrr::pluck(jkl, "drive_resource", 1, "starred") # Another way to create folder 'mno' in folder 'ghi' drive_mkdir("mno", path = "ghi") # Yet another way to create a folder named 'pqr' in folder 'ghi', # this time with parent folder stored in a dribble, # and setting the new folder's description pqr <- drive_mkdir("pqr", path = ghi, description = "I am a folder") # Did we really set the description? YES purrr::pluck(pqr, "drive_resource", 1, "description") # `overwrite = FALSE` errors if something already exists at target filepath # THIS WILL ERROR! drive_create("name-squatter-mkdir", path = ghi) drive_mkdir("name-squatter-mkdir", path = ghi, overwrite = FALSE) # `overwrite = TRUE` moves the existing item to trash, then proceeds drive_mkdir("name-squatter-mkdir", path = ghi, overwrite = TRUE) # list everything inside 'ghi' drive_ls("ghi") # Clean up drive_rm(ghi)