drive_share: Share Drive files

In googledrive: An Interface to Google Drive

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().

Usage

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

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 as_id(), or a dribble.
role	Character. The role to grant. Must be one of: organizer (applies only to Team Drives) owner writer commenter reader
type	Character. Describes the grantee. Must be one of: user group domain anyone
...	Name-value pairs to add to the API request. This is where you provide additional information, such as the emailAddress (when grantee type is "group" or "user") or the domain (when grantee type is "domain"). Read the API docs linked below for more details.
verbose	Logical, indicating whether to print informative messages (default TRUE).

Value

An object of class dribble, a tibble with one row per item.

See Also

Wraps the permissions.update endpoint:

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

Examples

## Not run: 
## Upload a file to share
file <- drive_upload(
   drive_example("chicken.txt"),
   name = "chicken-share.txt",
   type = "document"
)

## Let a specific person comment
file <- file %>%
  drive_share(
    role = "commenter",
    type = "user",
    emailAddress = "[email protected]"
)

## Let a different specific person edit and customize the email notification
file <- file %>%
  drive_share(
    role = "writer",
    type = "user",
    emailAddress = "[email protected]",
    emailMessage = "Would appreciate your feedback on this!"
)

## Let anyone read the file
file <- file %>%
  drive_share(role = "reader", type = "anyone")

## Clean up
drive_rm(file)

## End(Not run)

googledrive documentation built on May 2, 2019, 1:26 p.m.