R googledrive drive_share 共享云端硬盘文件

授予个人或其他组对文件的访问权限，包括阅读、评论或编辑的权限。返回的 dribble 将具有额外的列 shared 和 permissions_resource 。阅读drive_reveal() 了解更多内容。

drive_share_anyone() 是常见特殊情况的便捷包装：“使‘任何有链接的人’都可以读取此file”。

用法

drive_share(
  file,
  role = c("reader", "commenter", "writer", "fileOrganizer", "owner", "organizer"),
  type = c("user", "group", "domain", "anyone"),
  ...,
  verbose = deprecated()
)

drive_share_anyone(file, verbose = deprecated())

参数

file

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

role

特点。要授予的角色。必须是以下之一：

所有者(不允许在共享云端硬盘中)
管理器(适用于共享云端硬盘)
fileOrganizer(适用于共享驱动器)
writer
commenter
reader

type

特点。说明受资助者。必须是以下之一：

user
group
domain
anyone

...

Name-value 对添加到 API 请求。您可以在此处提供其他信息，例如 emailAddress(当受让人 type 为 "group" 或 "user" 时)或 domain(当受让人类型为 "domain" 时)。请阅读下面链接的 API 文档以了解更多详细信息。

verbose

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

值

dribble 类的对象，每个文件一行的 tibble。将有额外的列 shared 和 permissions_resource 。

也可以看看

包装 permissions.create 端点：

https://developers.google.com/drive/api/v3/reference/permissions/create

驱动器角色和权限说明如下：

https://developers.google.com/drive/api/v3/ref-roles

例子

# Create a file to share
file <- drive_example_remote("chicken_doc") %>%
  drive_cp(name = "chicken-share.txt")
#> Original file:
#> • chicken_doc <id: 1X9pd4nOjl33zDFfTjw-_eFL7Qb9_g6VfVFDp1PPae94>
#> Copied to file:
#> • chicken-share.txt <id: 1mC9BCArLrNO-YB2VpE6DqXiOpZi8OBT9tn-HytrLdRo>

# Let a specific person comment
file <- file %>%
  drive_share(
    role = "commenter",
    type = "user",
    emailAddress = "susan@example.com"
  )
#> Permissions updated:
#> • role = commenter
#> • type = user
#> For file:
#> • chicken-share.txt <id: 1mC9BCArLrNO-YB2VpE6DqXiOpZi8OBT9tn-HytrLdRo>

# Let a different specific person edit and customize the email notification
file <- file %>%
  drive_share(
    role = "writer",
    type = "user",
    emailAddress = "carol@example.com",
    emailMessage = "Would appreciate your feedback on this!"
  )
#> Permissions updated:
#> • role = writer
#> • type = user
#> For file:
#> • chicken-share.txt <id: 1mC9BCArLrNO-YB2VpE6DqXiOpZi8OBT9tn-HytrLdRo>

# Let anyone read the file
file <- file %>%
  drive_share(role = "reader", type = "anyone")
#> Permissions updated:
#> • role = reader
#> • type = anyone
#> For file:
#> • chicken-share.txt <id: 1mC9BCArLrNO-YB2VpE6DqXiOpZi8OBT9tn-HytrLdRo>
# Single-purpose wrapper function for this
drive_share_anyone(file)
#> Permissions updated:
#> • role = reader
#> • type = anyone
#> For file:
#> • chicken-share.txt <id: 1mC9BCArLrNO-YB2VpE6DqXiOpZi8OBT9tn-HytrLdRo>

# Clean up
drive_rm(file)
#> File deleted:
#> • chicken-share.txt <id: 1mC9BCArLrNO-YB2VpE6DqXiOpZi8OBT9tn-HytrLdRo>

源代码：R/drive_share.R

相关用法

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