Authorize googledrive to view and manage your Drive files. This function is a
By default, you are directed to a web browser, asked to sign in to your Google account, and to grant googledrive permission to operate on your behalf with Google Drive. By default, with your permission, these user credentials are cached in a folder below your home directory, from where they can be automatically refreshed, as necessary. Storage at the user level means the same token can be used across multiple projects and tokens are less likely to be synced to the cloud by accident.
If you are interacting with R within a browser (applies to RStudio Server,
RStudio Workbench, and RStudio Cloud), you need a variant of this flow,
known as out-of-band auth ("oob"). If this does not happen
automatically, you can request it yourself with
use_oob = TRUE or,
more persistently, by setting an option via
options(gargle_oob_default = TRUE).
1 2 3 4 5 6 7 8
Optional. Allows user to target a specific Google identity. If
specified, this is used for token lookup, i.e. to determine if a suitable
token is already available in the cache. If no such token is found,
JSON identifying the service account, in one of the forms
supported for the
A character vector of scopes to request. Pick from those listed at https://developers.google.com/identity/protocols/oauth2/scopes.
For certain token flows, the
Specifies the OAuth token cache. Defaults to the option named
"gargle_oauth_cache", retrieved via
Whether to prefer "out of band" authentication. Defaults to
the option named "gargle_oob_default", retrieved via
A token with class Token2.0 or an object of
Most users, most of the time, do not need to call
explicitly – it is triggered by the first action that requires
authorization. Even when called, the default arguments often suffice.
However, when necessary, this function allows the user to explicitly:
Declare which Google identity to use, via an email address. If there
are multiple cached tokens, this can clarify which one to use. It can
also force googledrive to switch from one identity to another. If
there's no cached token for the email, this triggers a return to the
browser to choose the identity and give consent. You can specify just
the domain by using a glob pattern. This means that a script
email = "*@example.com" can be run without further
tweaks on the machine of either
Use a service account token or workload identity federation.
Bring their own Token2.0.
Specify non-default behavior re: token caching and out-of-bound authentication.
For details on the many ways to find a token, see
gargle::token_fetch(). For deeper control over auth, use
drive_auth_configure() to bring your own OAuth app or API key.
Read more about gargle options, see gargle::gargle_options.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
## Not run: # load/refresh existing credentials, if available # otherwise, go to browser for authentication and authorization drive_auth() # see user associated with current token drive_user() # force use of a token associated with a specific email drive_auth(email = "email@example.com") drive_user() # force the OAuth web dance drive_auth(email = NA) # use a 'read only' scope, so it's impossible to edit or delete files drive_auth( scopes = "https://www.googleapis.com/auth/drive.readonly" ) # use a service account token drive_auth(path = "foofy-83ee9e7c9c48.json") ## End(Not run)
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.