From 498c9eda9af6d815771eb75675109cc1f4c5a43d Mon Sep 17 00:00:00 2001 From: MeGaurav4 Date: Mon, 20 Jul 2026 19:45:09 +0530 Subject: [PATCH] docs: document Gmail web link vs API ID mismatch (#858) The API returns hex thread/message IDs, but there is no supported way to convert them into stable Gmail web URLs. Closes #858 --- README.md | 2 ++ skills/gws-gmail/SKILL.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/README.md b/README.md index 04c532d0..c1536850 100644 --- a/README.md +++ b/README.md @@ -332,6 +332,8 @@ gws drive --help # shows +upload … | `modelarmor` | `+sanitize-response` | Sanitize a model response through a Model Armor template | | `modelarmor` | `+create-template` | Create a new Model Armor template | +> **Gmail web links vs API IDs:** The API returns hex thread/message IDs (e.g. `19e1acd465710c93`). There is no supported way to turn these into durable Gmail web URLs. `#all/` is unofficial and unreliable on cold loads. The closest option is `#search/rfc822msgid:`, though it is a search URL, not a direct permalink. For the inverse problem (web URL IDs not accepted by the API), see [#790](https://github.com/googleworkspace/cli/issues/790). + **Examples:** ```bash diff --git a/skills/gws-gmail/SKILL.md b/skills/gws-gmail/SKILL.md index 3423770e..9d41931d 100644 --- a/skills/gws-gmail/SKILL.md +++ b/skills/gws-gmail/SKILL.md @@ -45,6 +45,8 @@ gws gmail [flags] - `settings` — Operations on the 'settings' resource - `threads` — Operations on the 'threads' resource +> **Gmail web links vs API IDs:** The API returns hex thread/message IDs (e.g. `19e1acd465710c93`). There is no supported way to turn these into durable Gmail web URLs. `#all/` is unofficial and unreliable on cold loads. The closest option is `#search/rfc822msgid:`, though it is a search URL, not a direct permalink. For the inverse problem, see [#790](https://github.com/googleworkspace/cli/issues/790). + ## Discovering Commands Before calling any API method, inspect it: