Authorize googleAuthR to access your Google user data. You will be directed to a web browser, asked to sign in to your Google account, and to grant googleAuthR access to user data for Google Search Console. These user credentials are cached in a file named .httr-oauth in the current working directory, from where they can be automatically refreshed, as necessary.

gar_auth(token = NULL, new_user = FALSE)

Arguments

token
an actual token object or the path to a valid token stored as an .rds file
new_user
logical, defaults to FALSE. Set to TRUE if you want to wipe the slate clean and re-authenticate with the same or different Google account. This deletes the .httr-oauth file in current working directory.

Value

an OAuth token object, specifically a Token2.0, invisibly

Details

These arguments are controlled via options, which, if undefined at the time googleAuthR is loaded, are defined like so:

key
Set to option googleAuthR.client_id, which defaults to a client ID that ships with the package
secret
Set to option googleAuthR.client_secret, which defaults to a client secret that ships with the package
cache
Set to option googleAuthR.httr_oauth_cache, which defaults to TRUE
scopes
Set to option googleAuthR.scopes.selected, which defaults to demo scopes.

To override these defaults in persistent way, predefine one or more of them with lines like this in a .Rprofile file:

options(googleAuthR.client_id = "FOO",
        googleAuthR.client_secret = "BAR",
        googleAuthR.httr_oauth_cache = FALSE)
See Startup for possible locations for this file and the implications thereof.

More detail is available from https://developers.google.com/identity/protocols/OAuth2. This function executes the "installed application" flow.

See also

Other authentication functions: gar_attach_auto_auth, gar_auth_service, gar_auto_auth, gar_gce_auth, get_google_token, token_exists