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。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。