drive_upload {googledrive} | R Documentation |
Uploads a local file into a new Drive file. To update the content or metadata
of an existing Drive file, use drive_update()
. To upload or update,
depending on whether the Drive file already exists, see drive_put()
.
drive_upload( media, path = NULL, name = NULL, type = NULL, ..., overwrite = NA, verbose = deprecated() )
media |
Character, path to the local file to upload. |
path |
Specifies target destination for the new 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
|
type |
Character. If |
... |
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:
MIME types that can be converted to native Google formats:
# upload a csv file chicken_csv <- drive_example_local("chicken.csv") %>% drive_upload("chicken-upload.csv") # or convert it to a Google Sheet chicken_sheet <- drive_example_local("chicken.csv") %>% drive_upload( name = "chicken-sheet-upload.csv", type = "spreadsheet" ) # check out the new Sheet! drive_browse(chicken_sheet) # clean-up drive_find("chicken.*upload") %>% drive_rm() # Upload a file and, at the same time, star it chicken <- drive_example_local("chicken.jpg") %>% drive_upload(starred = "true") # Is is really starred? YES purrr::pluck(chicken, "drive_resource", 1, "starred") # Clean up drive_rm(chicken) # `overwrite = FALSE` errors if something already exists at target filepath # THIS WILL ERROR! drive_create("name-squatter") drive_example_local("chicken.jpg") %>% drive_upload( name = "name-squatter", overwrite = FALSE ) # `overwrite = TRUE` moves the existing item to trash, then proceeds chicken <- drive_example_local("chicken.jpg") %>% drive_upload( name = "name-squatter", overwrite = TRUE ) # Clean up drive_rm(chicken) ## Not run: # Upload to a shared drive: # * Shared drives are only available if your account is associated with a # Google Workspace # * The shared drive (or shared-drive-hosted folder) MUST be captured as a # dribble first and provided via `path` sd <- shared_drive_get("Marketing") drive_upload("fascinating.csv", path = sd) ## End(Not run)