From 84584b6c2977e2620a28b9b1220490a14de7127c Mon Sep 17 00:00:00 2001
From: Dan Dascalescu <ddascalescu+github@gmail.com>
Date: Sat, 4 May 2024 18:14:19 +0300
Subject: [PATCH] [docs] Add clasp run instructions to deploy script as API
 Executable (#1004)

---
 docs/run.md | 30 ++++++++++++++++++++----------
 1 file changed, 20 insertions(+), 10 deletions(-)

diff --git a/docs/run.md b/docs/run.md
index 34c968aa..55c0fcef 100644
--- a/docs/run.md
+++ b/docs/run.md
@@ -4,9 +4,9 @@
 
 ### Prerequisites
 
-To use `clasp run`, you need to complete 4 steps:
+To use `clasp run`, you need to complete 5 steps:
 
-- Set up a **Project ID**.
+- Set up the **Project ID** in your `.clasp.json` if missing.
 - Create an **OAuth Client ID** (Other). Download as `creds.json`.
 - `clasp login --creds creds.json` with this downloaded file.
 - Add the following to `appsscript.json`:
@@ -15,6 +15,7 @@ To use `clasp run`, you need to complete 4 steps:
     "access": "ANYONE"
   }
   ```
+- Deploy your project as an API Executable if necessary
 
 #### Setup Instructions
 
@@ -27,9 +28,10 @@ To use `clasp run`, you need to complete 4 steps:
 1. Set the `projectId` to your Apps Script project
     - Open `https://console.developers.google.com/apis/credentials/consent?project=[PROJECT_ID]`
     - Set `Application name` to `clasp project` and click `save`.
-    - `clasp open`
-    - In the menu, click `Resources > Cloud Platform project...`
-    - Paste `Project number` in `Change Project` and click `Set Project`
+    - Run `clasp open`
+    - In the menu, click `⚙️ Project Settings > Google Cloud Platform (GCP) Project`
+    - If the `Project Number` is missing,
+      - Click `Change Project`, paste the PROJECT_NUMBER, and click `Set project`
 1. Use your own OAuth 2 client. Create one by following these instructions:
     - `clasp open --creds`
     - Press **Create credentials** > **OAuth client ID**
@@ -38,11 +40,11 @@ To use `clasp run`, you need to complete 4 steps:
     - Download the file (⬇), move it to your directory, and name it `creds.json`. Please keep this file secret!
 1. Call `clasp login --creds creds.json`
 1. Add the following to `appsscript.json`:
-  ```json
-  "executionApi": {
-    "access": "ANYONE"
-  }
-  ```
+      ```json
+      "executionApi": {
+        "access": "ANYONE"
+      }
+      ```
 1. If you use Google Workspace, enable `Apps Script API`
     - Open `https://console.cloud.google.com/marketplace/product/google/script.googleapis.com?project=[PROJECT_ID]`
     - Press ENABLE button
@@ -56,6 +58,14 @@ After setup, you can remotely execute Apps Script functions from `clasp`:
 - The result is displayed in the output.
 - You can also run functions directly. i.e. `clasp run helloWorld`.
 
+If you get an "Script API executable not published/deployed." error, deploy your script as an API Executable:
+
+- Run `clasp open`
+- Click `Deploy > New deployment`
+- Select type ⚙ > API Executable
+- Type a `Description`
+- Click `Deploy`
+
 ### Run a function that requires scopes
 
 Many Apps Script functions require special OAuth Scopes (Gmail, Drive, etc.).