drive_create {googledrive} | R Documentation |
Creates a new blank Drive file. Note there are better options for these special cases:
Creating a folder? Use drive_mkdir()
.
Want to upload existing local content into a new Drive file? Use
drive_upload()
.
drive_create( name, path = NULL, type = NULL, ..., overwrite = NA, verbose = deprecated() )
name |
Name for the new file or, optionally, a path that specifies an existing parent folder, as well as the new file name. |
path |
Target destination for the new item, i.e. a folder or a
shared drive. Can be given as an actual path (character), a file id or URL
marked with |
type |
Character. Create a blank Google Doc, Sheet or Slides by
setting |
... |
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 a blank Google Doc named 'WordStar' in # your 'My Drive' root folder and star it wordstar <- drive_create("WordStar", type = "document", starred = TRUE) # is 'WordStar' really starred? YES purrr::pluck(wordstar, "drive_resource", 1, "starred") # Create a blank Google Slides presentation in # the root folder, and set its description execuvision <- drive_create( "ExecuVision", type = "presentation", description = "deeply nested bullet lists FTW" ) # Did we really set the description? YES purrr::pluck(execuvision, "drive_resource", 1, "description") # check out the new presentation drive_browse(execuvision) # Create folder 'b4xl' in the root folder, # then create an empty new Google Sheet in it b4xl <- drive_mkdir("b4xl") drive_create("VisiCalc", path = b4xl, type = "spreadsheet") # Another way to create a Google Sheet in the folder 'b4xl' drive_create("b4xl/SuperCalc", type = "spreadsheet") # Yet another way to create a new file in a folder, # this time specifying parent `path` as a character drive_create("Lotus 1-2-3", path = "b4xl", type = "spreadsheet") # Did we really create those Sheets in the intended folder? YES drive_ls("b4xl") # `overwrite = FALSE` errors if file already exists at target filepath # THIS WILL ERROR! drive_create("VisiCalc", path = b4xl, overwrite = FALSE) # `overwrite = TRUE` moves an existing file to trash, then proceeds drive_create("VisiCalc", path = b4xl, overwrite = TRUE) # clean up drive_rm(wordstar, b4xl, execuvision)