Ler e editar Google Docs com gws

O que esta skill faz

A skill acessa a API v1 do Google Docs por meio da CLI gws. Ela permite criar documentos em branco, obter a versão mais recente, anexar texto e aplicar conjuntos de atualizações estruturadas.

Quando usar

• Criar um Google Doc com título definido
• Ler a versão mais recente de um documento
• Anexar texto com o helper +write
• Aplicar várias alterações usando batchUpdate

Como usar

1. Leia gws-shared/SKILL.md para autenticação e segurança
2. Consulte gws docs --help para descobrir recursos
3. Execute gws schema docs.<resource>.<method> antes da chamada
4. Monte --params e --json e execute o método escolhido

O que revisar antes de instalar

• Requer o binário gws e credenciais válidas
• create gera um documento em branco e ignora conteúdo adicional
• Uma solicitação inválida em batchUpdate faz o lote inteiro falhar

SKILL.md

---
name: gws-docs
description: "Read and write Google Docs."
metadata:
  version: 0.22.5
  openclaw:
    category: "productivity"
    requires:
      bins:
        - gws
    cliHelp: "gws docs --help"
---

# docs (v1)

> **PREREQUISITE:** Read `../gws-shared/SKILL.md` for auth, global flags, and security rules. If missing, run `gws generate-skills` to create it.

```bash
gws docs <resource> <method> [flags]
```

## Helper Commands

| Command | Description |
|---------|-------------|
| [`+write`](../gws-docs-write/SKILL.md) | Append text to a document |

## API Resources

### documents

  - `batchUpdate` — Applies one or more updates to the document. Each request is validated before being applied. If any request is not valid, then the entire request will fail and nothing will be applied. Some requests have replies to give you some information about how they are applied. Other requests do not need to return information; these each return an empty reply. The order of replies matches that of the requests.
  - `create` — Creates a blank document using the title given in the request. Other fields in the request, including any provided content, are ignored. Returns the created document.
  - `get` — Gets the latest version of the specified document.

## Discovering Commands

Before calling any API method, inspect it:

```bash
# Browse resources and methods
gws docs --help

# Inspect a method's required params, types, and defaults
gws schema docs.<resource>.<method>
```

Use `gws schema` output to build your `--params` and `--json` flags.