Create an AuthState — init_AuthState • gargle

Constructor function for objects of class AuthState.

Usage

init_AuthState(
  package = NA_character_,
  app = NULL,
  api_key = NULL,
  auth_active = TRUE,
  cred = NULL
)

Arguments

package: Package name, an optional string. The associated package will generally by implied by the namespace within which the AuthState is defined. But it's possible to record the package name explicitly and seems like a good practice.
app: A Google OAuth client, preferably constructed via gargle_oauth_client_from_json(), which returns an instance of gargle_oauth_client. For backwards compatibility, for a limited time, gargle will still accept an "OAuth app" created with httr::oauth_app().
api_key: Optional. API key (a string). Some APIs accept unauthorized, "token-free" requests for public resources, but only if the request includes an API key.
auth_active: Logical. TRUE means requests should include a token (and probably not an API key). FALSE means requests should include an API key (and probably not a token).
cred: Credentials. Typically populated indirectly via token_fetch().

Value

An object of class AuthState.

Examples

my_client <- gargle_oauth_client(
  id = "some_long_client_id",
  secret = "ssshhhhh_its_a_secret",
  name = "my-nifty-oauth-client"
)

init_AuthState(
  package = "my_package",
  app = my_client,
  api_key = "api_key_api_key_api_key",
)
#> 
#> ── <AuthState (via gargle)> ──────────────────────────────────────────────
#>     package: my_package
#>         app: my-nifty-oauth-client
#>     api_key: api_key...
#> auth_active: TRUE
#> credentials: <NULL>