R googledrive drive_rename 重命名云端硬盘文件

这是 drive_mv() 的包装器，仅重命名文件。如果您想重命名并移动文件，请参阅drive_mv()。

用法

drive_rename(file, name = NULL, overwrite = NA, verbose = deprecated())

参数

file

识别您的 Google 云端硬盘上感兴趣的文件的内容。可以是名称或路径、标有 as_id() 或 dribble 的文件 ID 或 URL。

name

特点。您希望文件具有的名称。

overwrite

逻辑，指示是否检查目标"filepath"处是否存在预先存在的文件。 "filepath" 周围的引号是指 Drive 不会像典型的文件系统那样在文件路径和文件之间强加一对一的关系；在 drive_get() 中了解更多相关信息。

NA(默认)：只需执行该操作，即使它会导致多个文件具有相同的文件路径。
TRUE ：检查文件路径中是否存在预先存在的文件。如果有零个或一个，请将预先存在的文件移至箱子，然后继续。请注意，新文件不会继承旧文件的任何属性，例如共享或发布设置。它将有一个新的文件 ID。如果找到两个或多个预先存在的文件，则会引发错误。
FALSE：如果文件路径中存在任何预先存在的文件，则会出错。

请注意，基于文件路径的存在性检查是昂贵的操作，即它们需要额外的 API 调用。

verbose

这种对各个 googledrive 函数的逻辑论证已被弃用。要全局禁止 googledrive 消息传递，请使用options(googledrive_quiet = TRUE)(默认行为是发出信息性消息)。要以更有限的方式抑制消息传递，请使用帮助程序local_drive_quiet()或者with_drive_quiet().

值

dribble 类的对象，每个文件一行的 tibble。

例子

# Create a file to rename
file <- drive_create("file-to-rename")
#> Created Drive file:
#> • file-to-rename <id: 1_ltgJT2TL7gnWp_QhyVIMyXJ4zO3hPqU>
#> With MIME type:
#> • application/octet-stream

# Rename it
file <- drive_rename(file, name = "renamed-file")
#> Original file:
#> • file-to-rename <id: 1_ltgJT2TL7gnWp_QhyVIMyXJ4zO3hPqU>
#> Has been renamed:
#> • renamed-file <id: 1_ltgJT2TL7gnWp_QhyVIMyXJ4zO3hPqU>

# `overwrite = FALSE` errors if something already exists at target filepath
# THIS WILL ERROR!
drive_create("name-squatter-rename")
#> Created Drive file:
#> • name-squatter-rename <id: 1Ms5VnuZ0Zj6YwYH_--QRPn23S9mAK1-H>
#> With MIME type:
#> • application/octet-stream
drive_rename(file, name = "name-squatter-rename", overwrite = FALSE)
#> Error in check_for_overwrite(parent = params[["addParents"]] %||% parent_before,     name = params[["name"]] %||% file$name, overwrite = overwrite): 1 item already exists at the target filepath and `overwrite =
#> FALSE`:
#> • name-squatter-rename <id: 1Ms5VnuZ0Zj6YwYH_--QRPn23S9mAK1-H>

# `overwrite = TRUE` moves the existing item to trash, then proceeds
file <- drive_rename(file, name = "name-squatter-rename", overwrite = TRUE)
#> File trashed:
#> • name-squatter-rename <id: 1Ms5VnuZ0Zj6YwYH_--QRPn23S9mAK1-H>
#> Original file:
#> • renamed-file <id: 1_ltgJT2TL7gnWp_QhyVIMyXJ4zO3hPqU>
#> Has been renamed:
#> • name-squatter-rename <id: 1_ltgJT2TL7gnWp_QhyVIMyXJ4zO3hPqU>

# Clean up
drive_rm(file)
#> File deleted:
#> • name-squatter-rename <id: 1_ltgJT2TL7gnWp_QhyVIMyXJ4zO3hPqU>

源代码：R/drive_rename.R

相关用法

注：本文由纯净天空筛选整理自Jennifer Bryan等大神的英文原创作品 Rename a Drive file。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。