These functions give more control over and visibility into the auth
configuration than ladder_auth()
does. ladder_auth_configure()
lets the user specify their own:
OAuth client, which is used when obtaining a user token.
API key. If ladder is de-authorized via
ladder_deauth()
, all requests are sent with an API key in lieu of a token.
See the vignette("get-api-credentials", package = "gargle")
for more.
If the user does not configure these settings, internal defaults
are used.
ladder_oauth_client()
and ladder_api_key()
retrieve the
currently configured OAuth client and API key, respectively.
Arguments
- client
A Google OAuth client, presumably constructed via
gargle::gargle_oauth_client_from_json()
. Note, however, that it is preferred to specify the client with JSON, using thepath
argument.- path
JSON downloaded from Google Cloud Console, containing a client id and secret, in one of the forms supported for the
txt
argument ofjsonlite::fromJSON()
(typically, a file path or JSON string).- api_key
API key.
- app
Value
ladder_auth_configure()
: An object of R6 class gargle::AuthState, invisibly.ladder_oauth_client()
: the current user-configured OAuth client.ladder_api_key()
: the current user-configured API key.
See also
Other auth functions:
ladder_auth()
,
ladder_deauth()
Examples
# see and store the current user-configured OAuth client (probaby `NULL`)
(original_client <- ladder_oauth_client())
#> NULL
# see and store the current user-configured API key (probaby `NULL`)
(original_api_key <- ladder_api_key())
#> NULL
# the preferred way to configure your own client is via a JSON file
# downloaded from Google Developers Console
# this example JSON is indicative, but fake
path_to_json <- system.file(
"extdata", "client_secret_installed.googleusercontent.com.json",
package = "gargle"
)
ladder_auth_configure(path = path_to_json)
# this is also obviously a fake API key
ladder_auth_configure(api_key = "the_key_I_got_for_a_google_API")
# confirm the changes
ladder_oauth_client()
#> <gargle_oauth_client>
#> name: a_project_d1c5a8066d2cbe48e8d94514dd286163
#> id: abc.apps.googleusercontent.com
#> secret: <REDACTED>
#> type: installed
#> redirect_uris: http://localhost
ladder_api_key()
#> [1] "the_key_I_got_for_a_google_API"
# restore original auth config
ladder_auth_configure(client = original_client, api_key = original_api_key)