There is a package-wide option that controls gargle’s verbosity:
gargle_quiet. The function
gargle_quiet() reveals the current value:
It defaults to
TRUE, i.e. gargle defaults to being very quiet. This is because gargle is designed to try a bunch of auth methods (many of which will fail) and persist doggedly until one succeeds. If none succeeds, gargle tries to guide the user through auth or, in a non-interactive session, it throws an error.
If you need to see all those gory details, toggle the
gargle_quiet option to
FALSE and you’ll get much more output as gargle works through various auth approaches.
gargle_oauth_sitrep() provides an OAuth2 “situation report”.
gargle_oauth_sitrep() is only relevant to OAuth2 user tokens. If you are using (or struggling to use) a service account token, Application Default Credentials, or credentials from the GCE metadata service,
gargle_oauth_sitrep() isn’t going to help you figure out what’s going on.
Here is indicative output of
gargle_oauth_sitrep(), for someone who has accepted the default OAuth cache location and has played with several APIs via gargle-using packages.
gargle_oauth_sitrep() #' gargle OAuth cache path: #' /Users/janedoe/.R/gargle/gargle-oauth #' #' 14 tokens found #' #' email app scope hash... #' ----------------------------- ----------- ------------------------------ ---------- #' email@example.com thingy ...bigquery, ...cloud-platform 128f9cc... #' firstname.lastname@example.org gargle-demo 15acf95... #' email@example.com gargle-demo ...drive 4281945... #' firstname.lastname@example.org gargle-demo ...drive 48e7e76... #' email@example.com tidyverse 69a7353... #' nopqr@ABCDEFG.com tidyverse ...spreadsheets.readonly 86a70b9... #' firstname.lastname@example.org tidyverse ...drive d9443db... #' nopqr@HIJKLMN.com tidyverse ...drive d9443db... #' nopqr@ABCDEFG.com tidyverse ...drive d9443db... #' email@example.com tidyverse ...drive d9443db... #' firstname.lastname@example.org tidyverse ...drive d9443db... #' email@example.com tidyverse ...drive.readonly ecd11fa... #' firstname.lastname@example.org tidyverse ...bigquery, ...cloud-platform ece63f4... #' nopqr@ABCDEFG.com tidyverse ...spreadsheets f178dd8...
It is relatively harmless to delete the folder serving as the OAuth cache. Or, if you have reason to believe one specific cached token is causing you pain, you could delete a specific token (an
.rds file) from the cache. OAuth user tokens are meant to be perishable and replaceable.
If you choose to delete your cache (or a specific token), here is the fallout you can expect:
.Rmdfiles that you execute or render non-interactively, presumably with code such as
PKG_auth(email = "email@example.com"), those won’t run non-interactively until you’ve obtained and cached a token for the package and that identity (email) interactively once.