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 मध्ये कॉन्फिगर केलेला पुरवठादार हाताळू शकतो; फक्त मंजूर असंवेदनशील चाचणी डेटा वापरा. CLI सांगतो की हे Google चे अधिकृतपणे समर्थित उत्पादन नाही आणि 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 चा वर्तमान संदर्भ. वाचकाच्या एखाद्या सत्रात विशिष्ट नियम आहे हे यातून सिद्ध होत नाही.