Skip to content

docs(gsheets-logger): step-by-step Google Cloud setup + 403 troubleshooting - #7

Merged
rmyndharis merged 1 commit into
mainfrom
gsheets-logger-readme-setup
Jun 23, 2026
Merged

docs(gsheets-logger): step-by-step Google Cloud setup + 403 troubleshooting#7
rmyndharis merged 1 commit into
mainfrom
gsheets-logger-readme-setup

Conversation

@rmyndharis

Copy link
Copy Markdown
Owner

Summary

Documentation only — no code or version change. Makes the gsheets-logger setup hard to get wrong.

The previous Setup section was four terse lines; the "enable the Google Sheets API" requirement was a single clause, so it was easy to miss — and missing it produces a 403 PERMISSION_DENIED (SERVICE_DISABLED) at write time even though install / enable / auth all succeed.

Changes

  • Step-by-step Setup with each Google Cloud action spelled out.
  • "Enable the Google Sheets API" is now its own prominent step: exact console path + direct link, why it's mandatory (off by default), the exact 403 log symptom so users can match it, the ~1–2 min propagation note, and that the plugin auto-retries (no disable/re-enable needed).
  • "Share the sheet with client_email as Editor" called out as the other common 403.
  • A 403 / not-writing troubleshooting table mapping symptom → cause → fix.
  • A security callout on treating the JSON key like a password.
  • Refreshed stale v0.2.1 references to v0.2.2 (the merged version).

catalog:check passes (the generated DETAILS block is untouched).

…ooting

Expand the terse 4-line Setup into numbered steps, emphasizing "Enable the Google
Sheets API" (off by default — the #1 cause of a 403 SERVICE_DISABLED), with the exact
console path, the log symptom, propagation note, and the auto-retry behavior. Add the
"share the sheet with client_email" step prominently (the other common 403) and a
troubleshooting table. Also refresh stale v0.2.1 references to v0.2.2.
@rmyndharis
rmyndharis merged commit fe2d917 into main Jun 23, 2026
1 check passed
@rmyndharis
rmyndharis deleted the gsheets-logger-readme-setup branch June 23, 2026 13:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant