gargle (version 1.2.1)

token_fetch: Fetch a token for the given scopes

Description

This is a rather magical function that calls a series of concrete credential-fetching functions, each wrapped in a tryCatch(). token_fetch() keeps trying until it succeeds or there are no more functions to try. Use cred_funs_list() to see the current registry, in order. See the vignette How gargle gets tokens for a full description of token_fetch().

Usage

token_fetch(scopes = NULL, ...)

Value

An httr::Token or NULL.

Arguments

scopes

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 "https://www.googleapis.com/auth/userinfo.email" scope is unconditionally included. This grants permission to retrieve the email address associated with a token; gargle uses this to index cached OAuth tokens. This grants no permission to view or send email and is generally considered a low-value scope.

...

Additional arguments passed to all credential functions.

See Also

Other credential functions: credentials_app_default(), credentials_byo_oauth2(), credentials_external_account(), credentials_gce(), credentials_service_account(), credentials_user_oauth2()

Examples

if (FALSE) {
token_fetch(scopes = "https://www.googleapis.com/auth/userinfo.email")
}