drive_share {googledrive} | R Documentation |
Share Drive files
Description
Grant individuals or other groups access to files, including permission to
read, comment, or edit. The returned dribble
will have extra columns,
shared
and permissions_resource
. Read more in drive_reveal()
.
drive_share_anyone()
is a convenience wrapper for a common special case:
"make this file
readable by 'anyone with a link'".
Usage
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())
Arguments
file |
Something that identifies the file(s) of interest on your Google
Drive. Can be a character vector of names/paths, a character vector of file
ids or URLs marked with |
role |
Character. The role to grant. Must be one of:
|
type |
Character. Describes the grantee. Must be one of:
|
... |
Name-value pairs to add to the API request. This is where you
provide additional information, such as the |
verbose |
This logical argument to
individual googledrive functions is deprecated. To globally suppress
googledrive messaging, use |
Value
An object of class dribble
, a tibble with one row per file.
There will be extra columns, shared
and
permissions_resource
.
See Also
Wraps the permissions.create
endpoint:
Drive roles and permissions are described here:
Examples
# Create a file to share
file <- drive_example_remote("chicken_doc") %>%
drive_cp(name = "chicken-share.txt")
# Let a specific person comment
file <- file %>%
drive_share(
role = "commenter",
type = "user",
emailAddress = "susan@example.com"
)
# 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!"
)
# Let anyone read the file
file <- file %>%
drive_share(role = "reader", type = "anyone")
# Single-purpose wrapper function for this
drive_share_anyone(file)
# Clean up
drive_rm(file)