Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ ___
<tr>
<td><b>15 minutes read</b></td>
<td style={{ paddingLeft: '40px' }}><b>Level: Intermediate</b></td>
<td style={{ paddingLeft: '40px' }}><b>Last Updated: December 2025</b></td>
<td style={{ paddingLeft: '40px' }}><b>Last Updated: March 2026</b></td>
</tr>
</table>
</h3>
Expand Down Expand Up @@ -382,6 +382,22 @@ Paste the service account credentials in the provided field, and click on the `S
<img width="1200" alt="Screenshot 2023-05-18 at 11 58 31 PM" src="https://github.com/glific/docs/assets/40158831/bfa12d80-9038-4c2a-919a-ce425bd2ffee"></img>
___

### Google Sheet Access via Service Account

To ensure sensitive beneficiary data (PII) is protected,avoid linking Google Sheets in Anyone can read or Anyone can read/write modes.

Instead, configure access via the Google Service Account linked to your Glific instance.


Open the Google Sheet you want to link.

Click Share → Paste the service account email (from the JSON key) and set the permission to either Viewer (read-only) or Editor (read/write).
Link Sheet in Glific
Now the sheet will be access via the service account, respecting the permissions set.

Comment on lines +385 to +397
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Resolve conflicting access guidance to avoid insecure configuration.

This new section recommends service-account sharing, but earlier instructions still tell users to set Anyone with the link access (Line 45). That contradiction can still lead to broad, unintended data exposure for beneficiary data.

Please make service-account sharing the primary path and explicitly mark link-sharing as discouraged/deprecated where it still appears.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/4`. Product Features/03. Flows/2. Flow Actions/12. Link Google Sheets.md
around lines 385 - 397, Make the Google Sheets access guidance consistently
recommend using the Google Service Account flow (the "Google Sheet Access via
Service Account" section) as the primary and preferred method, and change any
earlier instructions that instruct users to set "Anyone with the link"/"Anyone
can read" sharing to instead mark that link-sharing as discouraged/deprecated
and only for non-PII test data; update the earlier section that mentions "Anyone
with the link" to explicitly warn about data exposure, point readers to the
service-account sharing steps (referencing the "Google Sheet Access via Service
Account" heading), and remove or rephrase any step that instructs granting link
access as a normal configuration.

Comment on lines +387 to +397
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟡 Minor

Tighten wording and convert to clear step-by-step instructions.

There are a few readability issues (protected,avoid, will be access, and standalone “Link Sheet in Glific”). This section should be normalized into numbered steps for consistency with the rest of the doc.

✍️ Suggested rewrite
- To ensure sensitive beneficiary data (PII) is protected,avoid linking Google Sheets in Anyone can read or Anyone can read/write modes. 
+ To protect sensitive beneficiary data (PII), avoid linking Google Sheets using **Anyone with the link** access (read or read/write).

- Instead, configure access via the Google Service Account linked to your Glific instance.
+ Instead, configure access through the Google Service Account linked to your Glific instance.

- Open the Google Sheet you want to link.
-
- Click Share → Paste the service account email (from the JSON key) and set the permission to either Viewer (read-only) or Editor (read/write).
- Link Sheet in Glific
- Now the sheet will be access via the service account, respecting the permissions set.
+ 1. Open the Google Sheet you want to link.
+ 2. Click **Share**, paste the service account email (from the JSON key), and grant:
+    - **Viewer** for read-only access, or
+    - **Editor** for read/write access.
+ 3. Link the sheet in Glific using the same Sheet URL.
+ 4. Access will now be enforced via the service account permissions.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
To ensure sensitive beneficiary data (PII) is protected,avoid linking Google Sheets in Anyone can read or Anyone can read/write modes.
Instead, configure access via the Google Service Account linked to your Glific instance.
Open the Google Sheet you want to link.
Click Share → Paste the service account email (from the JSON key) and set the permission to either Viewer (read-only) or Editor (read/write).
Link Sheet in Glific
Now the sheet will be access via the service account, respecting the permissions set.
To protect sensitive beneficiary data (PII), avoid linking Google Sheets using **Anyone with the link** access (read or read/write).
Instead, configure access through the Google Service Account linked to your Glific instance.
1. Open the Google Sheet you want to link.
2. Click **Share**, paste the service account email (from the JSON key), and grant:
- **Viewer** for read-only access, or
- **Editor** for read/write access.
3. Link the sheet in Glific using the same Sheet URL.
4. Access will now be enforced via the service account permissions.
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/4`. Product Features/03. Flows/2. Flow Actions/12. Link Google Sheets.md
around lines 387 - 397, Rewrite the paragraph into clear numbered steps and fix
typos: replace "To ensure sensitive beneficiary data (PII) is protected,avoid
linking Google Sheets..." with a full sentence and space after the comma; change
"will be access" to "will be accessed"; remove the stray "Link Sheet in Glific"
line and fold that action into the step list; produce 3–4 numbered steps that
instruct the user to open the Google Sheet, click Share and paste the service
account email (from the JSON key) with Viewer or Editor permission, and note
that the sheet will be accessed via the Glific service account respecting those
permissions.


<img width="412" height="484" alt="image" src="https://github.com/user-attachments/assets/e97a9d12-d25e-47fd-87ff-d796701ad59f" />

## Note

- This functionality can be used to write upto 30 columns in google sheets
Expand Down
Loading