Markdown సంచిక

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

# ఐదు చదవడం తనిఖీలతో Claude Codeను Google Workspaceకు కలపండి

> Drive, Sheets, Docs, Gmail నుంచి పరిమిత డేటా చదివి Claude Code ఉపయోగించే Google Workspace CLI ఖాతా, OAuth అనుమతులు, అనుమతి కోరే సందేశాలను తనిఖీ చేసే పత్రాల ఆధారిత పద్ధతి.

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, Google Workspace CLI (`gws`) కమాండ్లను స్థానిక షెల్ నుంచి నడపగలదు. ఇది `gws`లో ధృవీకరించిన Google ఖాతాను ఉపయోగిస్తుంది. అధికారం ఉన్న ఖాతా యజమాని Drive, Sheets, Docs, Gmailలో ఒక్కో హానిరహిత రికార్డుతో కనెక్షన్‌ను తనిఖీ చేయవచ్చు. ముందుగా ఖాతా, మంజూరైన అనుమతులను నిర్ధారించండి. ఈ మార్గదర్శిని 20 అక్టోబర్ 2026న పరిశీలించిన CLI రిపోజిటరీ పత్రాల్లోని ఇంటర్‌ఫేస్‌ను అనుసరిస్తుంది. BIG CHANGE ఏ సాధనాన్నీ ఇన్‌స్టాల్ చేయలేదు, ఏ ఖాతాన్నీ తెరవలేదు.

## పెద్ద మార్పు

- **మారింది ఏమిటి:** ప్రస్తుత `gws` CLI, Google Workspace API పద్ధతులను Claude Code నడపగల షెల్ కమాండ్లుగా అందిస్తుంది. ఒక ధృవీకరించిన ఖాతాతో అనేక పని సేవలకు చేరవచ్చు; అయితే నిజంగా మంజూరైన అనుమతులు, ఏజెంట్ షెల్ అనుమతులు వర్తిస్తాయి.
- **ఇది ఎందుకు ముఖ్యం:** ఎంచుకున్న ఫైల్ లేదా సందేశాన్ని చూడగల కనెక్షన్ OAuth పరిధిలోని ఇతర డేటాకూ చేరవచ్చు. మరింత పని అప్పగించే ముందు ఖాతా యజమాని టెర్మినల్, Claude Codeలో వచ్చిన చిన్న, ముందే తెలిసిన ఫలితాలను పోల్చవచ్చు.
- **గమనించాల్సినవి:** సెటప్ మారినప్పుడల్లా ఇన్‌స్టాల్ చేసిన CLI రూపొందించిన కమాండ్లు, సెషన్‌లో నిజంగా అమలయ్యే అనుమతి నియమాలను చూడండి. CLI ఇంకా 1.0కు ముందు సంస్కరణలో ఉంది; చిన్న ఉదాహరణ క్వెరీ లేదా ఫీల్డ్ మాస్క్ మొత్తం ఖాతాకు ఇచ్చిన అనుమతిని తగ్గించదు.

## కలపడానికి ముందు

సున్నితమైన విషయం లేని ప్రత్యేక, ఆమోదించిన Google పరీక్ష ఖాతా, OAuthను అమర్చే అధికారం ఉన్న Cloud ప్రాజెక్ట్ ఉపయోగించండి. నాలుగు APIలు, కోరే అనుమతులు అనుమతించబడతాయో నిర్వాహకుడిని అడగండి. ప్రత్యేక పేరు గల ఇప్పటికే ఉన్న Drive ఫైల్, చిన్న సెల్ పరిధిలో తెలిసిన విలువల స్ప్రెడ్‌షీట్, ఒక్క ట్యాబ్ ఉన్న చిన్న సాధారణ పాఠ్య Google Doc, హానిరహిత Gmail సందేశం సిద్ధం చేసుకోండి. Gmail కోసం దాని RFC `Message-ID` ను **Show original** నుంచి తీసుకోండి. ఈ అసలు అంశాలను CLI ఫలితాలతో పోలుస్తారు. ఈ తనిఖీలు దేనినీ సృష్టించవు, పంపవు.

మీ నియంత్రణలోని కంప్యూటర్‌లో Claude Code ఇన్‌స్టాల్ చేయండి. `gws` ను [మీ OS కోసం రిపోజిటరీ విడుదల](https://github.com/googleworkspace/cli/releases) నుంచి ఇన్‌స్టాల్ చేయండి లేదా Node.js 18 లేదా తరువాతి సంస్కరణ ఉంటే పత్రాల్లోని కమాండ్ వాడండి:

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

ఇన్‌స్టాల్ చేసిన CLI, Claude Code సంస్కరణలను వ్యక్తిగతంగా నమోదు చేయండి. CLI ఇంకా 1.0కు ముందు దశలో ఉంది; దాని కమాండ్లు Google API అన్వేషణ పత్రాల నుంచి తయారవుతాయి. ఉదాహరణలు నడిపే ముందు ఇన్‌స్టాల్ చేసిన సహాయం, కింది పద్ధతుల స్కీమాలను చూడండి.

## 1. పరిమిత OAuth లాగిన్ అమర్చండి

ఆమోదించిన Cloud ప్రాజెక్ట్‌లో Drive, Sheets, Docs, Gmail APIలను ప్రారంభించండి. OAuth వినియోగదారుల వర్గాన్ని అమర్చి **Desktop app** క్లయింట్‌ను సృష్టించండి. యాప్ Externalగా ఉండి పరీక్షలో ఉంటే ఎంచుకున్న ఖాతాను పరీక్ష వినియోగదారుగా చేర్చండి. డౌన్‌లోడ్ చేసిన క్లయింట్ JSONను పత్రాల్లో తెలిపిన `~/.config/gws/client_secret.json` స్థానంలో ఉంచండి లేదా `GOOGLE_WORKSPACE_CLI_CONFIG_DIR`తో ఎంచుకున్న వేరే డైరెక్టరీని వాడండి. ఆ డైరెక్టరీని Claude ప్రాజెక్ట్ బయట ఉంచి ఖాతా యజమానికి మాత్రమే అందుబాటులో ఉంచండి.

లాగిన్‌కు ముందు `GOOGLE_WORKSPACE_CLI_TOKEN` లేదా `GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE` సెట్ అయిందో వ్యక్తిగతంగా చూడండి; `.env` ఫైల్ ద్వారా అమర్చినది కూడా చూడాలి. నిల్వ చేసిన OAuth ఆధారాలకంటే ఈ మూలాలకు ప్రాధాన్యం ఉంటుంది. విలువలను చూపవద్దు, ఆధారాల ఫైళ్లను చదవమని Claude Codeను అడగవద్దు. శుభ్రమైన వాతావరణం, ఉద్దేశించిన క్లయింట్ అమరికను వాడండి.

ఈ నాలుగు పరిధులను స్పష్టంగా కోరండి:

```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
```

ఖాతా ఎంపిక, సమ్మతి మీరే పూర్తి చేయండి. నిర్దిష్ట సంస్కరణ CLI మూలంలో `openid`, `userinfo.email` మరియు `userinfo.profile` గుర్తింపు పరిధులూ చేరుతాయి. సమ్మతి, `gws auth status` లోని ఖాతా, అనుమతులు, టోకెన్ చెల్లుబాటును మీ ఉద్దేశంతో వ్యక్తిగతంగా పోల్చండి; లేని స్థితి ఫీల్డ్ ధృవీకరించనిదిగానే ఉంటుంది. ఖాతా తప్పైనా, అనుకోని విస్తృత అనుమతి మిగిలినా ఆపండి. లాగిన్ ఎంపికలో సేవలను ఎంచుకోవడం ఎంపికలను మాత్రమే వడపోస్తుంది; ఈ నాలుగు చదవడానికి మాత్రమే ఉన్న పరిధులను అది అమర్చదు.

పరిధులు ఉదాహరణ అభ్యర్థనలకంటే విస్తృతమైనవి. Drive మెటాడేటా అనుమతి అందుబాటులోని ఫైళ్ల మెటాడేటాకు చేరుతుంది; Sheets, Docs చదవడానికి మాత్రమే ఇచ్చిన అనుమతి అందుబాటులోని స్ప్రెడ్‌షీట్లు, పత్రాలను కవర్ చేస్తుంది; Gmail చదవడానికి మాత్రమే ఇచ్చిన అనుమతితో మెయిల్‌బాక్స్ విషయాన్ని చదవవచ్చు. పేర్లు, IDలు, సెల్ పరిధులు, క్వెరీలు, ఫీల్డ్ మాస్క్‌లు ప్రతి సమాధానాన్ని పరిమితం చేస్తాయి, టోకెన్ అధికారాన్ని కాదు. షెల్ సాధనం స్థానిక ఆధారాలనూ చదవగలదు; దాచిన ఫైల్ పథం లేదా ప్రాంప్ట్ సూచన వాటిని వేరుచేయదు.

## 2. పరిమిత చదవడం నేరుగా నడపండి

ముందుగా ప్రతి పద్ధతిని `gws schema drive.files.list` తో పరిశీలించి, ఇతర పద్ధతులకు సంబంధిత స్కీమా పేర్లు వాడండి. రూపొందిన `--help` సహాయం చూడండి. కింది కమాండ్లు Bash సింగిల్-కోట్ పద్ధతిని వాడతాయి; మరో షెల్‌కు కోట్‌లను ఉద్దేశపూర్వకంగా మార్చండి. పరీక్ష గుర్తింపులు, పేరు మాత్రమే మార్చండి. ఒకసారి ఒక కమాండ్ నడిపి నిజమైన సమాధానం లేదా లోపాన్ని టోకెన్లు, సున్నిత విషయం లేకుండా వ్యక్తిగతంగా ఉంచండి.

పేరుతో Drive ఫైల్‌ను కనుగొనండి. JSONలోని `\u0027` Drive శోధన వ్యక్తీకరణలో అపోస్ట్రఫీలను ఎస్కేప్ చేస్తూ Bash కోట్‌లను కాపాడుతుంది:

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

తిరిగొచ్చిన ID, పేరును Drive ఫైల్‌తో పోల్చండి. సరిపోలిక లేకపోవడం లేదా `incompleteSearch` ఉద్దేశించిన ఫైల్‌కు ప్రవేశాన్ని నిరూపించదు.

నిజమైన స్ప్రెడ్‌షీట్ ID, ట్యాబ్ పేరుతో తెలిసిన సెల్‌లను చదవండి:

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

తిరిగొచ్చిన విలువలను స్ప్రెడ్‌షీట్‌తో పోల్చండి. Google చివరి ఖాళీ సెల్‌లను వదిలేయవచ్చు; అందుకే తెలిసిన ఖాళీ కాని విలువలు సిద్ధం చేయండి.

చిన్న పరీక్ష Docలో మొదటి ట్యాబ్ చదవండి:

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

ID, శీర్షిక, తెలిసిన పాఠ్యాన్ని సరిపోల్చండి. ఈ పరిమిత సమాధానం ఇతర ట్యాబ్‌లు, వ్యాఖ్యలు లేదా పూర్తి పత్ర నిర్మాణాన్ని తనిఖీ చేయదు.

Gmailలో ఇప్పటికే ఉన్న సందేశపు RFC `Message-ID`తో వెతికి, తిరిగొచ్చిన Gmail IDతో రెండు హెడర్‌లను కోరండి:

```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)"}'
```

తిరిగొచ్చిన `Message-ID` మరియు హానిరహిత విషయాన్ని అసలు సందేశంతో పోల్చండి. మొదటి కాల్ సందేశ IDలను ఇస్తుంది, హెడర్‌లను కాదు. రెండవది హెడర్ మెటాడేటాను కోరుతుంది, సందేశం ప్రధాన భాగాన్ని కాదు. మొదటి సమాధానం ఖాళీ అయితే రెండో తనిఖీ సాధ్యం కాదు. Gmail యొక్క సన్నని మెటాడేటా OAuth పరిధి ఇక్కడి శోధన క్వెరీని అనుమతించదు; స్పష్టమైన Gmail చదవడానికి మాత్రమే ఇచ్చిన అనుమతి అనుమతిస్తుంది.

## 3. అనుమతి సందేశాలతో Claude Code ద్వారా మళ్లీ చేయండి

అదే ఆమోదించిన ఖాతా అమరికతో మీ నియంత్రణలోని ప్రాజెక్ట్‌లో Claude Code ప్రారంభించండి. `/permissions`లో అమలయ్యే మోడ్, షెల్ నియమాలను చూడండి. Manual (దీనినే `default` అని కూడా అంటారు), నిజమైన షెల్ సాధనానికి **Ask** నియమాన్ని వాడండి; విస్తృత అనుమతి లేదా నియమాలు దాటవేసే అమరికను సంస్థ విధానానుసారం పరిష్కరించండి. `gws *` లేదా షెల్ ర్యాపర్‌కు మొత్తం ఆమోదం ఇవ్వవద్దు. ప్రతి ప్రతిపాదిత కమాండ్‌ను పూర్తిగా చూసి ఉద్దేశించిన పరిమిత చదవడాన్ని మాత్రమే ఆమోదించండి.

అదే పరీక్ష లక్ష్యాలతో పైనున్న ఐదు కమాండ్లను సూచించి, మీ అనుమతి నిర్ణయం తరువాత మాత్రమే ఒక్కొక్కటి నడపమని Claude Codeకు సాధారణ భాషలో చెప్పండి. ఆధారాలు చదవకుండా, క్వెరీలు విస్తరించకుండా, రాయకుండా అవుట్‌పుట్ లేదా లోపాలను చెప్పమని అడగండి. ప్రతి ఫలితాన్ని నేరుగా వచ్చిన ఫలితంతోనూ అసలు వస్తువుతోనూ పోల్చండి. ప్రాజెక్ట్ సూచనలు పనిని వివరించవచ్చు, కానీ నిజమైన సాధన అనుమతులు, OAuth అధికారాలే ప్రవేశాన్ని నిర్ణయిస్తాయి.

| సేవ | రెండు మార్గాల్లో పూర్తి అయినదానికి ఆధారం |
| --- | --- |
| Drive | అదే ఫైల్ ID, పేరు; శోధన పూర్తి. |
| Sheets | ఆశించిన ట్యాబ్, పరిధి, తెలిసిన సెల్ విలువలు. |
| Docs | ఆశించిన ID, శీర్షిక, మొదటి ట్యాబ్ పాఠ్యం. |
| Gmail | జాబితాలో పరీక్ష సందేశం దొరకాలి; మెటాడేటా చదవడం దాని `Message-ID` మరియు విషయంతో సరిపోవాలి. |

సంస్కరణలు, ధృవీకరించిన ఖాతా, నిజమైన అనుమతులు, లక్ష్య IDలు, నేరుగా వచ్చిన ఫలితం, Claude ఫలితం, లోపాలను వ్యక్తిగత తనిఖీ పత్రంలో నమోదు చేయండి. విఫల అభ్యర్థన, విజయవంతమైన ఖాళీ సమాధానం, ధృవీకరించిన వస్తువు వేర్వేరు ఫలితాలు. నాలుగు సేవలూ రెండు మార్గాల్లో ధృవీకరించినప్పుడే పూర్తి అనుకోండి.

## తనిఖీ విఫలమైతే

లాగిన్‌లో **Access blocked** లోపం వస్తే పరీక్ష ఖాతా OAuth యాప్ పరీక్ష వినియోగదారుల జాబితాలో లేకపోవచ్చు. API లేదా పరిధి లోపమైతే ఆమోదించిన పునఃసమ్మతి కోరే ముందు ప్రారంభించిన API, ఎంచుకున్న ఖాతా, నిజమైన అనుమతులను నిర్ధారించండి. ఖాళీ జాబితాకు ఖచ్చితమైన లక్ష్యం, క్వెరీ, ఖాతా చూడండి. ఇన్‌స్టాల్ సహాయం ఉదాహరణలతో వేరైతే ముందుగా ప్రస్తుత పద్ధతి స్కీమా వాడండి. Claude Code డేటా మార్చే లేదా ప్రవేశం విస్తరించే కమాండ్ సూచిస్తే అనుమతి సందేశంలో తిరస్కరించి పరిమిత చదవడానికి తిరిగి రండి.

CLI రిపోజిటరీకి చెల్లింపు ప్యాకేజీ అవసరం లేదు. ఖాతా లేదా Workspace ప్లాన్, Cloud కోటాలు, Claude Code ప్లాన్ లేదా API వినియోగానికి ఖర్చు ఉండవచ్చు. తెచ్చిన విషయాన్ని Claude Codeలో అమర్చిన ప్రదాత ప్రాసెస్ చేయవచ్చు; ఆమోదించిన అసున్నిత పరీక్ష డేటానే వాడండి. ఇది Google అధికారికంగా మద్దతిచ్చే ఉత్పత్తి కాదని CLI చెబుతుంది, 1.0కు ముందు మార్పులపై హెచ్చరిస్తుంది. BIG CHANGE పనితీరు లేదా అనుకూలతను పరీక్షించలేదు. ఏ రాయడం, పంపడం లేదా ఖాతా మార్పు చేయడానికి ముందే ఆపండి. [Claude ప్రత్యేక Google Workspace యాడ్-ఆన్](https://bigchange.ai/blog/claude-google-workspace-add-on-edit-open-files) వేరే మార్గంలో ఆమోదంతో తెరిచిన ఫైళ్ల సవరణను వివరిస్తుంది.

## Sources

- [Google Workspace CLI README](https://github.com/googleworkspace/cli/blob/a3768d0e82ad83cca2da97724e46bea4ff0e6dbd/README.md) — నిర్దిష్ట సవరణలోని అధికారిక రిపోజిటరీ, 20 అక్టోబర్ 2026న చూసినది. ఇన్‌స్టాలేషన్, చేతితో OAuth అమరిక, మారే కమాండ్లు, ఆధారాల ప్రాధాన్యం, సంస్కరణ అస్థిరత, అధికారిక ఉత్పత్తి మద్దతు లేని సూచనను నిర్ధారిస్తుంది. BIG CHANGE అమలు చేసి ఫలితం పొందిందని నిరూపించదు.
- [Google Workspace CLI కమాండ్ సందర్భం](https://github.com/googleworkspace/cli/blob/a3768d0e82ad83cca2da97724e46bea4ff0e6dbd/CONTEXT.md) — నిర్దిష్ట సవరణలోని అధికారిక సూచనలు: నెస్టెడ్ పద్ధతులు, --params, స్కీమా పరిశీలన, పరిమిత ఫీల్డ్ ఎంపిక. నిజంగా ఇన్‌స్టాల్ చేసిన సహాయం చూడాలి.
- [Google Workspace CLI ప్రామాణీకరణ అమలు](https://github.com/googleworkspace/cli/blob/a3768d0e82ad83cca2da97724e46bea4ff0e6dbd/crates/google-workspace-cli/src/auth_commands.rs) — నిర్దిష్ట ప్రామాణీకరణ మూలం కస్టమ్ --scopes, వేరు సేవా ఎంపిక ప్రవర్తన, జతచేసిన గుర్తింపు పరిధులను నిర్ధారిస్తుంది. మూలం చూడడం ద్వారా పాఠకుడి నిజమైన అనుమతి తెలియదు.
- [Google Workspace API ప్రారంభించే మార్గదర్శిని](https://developers.google.com/workspace/guides/enable-apis) — Cloud ప్రాజెక్ట్‌లో API ప్రారంభించడానికి Google సూచనలు; ప్రాజెక్ట్, నిర్వాహక విధానాలు ప్రవేశాన్ని నియంత్రిస్తాయి.
- [Drive files.list సూచన](https://developers.google.com/workspace/drive/api/reference/rest/v3/files/list) — మెటాడేటా శోధనను పరిమితం చేసే Drive q, pageSize, సమాధాన ఫీల్డ్‌లను నిర్ధారిస్తుంది. పరిమిత అభ్యర్థన OAuth అధికారాన్ని తగ్గించదు.
- [Sheets spreadsheets.values.get సూచన](https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get) — స్ప్రెడ్‌షీట్ ID, A1 పరిధితో చదవడం, సమాధాన నిర్మాణాన్ని నిర్ధారిస్తుంది; చివరి ఖాళీ సెల్‌లను వదిలేయవచ్చు.
- [Docs documents.get సూచన](https://developers.google.com/workspace/docs/api/reference/rest/v1/documents/get) — పత్రం చదవడం, includeTabsContent false అయితే మొదటి ట్యాబ్ పరిమితిని నిర్ధారిస్తుంది. ఉదాహరణ ఒక్క ట్యాబ్ ఉన్న సాధారణ పాఠ్య పరీక్ష పత్రం కోసం.
- [Gmail messages.list, messages.get సూచనలు](https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/list) — list సూచన సందేశ IDతో శోధన, IDలు మాత్రమే ఉన్న జాబితా ఫలితాలను నిర్ధారిస్తుంది; gmail.metadataతో q అందుబాటులో లేదు. సంబంధిత get సూచన https://developers.google.com/workspace/gmail/api/reference/rest/v1/users.messages/get; ఇది METADATA ఆకృతిలో metadataHeadersను నిర్ధారిస్తుంది.
- [Claude Code అనుమతులు](https://code.claude.com/docs/en/permissions) — Manual/default మోడ్, Ask నియమాలు, నిజమైన సాధన అధికారాలు, షెల్ ఆమోద సందేశాలపై Anthropic ప్రస్తుత సూచన. పాఠకుడి ప్రత్యేక సెషన్‌లో ఒక నియమం ఉందని నిరూపించదు.