google / google/clasp

`clasp run` instructions for authentication could use reworking

Open
#798 3 comments 0 reactions 0 assignees View on GitHub
help wanted
Dominant language
TypeScript
Stars
5.8k
Forks
510
Avg merge
5h 27m
Merged PRs (30d)
1

Description

> (Note: Non-breaking issues are likely not to be prioritized. Please consider a PR in addition to your issue)

## Expected Behavior
When running `clasp run` without the proper scopes we need to set the scopes required. I would expect the instructions to either link to documentation in setting the scopes explicitly.

## Actual Behavior
Currently in the output when scopes are not set correctly we get the following (after running a `clasp helloWorld`:

```
$ clasp run helloWorld
(node:61428) ExperimentalWarning: The fs.promises API is experimental
Running in dev mode.
Hey! It looks like you aren't authenticated for the scopes required by this script.
Please enter the scopes by doing the following:
1. Open Your Script: ...
2. File > Project Properties > Scopes
3. Copy/Paste the list of scopes here:
~ Example ~
https://mail.google.com/
https://www.googleapis.com/auth/presentations
----(When you're done, press 2x)----
```
This led me to going to `File > Project Properties > Scopes` expecting me to set them there but instead we actually need to explicitly set them in the manifest file in `appsscript.json`. As mentioned in the docs [here](https://developers.google.com/apps-script/concepts/scopes).

Screen Shot 2020-07-22 at 5 03 17 PM

## Steps to Reproduce the Problem

1. Run a script function without proper scopes set (any new project) e.g. `clasp helloWorld`

## Specifications

- Node version (`node -v`): v10.13.0
- Version (`clasp -v`): 2.3.0
- OS (Mac/Linux/Windows): Mac

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.