drive_mv {googledrive} | R Documentation |
Move a Drive file to a different folder, give it a different name, or both.
drive_mv( file, path = NULL, name = NULL, overwrite = NA, verbose = deprecated() )
file |
Something that identifies the file of interest on your Google
Drive. Can be a name or path, a file id or URL marked with |
path |
Specifies target destination for the file on Google
Drive. Can be an actual path (character), a file id marked with
If If |
name |
Character, new file name if not specified as part of
|
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.
Makes a metadata-only request to the files.update
endpoint:
# create a file to move file <- drive_example_remote("chicken.txt") %>% drive_cp("chicken-mv.txt") # rename it, but leave in current folder (root folder, in this case) file <- drive_mv(file, "chicken-mv-renamed.txt") # create a folder to move the file into folder <- drive_mkdir("mv-folder") # move the file and rename it again, # specify destination as a dribble file <- drive_mv(file, path = folder, name = "chicken-mv-re-renamed.txt") # verify renamed file is now in the folder drive_ls(folder) # move the file back to root folder file <- drive_mv(file, "~/") # move it again # specify destination as path with trailing slash # to ensure we get a move vs. renaming it to "mv-folder" file <- drive_mv(file, "mv-folder/") # `overwrite = FALSE` errors if something already exists at target filepath # THIS WILL ERROR! drive_create("name-squatter-mv", path = "~/") drive_mv(file, path = "~/", name = "name-squatter-mv", overwrite = FALSE) # `overwrite = TRUE` moves the existing item to trash, then proceeds drive_mv(file, path = "~/", name = "name-squatter-mv", overwrite = TRUE) # Clean up drive_rm(file, folder)