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 परीक्षण खाता लें जिसमें संवेदनशील सामग्री न हो, और ऐसा Cloud प्रोजेक्ट लें जहाँ आपको OAuth कॉन्फ़िगर करने का अधिकार हो। प्रशासक से पूछें कि चारों 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 का वर्तमान संदर्भ। यह नहीं दिखाता कि पाठक के किसी विशेष सत्र में कोई खास नियम मौजूद है।