Markdown izdanje

AI-translated from English; not yet reviewed by a fluent editor.

# Povežite Claude Code sa Google Workspace kroz pet provera čitanja

> Dokumentovano podešavanje za proveru naloga za Google Workspace CLI koji koristi Claude Code, OAuth ovlašćenja i zahteva za dozvolu pomoću ograničenog čitanja iz Drive, Sheets, Docs i Gmail.

By BIG CHANGE Editorial

Published: 2026-10-20T09:34:40.461Z
Updated: 2026-10-20T09:34:40.461Z
Canonical: https://bigchange.ai/blog/claude-code-google-workspace-cli-read-checks

![Conceptual charcoal illustration of one person studying abstract command lines on a desktop monitor, with a plain folder, grid sheet, document and sealed envelope on the table.](https://bigchange.ai/api/media/file/gws-claude-read-check-workstation-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

Claude Code može da izvršava komande Google Workspace CLI (`gws`) iz lokalnog komandnog okruženja, koristeći Google nalog prijavljen u `gws`. Ovlašćeni vlasnik naloga može da proveri vezu pomoću po jednog bezazlenog zapisa u Drive, Sheets, Docs i Gmail. Najpre potvrdite nalog i ovlašćenja. Vodič prati dokumentovani interfejs CLI repozitorijuma pregledan 20. oktobra 2026. BIG CHANGE nije instalirao nijedan alat niti pristupio nalogu.

## Velika promena

- **Šta se promenilo:** Trenutni `gws` CLI izlaže metode Google Workspace API-ja kao komande koje Claude Code može da izvrši. Jedan prijavljeni nalog može da omogući pristup različitim poslovnim servisima, u granicama stvarnih ovlašćenja i dozvola agenta za komandno okruženje.
- **Zašto je važno:** Ista veza koja agentu omogućava da pregleda odabrani fajl ili poruku može da dosegne i druge podatke obuhvaćene OAuth opsezima. Vlasnik naloga može da uporedi male, poznate rezultate iz terminala i iz Claude Code pre nego što odluči da poveri više posla.
- **Na šta obratiti pažnju:** Proverite generisane komande instaliranog CLI-ja i stvarno važeća pravila dozvola u sesiji kad god se podešavanje promeni. CLI još nije dostigao verziju 1.0; uzak primer upita ili maska polja ne sužava ovlašćenje na nivou celog naloga.

## Pre povezivanja

Koristite namenski, odobren Google nalog za testiranje bez osetljivog sadržaja i Cloud projekat u kome smete da podesite OAuth. Pitajte administratora da li su dozvoljena četiri API-ja i tražena ovlašćenja. Pripremite postojeći Drive fajl jedinstvenog naziva, tabelu sa poznatim vrednostima u malom opsegu, kratak Google Doc sa običnim tekstom i jednom karticom i bezazlenu Gmail poruku. Za Gmail preuzmite RFC identifikator `Message-ID` iz **Show original**. Ove originale ćete porediti sa CLI rezultatima. Ove provere ništa ne stvaraju i ne šalju.

Instalirajte Claude Code na računar koji kontrolišete. Instalirajte `gws` iz [izdanja repozitorijuma za vaš operativni sistem](https://github.com/googleworkspace/cli/releases) ili, uz Node.js 18 ili noviji, upotrebite dokumentovanu komandu:

```bash
npm install -g @googleworkspace/cli
gws --version
gws --help
gws auth login --help
```

Privatno zabeležite instalirane verzije CLI-ja i Claude Code. CLI je još pre verzije 1.0, a komande gradi iz Google dokumenata za otkrivanje API-ja. Pre izvršavanja primera proverite instaliranu pomoć i šeme metoda navedene ispod.

## 1. Podesite ograničenu OAuth prijavu

U odobrenom Cloud projektu uključite API-je za Drive, Sheets, Docs i Gmail. Podesite OAuth publiku i napravite klijent tipa **Desktop app**. Ako je aplikacija External i u testiranju, dodajte odabrani nalog kao test korisnika. Preuzeti JSON klijenta sačuvajte na dokumentovanoj lokaciji `~/.config/gws/client_secret.json` ili koristite zaseban direktorijum izabran pomoću `GOOGLE_WORKSPACE_CLI_CONFIG_DIR`. Taj direktorijum držite van Claude projekta i dostupnim samo vlasniku naloga.

Pre prijave privatno proverite da li je postavljeno `GOOGLE_WORKSPACE_CLI_TOKEN` ili `GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE`, uključujući kroz fajl `.env`. Ovi izvori imaju prednost nad sačuvanim OAuth akreditivima. Ne ispisujte njihove vrednosti i ne tražite od Claude Code da čita fajlove sa akreditivima. Koristite čisto okruženje i predviđenu konfiguraciju klijenta.

Izričito zatražite ova četiri opsega:

```bash
gws auth login --scopes 'https://www.googleapis.com/auth/drive.metadata.readonly,https://www.googleapis.com/auth/spreadsheets.readonly,https://www.googleapis.com/auth/documents.readonly,https://www.googleapis.com/auth/gmail.readonly'
gws auth status
```

Izbor naloga i davanje saglasnosti obavite lično. Izvorni kod CLI-ja u navedenoj reviziji dodaje i identitetske opsege `openid`, `userinfo.email` i `userinfo.profile`. Privatno uporedite saglasnost i podatke iz `gws auth status` o nalogu, ovlašćenjima i važnosti tokena sa nameravanim; polje statusa koje nedostaje ostaje neprovereno. Zaustavite se ako je nalog pogrešan ili ostaje neočekivano šire ovlašćenje. Biranje servisa pri prijavi filtrira ponuđene opcije; samo po sebi ne podešava ova četiri opsega samo za čitanje.

Opsezi su širi od zahteva iz primera. Pristup Drive metapodacima obuhvata metapodatke dostupnih fajlova; pristup samo za čitanje za Sheets i Docs obuhvata dostupne tabele i dokumente; Gmail ovlašćenje samo za čitanje može da pristupi sadržaju poštanskog sandučeta. Nazivi, ID-jevi, opsezi, upiti i maske polja ograničavaju pojedinačni odgovor, ne ovlašćenje tokena. Alat komandnog okruženja može da pristupi i lokalnim akreditivima, pa ih skrivena putanja ili instrukcija u upitu ne izoluju.

## 2. Izvršite ograničena čitanja direktno

Najpre pregledajte svaki metod pomoću `gws schema drive.files.list` i odgovarajućih naziva šema za ostale metode. Proverite generisanu pomoć `--help` ako se parametar razlikuje u instaliranoj verziji. Sledeće komande koriste jednostruke navodnike iz Bash sintakse; namerno prilagodite navodnike drugom komandnom okruženju. Zamenite samo test identifikatore i naziv. Izvršavajte po jednu komandu i privatno sačuvajte stvarni odgovor ili grešku, bez tokena i osetljivog sadržaja.

Pronađite Drive fajl po nazivu. JSON sekvenca `\u0027` neutrališe posebno značenje apostrofa u Drive izrazu za pretragu uz očuvanje Bash navodnika:

```bash
gws drive files list --params '{"pageSize":5,"q":"trashed = false and name = \u0027GWS connection check\u0027","fields":"files(id,name,mimeType),nextPageToken,incompleteSearch"}'
```

Uporedite ID i naziv sa fajlom u Drive. Nepostojanje podudaranja ili `incompleteSearch` ne dokazuje pristup nameravanom fajlu.

Pročitajte poznate ćelije koristeći stvarni ID tabele i naziv kartice:

```bash
gws sheets spreadsheets values get --params '{"spreadsheetId":"SPREADSHEET_ID","range":"Sheet1!A1:C3","fields":"range,majorDimension,values"}'
```

Uporedite vraćene vrednosti sa tabelom. Google može da izostavi prazne ćelije na kraju, pa pripremite poznate vrednosti koje nisu prazne.

Pročitajte prvu karticu kratkog test dokumenta:

```bash
gws docs documents get --params '{"documentId":"DOCUMENT_ID","includeTabsContent":false,"fields":"documentId,title,body(content(paragraph(elements(textRun(content)))))"}'
```

Proverite ID, naslov i poznati tekst. Ovaj ograničeni odgovor ne proverava druge kartice, komentare ni celu strukturu dokumenta.

Za Gmail pretražite postojeću poruku prema RFC identifikatoru `Message-ID`, a zatim vraćeni Gmail ID upotrebite da zatražite dva zaglavlja:

```bash
gws gmail users messages list --params '{"userId":"me","maxResults":1,"q":"rfc822msgid:MESSAGE_ID_FROM_SHOW_ORIGINAL","fields":"messages(id,threadId),nextPageToken,resultSizeEstimate"}'
gws gmail users messages get --params '{"userId":"me","id":"GMAIL_MESSAGE_ID","format":"metadata","metadataHeaders":["Message-ID","Subject"],"fields":"id,threadId,payload(headers)"}'
```

Uporedite vraćeni `Message-ID` i bezazleni naslov poruke sa originalom. Prvi poziv vraća ID-jeve poruka, ne zaglavlja. Drugi traži metapodatke zaglavlja, ne telo poruke. Prazan prvi odgovor ne omogućava drugu proveru. Uži Gmail OAuth opseg za metapodatke ne dozvoljava upit za pretragu koji se ovde koristi; izričito Gmail ovlašćenje samo za čitanje ga dozvoljava.

## 3. Ponovite kroz Claude Code uz zahteve za dozvolu

Pokrenite Claude Code u projektu koji kontrolišete, uz istu odobrenu konfiguraciju naloga. U `/permissions` pregledajte stvarno važeći režim i pravila komandnog okruženja. Koristite Manual (takođe nazvan `default`) i pravilo **Ask** za stvarni alat komandnog okruženja; rešite šira pravila dozvoljavanja ili zaobilaženja u skladu sa politikom organizacije. Izbegavajte opštu dozvolu za `gws *` ili omotač komandnog okruženja. Kod svakog predloženog izvršavanja pregledajte celu komandu i odobrite samo nameravano ograničeno čitanje.

Običnim jezikom zatražite od Claude Code da predloži pet gornjih komandi za iste test objekte i da ih izvršava jednu po jednu tek posle vaše odluke o dozvoli. Tražite izlaz komande ili greške, bez čitanja akreditiva, proširivanja upita ili upisa. Zatim svaki rezultat uporedite i sa direktnim rezultatom i sa originalnim objektom. Projektne instrukcije mogu da opišu zadatak, ali pristup određuju stvarne dozvole alata i OAuth ovlašćenja.

| Servis | Dokaz završetka kroz oba puta |
| --- | --- |
| Drive | Isti ID i naziv fajla; pretraga je potpuna. |
| Sheets | Očekivana kartica, opseg i poznate vrednosti ćelija. |
| Docs | Očekivani ID, naslov i tekst prve kartice. |
| Gmail | Lista pronalazi test poruku; preuzimanje metapodataka potvrđuje njen `Message-ID` i naslov. |

U privatni obrazac upišite verzije, prijavljeni nalog, stvarna ovlašćenja, ciljne ID-jeve, direktni rezultat, Claude rezultat i greške. Neuspešan zahtev, uspešan prazan odgovor i potvrđen objekat različiti su ishodi. Završite tek kada su sva četiri servisa potvrđena kroz oba puta.

## Ako provera ne uspe

Greška **Access blocked** pri prijavi može da znači da test nalog nedostaje na listi test korisnika OAuth aplikacije. Kod greške API-ja ili opsega potvrdite uključen API, izabrani nalog i stvarna ovlašćenja pre nego što zatražite odobreno ponovno davanje saglasnosti. Kod prazne liste proverite tačan objekat, upit i nalog. Ako se instalirana pomoć razlikuje od primera, koristite važeću šemu metoda pre nastavka. Ako Claude Code predloži komandu koja menja podatke ili širi pristup, odbijte je pri zahtevu za dozvolu i vratite se ograničenom čitanju.

CLI repozitorijum je dostupan bez plaćenog paketa. Nalog ili Workspace plan, Cloud kvote i Claude Code plan ili API potrošnja mogu da nose troškove. Preuzeti sadržaj može da obradi dobavljač podešen u Claude Code, pa koristite samo odobrene test podatke koji nisu osetljivi. CLI navodi da nije zvanično podržan Google proizvod i upozorava na promene pre verzije 1.0. BIG CHANGE nije testirao performanse ili kompatibilnost. Zaustavite se pre svakog upisa, slanja ili promene naloga. [Odvojeni Claude dodatak za Google Workspace](https://bigchange.ai/blog/claude-google-workspace-add-on-edit-open-files) obrađuje uređivanje otvorenih fajlova uz odobrenje drugim putem.

## Sources

- [README za Google Workspace CLI](https://github.com/googleworkspace/cli/blob/a3768d0e82ad83cca2da97724e46bea4ff0e6dbd/README.md) — Zvanični repozitorijum na određenoj reviziji, pregledan 20. oktobra 2026. Potvrđuje instalaciju, ručno OAuth podešavanje, dinamičke komande, prioritet akreditiva, nestabilnost verzije i upozorenje da proizvod nije zvanično podržan. Ne potvrđuje rezultat izvršavanja koje je obavio BIG CHANGE.
- [Kontekst komandi za Google Workspace CLI](https://github.com/googleworkspace/cli/blob/a3768d0e82ad83cca2da97724e46bea4ff0e6dbd/CONTEXT.md) — Zvanična uputstva na određenoj reviziji za ugnježdene metode, --params, pregled šema i ograničen izbor polja; treba proveriti stvarno instaliranu pomoć.
- [Implementacija autentifikacije za Google Workspace CLI](https://github.com/googleworkspace/cli/blob/a3768d0e82ad83cca2da97724e46bea4ff0e6dbd/crates/google-workspace-cli/src/auth_commands.rs) — Fiksirana revizija autentifikacionog koda potvrđuje prilagođene --scopes, odvojeno ponašanje izbora servisa i pridodate identitetske opsege. Pregled koda ne pokazuje stvarno ovlašćenje čitaoca.
- [Vodič za uključivanje Google Workspace API-ja](https://developers.google.com/workspace/guides/enable-apis) — Google uputstva za uključivanje API-ja u Cloud projektu; pristup i dalje određuju pravila projekta i administratora.
- [Referenca za Drive files.list](https://developers.google.com/workspace/drive/api/reference/rest/v3/files/list) — Potvrđuje Drive q, pageSize i polja odgovora koja ograničavaju pretragu metapodataka. Uzak zahtev ne sužava OAuth ovlašćenje.
- [Referenca za Sheets spreadsheets.values.get](https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get) — Potvrđuje čitanje pomoću ID-ja tabele i A1 opsega i oblik odgovora; prazne ćelije na kraju mogu biti izostavljene.
- [Referenca za Docs documents.get](https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/get) — Potvrđuje preuzimanje dokumenta i ograničenje na prvu karticu kada je includeTabsContent false. Primer je namenjen test dokumentu sa običnim tekstom i jednom karticom.
- [Reference za Gmail messages.list i messages.get](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/list) — Referenca list potvrđuje pretragu po ID-ju poruke i rezultate koji sadrže samo ID-jeve; q nije dostupan uz gmail.metadata. Povezana get referenca je https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/get i potvrđuje metadataHeaders u formatu METADATA.
- [Dozvole za Claude Code](https://code.claude.com/docs/en/permissions) — Važeća Anthropic referenca za režim Manual/default, pravila Ask, stvarne dozvole alata i zahteve za odobrenje komandnog okruženja. Ne potvrđuje da određena sesija čitaoca ima određeno pravilo.