Claude Code ஒரு உள்ளூர் shell வழியாக Google Workspace CLI (gws) கட்டளைகளை இயக்க முடியும். அதற்கு அங்கீகரிக்கப்பட்ட Google கணக்கு பயன்படுத்தப்படுவது gws ஆகும். அனுமதிபெற்ற கணக்கு உரிமையாளர் Drive, Sheets, Docs, Gmail ஆகிய ஒவ்வொன்றிலும் உணர்வுபூர்வத் தகவல் இல்லாத ஒரு பதிவைக் கொண்டு இணைப்பைச் சரிபார்க்கலாம். முதலில் கணக்கையும் வழங்கப்பட்ட அனுமதிகளையும் உறுதிப்படுத்தவும். 2026 அக்டோபர் 20 அன்று பார்வையிட்ட CLI களஞ்சியத்தின் ஆவணப்படுத்தப்பட்ட இடைமுகத்தை இவ்வழிகாட்டி பின்பற்றுகிறது. BIG CHANGE இவ்விரு கருவிகளையும் நிறுவவில்லை; எந்தக் கணக்கையும் அணுகவில்லை.

பெரிய மாற்றம்

  • என்ன மாறியது: தற்போதைய gws CLI, Google Workspace API முறைகளை Claude Code இயக்கக்கூடிய shell கட்டளைகளாக வழங்குகிறது. ஒரே அங்கீகரிக்கப்பட்ட கணக்கு பல பணிச் சேவைகளை அணுக வழிவகுக்கலாம்; உண்மையில் வழங்கப்பட்ட அனுமதிகளும் agent-இன் shell அனுமதிகளும் அதை நிர்ணயிக்கின்றன.
  • இது ஏன் முக்கியம்: தேர்ந்தெடுத்த கோப்பு அல்லது செய்தியை agent பார்வையிட உதவும் அதே இணைப்பு, அதன் OAuth வரம்புகளுக்குள் வரும் வேறு தரவையும் அணுகலாம். கூடுதல் வேலையை ஒப்படைப்பதற்கு முன், கணக்கு உரிமையாளர் terminal மற்றும் Claude Code வழியாக கிடைக்கும் சிறிய, முன்பே தெரிந்த முடிவுகளை ஒப்பிடலாம்.
  • எதைக் கவனிக்க வேண்டும்: அமைப்பு மாறும்போதெல்லாம் நிறுவப்பட்ட CLI உருவாக்கும் கட்டளைகளையும் அமர்வின் செயல்படும் அனுமதி விதிகளையும் சரிபார்க்கவும். CLI இன்னும் 1.0-க்கு முந்தைய நிலையில் உள்ளது; குறுகிய எடுத்துக்காட்டு வினவலோ field mask-ஓ கணக்கு முழுவதற்குமான அனுமதியைக் குறைக்காது.

இணைப்பதற்கு முன்

உணர்வுபூர்வத் தகவல் இல்லாத, இதற்காக ஒப்புதல் பெற்ற Google சோதனைக் கணக்கையும் OAuth அமைக்க உங்களுக்கு அனுமதியுள்ள Cloud திட்டத்தையும் பயன்படுத்தவும். நான்கு API-களும் கோரப்படும் அனுமதிகளும் அனுமதிக்கப்பட்டுள்ளனவா என்பதை நிர்வாகியிடம் கேட்கவும். தனித்த பெயருள்ள ஏற்கெனவே இருக்கும் Drive கோப்பு, சிறிய பகுதியில் தெரிந்த மதிப்புகளுள்ள spreadsheet, ஒரு tab மட்டுமுள்ள குறுகிய எளிய உரை Google Doc, உணர்வுபூர்வத் தகவல் இல்லாத Gmail செய்தி ஆகியவற்றைத் தயாராக வைத்திருக்கவும். Gmail செய்தியின் RFC Message-ID மதிப்பைப் பெற பயன்படுத்தவும்: Show original. இந்த அசல் பதிவுகளை CLI முடிவுகளுடன் ஒப்பிடுவீர்கள். இச்சரிபார்ப்புகள் எதையும் உருவாக்கவோ அனுப்பவோ செய்யாது.

உங்கள் கட்டுப்பாட்டிலுள்ள கணினியில் Claude Code-ஐ நிறுவவும். நிறுவ வேண்டியது gws; அதைப் பெற களஞ்சியத்தில் உங்கள் OS-க்கான வெளியீட்டைப் பயன்படுத்தவும் அல்லது Node.js 18 அல்லது அதற்கு மேற்பட்ட பதிப்புடன் ஆவணப்படுத்தப்பட்ட இந்தக் கட்டளையைப் பயன்படுத்தவும்:

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

நிறுவிய பதிப்பையும் Claude Code பதிப்பையும் தனிப்பட்ட முறையில் பதிவு செய்யவும். CLI இன்னும் 1.0-க்கு முந்தையது; அதன் கட்டளைகள் Google API discovery ஆவணங்களிலிருந்து உருவாக்கப்படுகின்றன. எடுத்துக்காட்டுகளை இயக்குவதற்கு முன், நிறுவிய பதிப்பின் உதவியையும் கீழுள்ள method schema-களையும் சரிபார்க்கவும்.

1. குறுகிய OAuth உள்நுழைவை அமைக்கவும்

ஒப்புதல் பெற்ற Cloud திட்டத்தில் Drive, Sheets, Docs, Gmail API-களை இயக்கவும். OAuth audience-ஐ அமைத்து, அடுத்து வரும் வகையைச் சேர்ந்த client-ஐ உருவாக்கவும்: Desktop app. செயலி External நிலையில் சோதனையில் இருந்தால், தேர்ந்தெடுத்த கணக்கை test user ஆகச் சேர்க்கவும். பதிவிறக்கிய client JSON-ஐ ஆவணத்தில் கூறிய ~/.config/gws/client_secret.json இடத்தில் சேமிக்கவும் அல்லது தனி அடைவைத் தேர்ந்தெடுக்கப் பயன்படுத்தவும்: GOOGLE_WORKSPACE_CLI_CONFIG_DIR. அந்த அடைவை Claude திட்டத்திற்கு வெளியேயும் கணக்கு உரிமையாளர் மட்டுமே அணுகக்கூடியதாகவும் வைத்திருக்கவும்.

உள்நுழைவதற்கு முன், தனிப்பட்ட முறையில் அமைக்கப்பட்டுள்ளதா எனச் சரிபார்க்க வேண்டியவை GOOGLE_WORKSPACE_CLI_TOKEN அல்லது GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE; இதை அமைக்கக்கூடிய .env கோப்பையும் கவனிக்கவும். சேமிக்கப்பட்ட OAuth credentials-ஐ விட இந்த மூலங்களுக்கு முன்னுரிமை உண்டு. அவற்றின் மதிப்புகளை அச்சிடவோ credential கோப்புகளை வாசிக்குமாறு Claude Code-ஐ கேட்கவோ வேண்டாம். தேவையற்ற அமைப்புகள் இல்லாத environment-ஐயும் உத்தேசித்த client அமைப்பையும் பயன்படுத்தவும்.

இந்த நான்கு scope-களையும் வெளிப்படையாகக் கோரவும்:

Terminal
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

கணக்கைத் தேர்ந்தெடுப்பதையும் consent வழங்குவதையும் நீங்களே முடிக்கவும். குறிப்பிட்ட பதிப்பின் CLI மூலத்தில் சேர்க்கப்படும் அடையாள scope-கள் openid, userinfo.email மற்றும் userinfo.profile ஆகும். consent-ஐயும் அடுத்து வரும் கட்டளையின் தகவலையும் தனிப்பட்ட முறையில் ஒப்பிடவும்: gws auth status கணக்கு, வழங்கப்பட்ட அனுமதிகள், token செல்லுபடியாகும் நிலை ஆகியவை உங்கள் நோக்கத்துடன் பொருந்த வேண்டும்; இல்லாத status field சரிபார்க்கப்படாததாகவே இருக்கும். கணக்கு தவறாக இருந்தாலோ எதிர்பாராத பரந்த அனுமதி மீதமிருந்தாலோ நிறுத்தவும். login பட்டியலில் சேவைகளைத் தேர்ந்தெடுப்பது விருப்பங்களை மட்டும் வடிகட்டுகிறது; இந்த நான்கு read-only scope-களையும் அதுவே அமைப்பதில்லை.

இந்த scope-கள் எடுத்துக்காட்டுக் கோரிக்கைகளைவிடப் பரந்தவை. Drive metadata அனுமதி அணுகக்கூடிய கோப்புகளின் metadata-வை உள்ளடக்கும்; Sheets, Docs read-only அனுமதிகள் அணுகக்கூடிய spreadsheet மற்றும் document-களை உள்ளடக்கும்; Gmail read-only அனுமதி அஞ்சல் பெட்டியின் உள்ளடக்கத்தை அணுகலாம். பெயர்கள், ID-கள், range-கள், query-கள், field mask-கள் ஒவ்வொரு பதிலையும் மட்டுமே கட்டுப்படுத்துகின்றன; token-இன் அதிகாரத்தை அல்ல. shell கருவி உள்ளூர் credentials-ஐயும் அணுகக்கூடும். எனவே மறைக்கப்பட்ட கோப்புப் பாதையோ prompt அறிவுறுத்தலோ அவற்றைத் தனிமைப்படுத்தாது.

2. கட்டுப்படுத்தப்பட்ட வாசிப்புகளை நேரடியாக இயக்கவும்

முதலில் ஒவ்வொரு method-ஐயும் ஆய்வு செய்ய பயன்படுத்தவும்: gws schema drive.files.list மற்றும் மற்ற method-களுக்குரிய schema பெயர்கள். உருவாக்கப்பட்ட உதவியைச் சரிபார்க்கவும்: --help நிறுவிய பதிப்பில் parameter வேறுபட்டால் அதைப் பார்க்கவும். கீழுள்ள கட்டளைகள் Bash single-quote தொடரியலைப் பயன்படுத்துகின்றன; வேறு shell பயன்படுத்தினால் மேற்கோள் அமைப்பை கவனமாக மாற்றவும். சோதனை ID-களையும் பெயரையும் மட்டும் மாற்றவும். ஒரு நேரத்தில் ஒரு கட்டளையை இயக்கி, அதன் உண்மையான பதில் அல்லது பிழையை tokens மற்றும் உணர்வுபூர்வத் தகவல் இல்லாமல் தனிப்பட்ட முறையில் வைத்திருக்கவும்.

பெயரிட்ட Drive கோப்பைத் தேடவும். JSON-இன் \u0027 என்பது Bash மேற்கோள் அமைப்பைப் பாதுகாத்தபடி Drive தேடல் expression-இல் உள்ள apostrophe-களை escape செய்கிறது:

Terminal
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 என்பதோ உத்தேசித்த கோப்பை அணுக முடியும் என்பதற்கான சான்றல்ல.

உண்மையான spreadsheet ID மற்றும் tab பெயருடன் தெரிந்த செல்களை வாசிக்கவும்:

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

கிடைத்த மதிப்புகளை spreadsheet உடன் ஒப்பிடவும். இறுதியில் வரும் காலியான செல்களை Google விடுபடுத்தலாம்; எனவே தெரிந்த, காலியாக இல்லாத மதிப்புகளைத் தயாரிக்கவும்.

குறுகிய சோதனை Doc-இன் முதல் tab-ஐ வாசிக்கவும்:

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

ID, தலைப்பு, தெரிந்த உரை ஆகியவற்றைப் பொருத்தவும். இந்தக் கட்டுப்படுத்தப்பட்ட பதில் மற்ற tab-கள், கருத்துகள் அல்லது முழு document அமைப்பைச் சரிபார்க்காது.

Gmail-இல் ஏற்கெனவே இருக்கும் செய்தியின் RFC மதிப்பால் தேடவும்: Message-ID; பிறகு கிடைத்த Gmail ID-ஐப் பயன்படுத்தி இரண்டு header-களைக் கோரவும்:

Terminal
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 மற்றும் உணர்வுபூர்வத் தகவல் இல்லாத subject-ஐ அசலுடன் ஒப்பிடவும். முதல் அழைப்பு message ID-களை மட்டுமே தரும்; header-களை அல்ல. இரண்டாவது அழைப்பு header metadata-வைக் கோரும்; message body-ஐ அல்ல. முதல் பதில் காலியாக இருந்தால் இரண்டாவது சரிபார்ப்புக்கு அது ஆதாரமல்ல. Gmail-இன் குறுகிய metadata OAuth scope இங்கு பயன்படுத்தும் search query-ஐ அனுமதிக்காது; வெளிப்படையான Gmail read-only அனுமதி அனுமதிக்கும்.

3. அனுமதி கேட்புகளுடன் Claude Code வழியாக மீண்டும் செய்யவும்

அதே ஒப்புதல் பெற்ற கணக்கு அமைப்புடன், உங்கள் கட்டுப்பாட்டிலுள்ள திட்டத்தில் Claude Code-ஐத் தொடங்கவும். அடுத்து வரும் இடத்தில் /permissions செயல்படும் mode மற்றும் shell விதிகளைச் சரிபார்க்கவும். Manual mode-ஐப் பயன்படுத்தவும்; இதற்கு மற்றொரு பெயர் default. மேலும் பயன்படுத்த வேண்டிய விதி Ask ஆகும்; உண்மையில் பயன்படுத்தப்படும் shell கருவிக்கு அதை அமைக்கவும். பரந்த allow அல்லது bypass விதி இருந்தால் நிறுவனக் கொள்கைப்படி தீர்க்கவும். முழுமையான அனுமதியை வழங்க வேண்டாதது gws * அல்லது shell wrapper. முன்வைக்கப்படும் ஒவ்வொரு கட்டளையையும் முழுமையாகப் பார்த்து, நீங்கள் உத்தேசித்த துல்லியமான கட்டுப்படுத்தப்பட்ட வாசிப்பை மட்டுமே அனுமதிக்கவும்.

அதே சோதனை இலக்குகளுடன் மேலுள்ள ஐந்து கட்டளைகளையும் முன்மொழியுமாறும், உங்கள் அனுமதி முடிவுக்குப் பிறகு மட்டுமே ஒவ்வொன்றாக இயக்குமாறும் Claude Code-க்கு எளிய மொழியில் கூறவும். credentials-ஐ வாசிக்காமலும் query-களை விரிவாக்காமலும் எழுதும் செயலை இயக்காமலும் command output அல்லது பிழைகளைத் தெரிவிக்கச் சொல்லவும். பிறகு ஒவ்வொரு முடிவையும் நேரடி முடிவுடனும் அசல் பதிவுடனும் ஒப்பிடவும். திட்ட அறிவுறுத்தல்கள் பணியை விவரிக்கலாம்; அணுகலை உண்மையான tool permissions மற்றும் OAuth grants தீர்மானிக்கின்றன.

சேவை

இரு வழிகளிலும் முடிந்ததற்கான சான்று

Drive

அதே பெயரிட்ட கோப்பின் ID மற்றும் பெயர்; தேடல் முழுமையாக முடிந்திருக்க வேண்டும்.

Sheets

எதிர்பார்த்த tab, range மற்றும் தெரிந்த cell மதிப்புகள்.

Docs

எதிர்பார்த்த ID, தலைப்பு மற்றும் முதல் tab உரை.

Gmail

பட்டியல் சோதனைச் செய்தியைக் கண்டுபிடிக்க வேண்டும்; metadata get பொருத்த வேண்டியது அதன் Message-ID மற்றும் subject.

பதிப்புகள், அங்கீகரிக்கப்பட்ட கணக்கு, உண்மையான grants, இலக்கு ID-கள், நேரடி முடிவு, Claude முடிவு, பிழைகள் ஆகியவற்றை தனிப்பட்ட சரிபார்ப்புப் பதிவில் எழுதவும். தோல்வியுற்ற கோரிக்கை, வெற்றிகரமான காலியான பதில், சரிபார்க்கப்பட்ட பதிவு ஆகியவை வெவ்வேறு முடிவுகள். நான்கு சேவைகளும் இரு வழிகளிலும் சரிபார்க்கப்பட்டால் மட்டுமே முடிக்கவும்.

ஒரு சரிபார்ப்பு தோல்வியுற்றால்

உள்நுழைவில் வரும் Access blocked என்பது OAuth செயலியின் test-user பட்டியலில் சோதனைக் கணக்கு இல்லாததைக் குறிக்கலாம். API அல்லது scope பிழை ஏற்பட்டால், அனுமதிபெற்ற புதிய consent-ஐக் கோருவதற்கு முன் இயக்கப்பட்ட API, தேர்ந்தெடுத்த கணக்கு, உண்மையான grants ஆகியவற்றை உறுதிப்படுத்தவும். காலியான பட்டியல் வந்தால் துல்லியமான இலக்கு, query, கணக்கைச் சரிபார்க்கவும். நிறுவிய உதவி எடுத்துக்காட்டுகளிலிருந்து வேறுபட்டால், தொடர்வதற்கு முன் தற்போதைய method schema-ஐப் பயன்படுத்தவும். மாற்றம் செய்யும் அல்லது பரந்த கட்டளையை Claude Code முன்மொழிந்தால் permission prompt-இல் மறுத்து கட்டுப்படுத்தப்பட்ட வாசிப்புக்குத் திரும்பவும்.

CLI களஞ்சியத்தை கட்டண package இன்றி பெறலாம். கணக்கு அல்லது Workspace திட்டம், Cloud quota-கள், Claude Code திட்டம் அல்லது API பயன்பாட்டிற்கு செலவுகள் இருக்கலாம். மீட்டெடுத்த உள்ளடக்கத்தை Claude Code-இல் அமைக்கப்பட்ட provider செயலாக்கக்கூடும்; எனவே ஒப்புதல் பெற்ற உணர்வுபூர்வத் தகவலற்ற தரவுடன் மட்டும் சோதிக்கவும். அதிகாரப்பூர்வ ஆதரவுள்ள Google தயாரிப்பு அல்ல என்றும் 1.0-க்கு முந்தைய மாற்றங்கள் உண்டு என்றும் CLI தெரிவிக்கிறது. செயல்திறனையோ பொருந்தக்கூடிய தன்மையையோ BIG CHANGE சோதிக்கவில்லை. எழுதுதல், அனுப்புதல் அல்லது கணக்கு மாற்றத்திற்கு முன் நிறுத்தவும். Claude-இன் தனியான Google Workspace add-on வேறு வழியில் அனுமதியுடன் திறந்த கோப்புகளைத் திருத்துவதை விவரிக்கிறது.