Google Workspace CLI'yı OpenClaw'a Bağlama

Ashley Innocent

Ashley Innocent

6 March 2026

Google Workspace CLI'yı OpenClaw'a Bağlama

Kurumsal Apidog

Şirket İçi Dağıtım

SSO & RBAC

SOC 2 Uyumlu

Apidog Enterprise'ı Keşfet

KISA ÖZET

Google Workspace CLI (gws), yapay zeka aracılarına Gmail, Drive, Takvim, E-Tablolar, Dokümanlar ve her Google Workspace API'ye yapılandırılmış JSON çıktısı aracılığıyla doğrudan erişim sağlayan bir komut satırı aracıdır. Yerel OpenClaw desteği ve 100'den fazla önceden oluşturulmuş aracı becerisi sayesinde, tüm Workspace iş akışınızı WhatsApp veya Discord gibi mesajlaşma uygulamaları aracılığıyla otomatikleştirebilirsiniz. Kurulum, npm install -g @googleworkspace/cli ardından gws auth setup komutuyla 5 dakika sürer.

Giriş

Yapay zeka aracınızın, siz parmağınızı bile oynatmadan Gmail'inizi okuyabildiğini, Takviminizi güncelleyebildiğini ve Google Drive'ınızı düzenleyebildiğini hayal edin.

Çoğu Google Workspace otomasyon aracı, karmaşık API kurulumları, özel kodlar veya pahalı üçüncü taraf hizmetler gerektirir. Geliştiriciler, OAuth akışları, hız limitleri ve güncel olmayan belgelerle uğraşarak saatlerini harcıyorlar. Bu arada, yapay zeka aracıları, her gün kullandığımız araçlara doğrudan erişimleri olmadığı için boşta oturuyorlar.

Google mühendisleri her şeyi değiştiren bir şey yayınladılar. Google Workspace CLI (gws) şimdiden 12.400'den fazla GitHub yıldızı topladı ve 100'den fazla önceden oluşturulmuş aracı becerisiyle birlikte geliyor. Rust ile geliştirildi, çalışma zamanında Google'ın Keşif Hizmeti'ni (Discovery Service) okur ve herhangi bir yapay zeka aracının ayrıştırabileceği yapılandırılmış JSON çıktısı üretir.

💡
API'ler geliştiren ve test eden geliştiriciler için bu entegrasyon yeni olanaklar sunar. API'lerinizi tasarlamak ve test etmek için Apidog'u kullanırken, gws tüm Google Workspace otomasyonunu (dağıtım bildirimleri göndermekten, test sonuçlarına göre inceleme toplantıları planlamaya kadar) halleder.
button

Google Workspace CLI Nedir?

Google Workspace CLI (gws), her Google Workspace API'sini düzenli, birleştirilebilir komutlara dönüştüren tek bir komut satırı aracıdır. Gmail, Google Drive, Takvim, E-Tablolar, Dokümanlar, Slaytlar, Chat, Görevler, Meet, Formlar, Keep, Classroom, Yönetim ve temelde var olan her Google Workspace API'sini kapsar.

İşte onu kullandığınız diğer CLI araçlarından ayıran özellikler.

Çoğu geliştirici aracı sabit bir komut listesiyle birlikte gelir. Google yeni bir API uç noktası eklediğinde, birilerinin aracı manuel olarak güncellemesi, yeni bir sürüm çıkarması ve herkesin yükseltmesini umması gerekir. Bu, hiç bitmeyen bir bakım döngüsüdür. Gördüğünüz çoğu Google Workspace sarmalayıcısı, siz onları kurduğunuzda zaten güncelliğini yitirmiş durumdadır.

gws bunu temelden farklı bir şekilde çözer. Komutları sabit kodlamak yerine, doğrudan Google'ın Keşif Hizmeti (Discovery Service) ile konuşur. Bunu, Google'ın tüm Workspace uygulamalarında mevcut olan her bir eylemin kendi canlı kataloğu olarak düşünebilirsiniz. Her API, her yöntem, her parametre. Google bu kataloğu kendisi sürdürür ve her zaman günceldir.

gws'yi çalıştırdığınızda, yaptığı ilk şey bu canlı kataloğu çekmek ve şu anda Google'ın mevcut olduğunu söylediği her şeyden tüm komut yapısını anında oluşturmaktır. Google bugün saat 14:00'te yeni bir E-Tablolar özelliği yayınlarsa, CLI'nız saat 14:01'de bunu zaten destekler. Güncelleme yok. Yeni sürüm yok. Bir bakımcının yetişmesini bekleme yok.

Araç, her seferinde doğru kaynaktan okuduğu için kelimenin tam anlamıyla geride kalamaz.

Hızlı Örnek

# Son 10 dosyayı listele
gws drive files list --params '{"pageSize": 10}'

# Bir e-tablo oluştur
gws sheets spreadsheets create --json '{"properties": {"title": "Q1 Bütçesi"}}'

# Bir Sohbet mesajı gönder
gws chat spaces messages create \
  --params '{"parent": "spaces/xyz"}' \
  --json '{"text": "Dağıtım tamamlandı."}'

Her yanıt yapılandırılmış JSON olarak gelir. HTML değil. Biçimlendirilmiş metin değil. Temiz, öngörülebilir, makine tarafından okunabilir veriler, bir yapay zeka aracısının hemen analiz edip üzerinde işlem yapabileceği veriler.

gws Yapay Zeka Aracıları İçin Neden Önemli?

Yapay zeka aracıları topluluğu, belirli teknik nedenlerden dolayı gws hakkında heyecanlı.

Yapılandırılmış JSON Çıktısı: Her bir yanıt yapılandırılmış JSON olarak geri döner. Aracınızın HTML'yi ayrıştırmasına veya biçimlendirmeyi tahmin etmesine gerek yoktur. Hemen kullanabileceği temiz veriler elde eder.

Özel Araç Gerekmez: Çoğu yapay zeka aracı kurulumu, erişmek istediğiniz her API için özel araçlar oluşturmanızı gerektirir. gws ile araçlar zaten oluşturulmuştur. Aracınızın yalnızca kabuk komutlarını nasıl yürüteceğini bilmesi yeterlidir.

100'den Fazla Önceden Oluşturulmuş Aracı Becerisi: Depo, 100'den fazla SKILL.md dosyasıyla birlikte gelir - her desteklenen API için bir tane, ayrıca yaygın iş akışları için üst düzey yardımcılar ve Gmail, Drive, Dokümanlar, Takvim ve E-Tablolar için 50 derlenmiş tarif.

Yerel OpenClaw Desteği: Google, OpenClaw kurulum talimatlarını doğrudan README'ye dahil etti. Bu bir topluluk hack'i veya geçici çözüm değil. Bu, yerleşik, birinci sınıf bir destektir.

Dahili MCP Sunucusu: gws, Google Workspace API'lerini yapılandırılmış araçlar olarak ifşa eden bir Model Bağlam Protokolü (Model Context Protocol - MCP) sunucusu içerir. Herhangi bir MCP uyumlu istemci (Claude Desktop, Gemini CLI, VS Code) bu araçları doğrudan çağırabilir.

Aracı Ekonomisi Altyapısı

Çoğu insanın fark ettiğinden daha hızlı bir şekilde aracı altyapısının ortaya çıktığını görüyoruz. gws gibi araçlar, otonom iş akışlarına güç verecek tesisatları temsil ediyor. Her SaaS platformu için özel entegrasyonlar oluşturmak yerine, aracılar tutarlı çıktı formatlarına sahip standartlaştırılmış CLI'lara güvenebilirler.

Bu önemlidir çünkü giriş engelini düşürür. Workspace'iniz için yapay zeka otomasyonu oluşturmak için bir mühendis ekibine ihtiyacınız yok. npm'e ve 5 dakikaya ihtiyacınız var.

gws Nasıl Çalışır: Mimari

gws, anlaşılması gereken iki aşamalı bir ayrıştırma stratejisi kullanır.

Aşama 1: Hizmet Tanımlama

gws drive files list komutunu çalıştırdığınızda, CLI ilk argümanı (drive) okuyarak hizmeti tanımlar.

Aşama 2: Dinamik Komut Oluşturma

CLI, hizmetin Keşif Belgesini (Discovery Document) Google'dan getirir (24 saat önbelleğe alınır). Belgenin kaynaklarından ve yöntemlerinden bir clap::Command ağacı oluşturur. İşte sihrin gerçekleştiği yer burasıdır - tüm komut yüzeyi, Google'ın kendi API spesifikasyonundan dinamik olarak oluşturulur.

Aşama 3: İstek Yürütme

CLI kalan argümanları yeniden ayrıştırır, yapılandırılmış kimlik bilgilerinizle kimlik doğrulaması yapar, HTTP isteğini oluşturur ve yürütür.

Tüm çıktı - başarı yanıtları, hatalar, indirme meta verileri - yapılandırılmış JSON'dur.

┌─────────────────────────────────────────────────────────┐
│  argv[1] = "drive"                                      │
│       ↓                                                 │
│  Keşif Belgesini Getir (24s önbelleğe alınmış)         │
│       ↓                                                 │
│  Kaynaklar ve yöntemlerden clap::Command ağacı oluştur │
│       ↓                                                 │
│  Kalan argümanları yeniden ayrıştır                    │
│       ↓                                                 │
│  Kimlik Doğrula → HTTP İsteğini Oluştur → Yürüt         │
│       ↓                                                 │
│  Çıktı: Yapılandırılmış JSON                             │
└─────────────────────────────────────────────────────────┘

Bu mimari, gws'nin tek bir komutu sabit kodlamadan her Google Workspace API'sini destekleyebileceği anlamına gelir. Keşif Belgesi (Discovery Document) gerçek kaynaktır ve gws her seferinde onu canlı olarak okur.

OpenClaw Entegrasyonu: Adım Adım

OpenClaw, WhatsApp, Telegram ve Discord gibi mesajlaşma uygulamalarına bağlanan, kendi kendine barındırılan bir yapay zeka aracı çerçevesidir. gws'yi OpenClaw ile entegre ettiğinizde, tüm Google Workspace'inizi metin mesajları aracılığıyla yönetebilen bir yapay zeka asistanı edinirsiniz.

Google, OpenClaw kurulum talimatlarını doğrudan README'ye dahil etti. İşte nasıl başlayacağınız.

Seçenek 1: Tüm Becerileri Sembolik Bağla (Geliştirme için Önerilir)

# Depoyu klonla
git clone https://github.com/googleworkspace/cli.git
cd cli

# Tüm becerileri OpenClaw beceri dizininize sembolik bağla
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/

Bu, her şeyi depoyla senkronize tutar. Google becerileri güncellediğinde, güncellemeleri otomatik olarak alırsınız.

Seçenek 2: Belirli Becerileri Kopyala

# Sadece ihtiyacınız olanları alın
cp -r skills/gws-drive skills/gws-gmail ~/.openclaw/skills/

Seçenek 3: Beceriler CLI'sini Kullanın

# Tüm becerileri bir kerede yükle
npx skills add https://github.com/googleworkspace/cli

# Veya ayrı ayrı becerileri seçin
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-drive
npx skills add https://github.com/googleworkspace/cli/tree/main/skills/gws-gmail

gws-shared Becerisi

gws-shared becerisi özellikle akıllıdır. gws zaten PATH'nizde yoksa, CLI'yi npm aracılığıyla otomatik olarak yükleyen bir kurulum bloğu içerir. OpenClaw aracınız kendini başlatabilir - aracı kontrol eder, gerekirse yükler ve çalışmaya başlar. Manuel kurulum gerekmez.

WhatsApp Aracılığıyla gws Kullanımı

Entegre edildikten sonra, şöyle mesajlar gönderebilirsiniz:

"Takvimimi bugünkü toplantılar için kontrol et"
"Patronumdan gelen okunmamış e-postaları bul"
"Q2 Bütçesi adlı yeni bir e-tablo oluştur"
"Bu PDF'yi Projeler klasörüne yükle"

OpenClaw mesajınızı alır, hangi gws komutunu çalıştıracağına karar verir, onu yürütür ve sonuçları geri gönderir - hepsi WhatsApp aracılığıyla.

100'den Fazla Aracı Becerisi Detaylı İncelemesi

Depo, dört kategoriye ayrılmış 100'den fazla SKILL.md dosyasıyla birlikte gelir. SKILL.md formatına aşina değilseniz, bu, yapay zeka aracılarına yapılandırılmış, birleştirilebilir yetenekler sağlamak için yükselen bir standarttır. Becerileri, uygulamalar gibi, ancak aracı bilgisi ve araç erişimi için düşünün.

Hizmet Becerileri (25+)

Her Google Workspace API'si için bir beceri. Bunlar yapı taşlarınızdır:

Beceri Amaç
gws-drive Dosyaları, klasörleri ve paylaşılan sürücüleri yönetme
gws-gmail E-posta gönderme, okuma ve yönetme
gws-calendar Takvimleri ve etkinlikleri yönetme
gws-sheets E-tabloları okuma ve yazma
gws-docs Google Dokümanları okuma ve yazma
gws-slides Sunumlar
gws-tasks Görev listeleri
gws-chat Google Chat alanları ve mesajları
gws-people Kişiler ve profiller
gws-admin Kullanıcıları, grupları ve cihazları yönetme
gws-classroom Sınıflar, listeler ve ders içeriği
gws-forms Google Formlar
gws-keep Google Keep notları
gws-meet Konferans yönetimi
gws-vault eKeşif
gws-apps-script Apps Script projelerini yönetme

Ek beceriler Cloud Identity, Uyarı Merkezi, Grup Ayarları, Lisanslama, Satıcı ve güvenlik filtrelemesi için Model Armor'u kapsar.

Persona Becerileri (10 Önceden Oluşturulmuş Aracı Rolü)

Google, eksiksiz aracı rollerini tanımlayan 10 kullanıma hazır persona paketi oluşturdu:

Persona Sorumluluklar
Yönetici Asistanı Programları, gelen kutusunu ve iletişimi yönetir
Proje Yöneticisi Projeleri koordine eder, görevleri takip eder, toplantıları planlar
İnsan Kaynakları Koordinatörü İşe alım, duyurular, çalışan iletişimlerini yönetir
Satış Operasyonları Satış iş akışlarını yönetir, anlaşmaları takip eder, aramaları planlar
BT Yöneticisi Kullanıcıları yönetir, güvenliği izler, Workspace'i yapılandırır
İçerik Oluşturucu İçerik oluşturur, düzenler ve dağıtır
Müşteri Desteği Destek taleplerini yönetir, sorunlara yanıt verir, eskalasyonu ele alır
Etkinlik Koordinatörü Etkinlikleri planlar, davetiyeleri yönetir, lojistiği halleder
Ekip Lideri Günlük toplantıları yönetir, görevleri koordine eder, ekip iletişimini yönetir
Araştırmacı Araştırmayı düzenler, referansları yönetir, işbirliğini yürütür

Her persona, o belirli rol için doğru hizmet becerilerini, yardımcı komutları ve iş akışı modellerini bir araya getirir. Aracınızın hangi Gmail + Takvim + Drive + E-Tablolar beceri kombinasyonuna ihtiyacı olduğunu çözmenize gerek yok. Sadece persona'yı verin ve ne yapacağını bilir.

Yardımcı Beceriler

Bunlar, en yaygın işlemler için kısayol komutlarıdır:

Tarif Becerileri (50 Seçilmiş İş Akışı)

İçine gerçek komutların yerleştirildiği çok adımlı görev dizileri. Örnekler şunları içerir:

Bunlar, saatlerce süren prompt mühendisliğini kurtaran "kopyala-yapıştır ve çalıştır" iş akışlarıdır.

Gerçek Dünya Otomasyon İş Akışları

İşte gws ve OpenClaw ile otomatikleştirebileceğiniz somut örnekler.

Gmail Otomasyonu

# Gelen kutunuzu belirli bir göndericiden gelen okunmamış e-postalar için ara
gws gmail users.messages list \
  --params '{"userId": "me", "q": "from:boss@company.com is:unread"}'

# Belirli bir e-postayı oku
gws gmail users.messages get --params '{"userId": "me", "id": "MSG_ID"}'

# Bir e-posta gönder (yardımcı tüm kodlamayı halleder)
gws gmail +send --to alice@company.com --subject 'Q2 Raporu Hazır' \
  --body 'Merhaba Alice, Q2 raporu incelemeye hazır.'

# Okunmamış gelen kutunuzu sınıflandırın (aracı dostu özet)
gws gmail +triage --max 5 --query 'from:boss'

Takvim Yönetimi

# Bugün takviminizde ne olduğuna bakın
gws calendar +agenda

# Katılımcılarla bir toplantı oluştur
gws calendar +insert --summary 'Haftalık Toplantı' \
  --start '2026-03-10T09:00:00-07:00' \
  --end '2026-03-10T09:30:00-07:00'

# Tüm detaylarıyla yinelenen bir etkinlik oluştur
gws calendar events insert \
  --params '{"calendarId": "primary"}' \
  --json '{
    "summary": "Haftalık Toplantı",
    "start": {"dateTime": "2026-03-10T09:00:00", "timeZone": "America/Vancouver"},
    "end": {"dateTime": "2026-03-10T09:30:00", "timeZone": "America/Vancouver"},
    "recurrence": ["RRULE:FREQ=WEEKLY;BYDAY=MO"],
    "attendees": [{"email": "team@company.com"}]
  }'

# Bir etkinliği yeniden planla ve katılımcıları bilgilendir
gws calendar events patch \
  --params '{"calendarId": "primary", "eventId": "EVENT_ID", "sendUpdates": "all"}' \
  --json '{
    "start": {"dateTime": "2026-03-10T14:00:00", "timeZone": "America/Vancouver"},
    "end": {"dateTime": "2026-03-10T15:00:00", "timeZone": "America/Vancouver"}
  }'

Drive Dosya Yönetimi

# Son 10 dosyanızı listele
gws drive files list --params '{"pageSize": 10}'

# Belirli bir klasöre dosya yükle
gws drive +upload --file ./report.pdf --parent FOLDER_ID

# Yeni bir proje klasörü oluştur
gws drive files create \
  --json '{"name": "Q2 Projesi", "mimeType": "application/vnd.google-apps.folder"}'

# Bir dosya indir
gws drive files get \
  --params '{"fileId": "FILE_ID", "alt": "media"}' -o report.pdf

# Bir Google Dokümanını PDF olarak dışa aktar
gws drive files export \
  --params '{"fileId": "FILE_ID", "mimeType": "application/pdf"}' -o document.pdf

# Bir klasörü bir meslektaşınızla paylaşın
gws drive permissions create \
  --params '{"fileId": "FOLDER_ID"}' \
  --json '{"role": "writer", "type": "user", "emailAddress": "colleague@company.com"}'

E-Tablo İşlemleri

# Belirli bir aralıktan veri oku
gws sheets +read --spreadsheet-id SHEET_ID --range 'Kişiler!A2:C'

# Yeni bir veri satırı ekle
gws sheets +append --spreadsheet-id SHEET_ID --range 'Sayfa1' \
  --values '["2026-03-05", "Pazarlama", "Reklam harcaması", "1500"]'

# Yepyeni bir e-tablo oluştur
gws drive files create \
  --json '{"name": "Gider Takipçisi 2026", "mimeType": "application/vnd.google-apps.spreadsheet"}'

Dokümanlar ve İçerik Oluşturma

# Yeni bir doküman oluştur
gws docs documents create --json '{"title": "Toplantı Notları - Mart 2026"}'

# Mevcut bir dokümana içerik yaz
gws docs +write --document-id DOC_ID \
  --text '## Proje: Q2 Lansmanı\n\n### Hedef\nQ2 sonuna kadar yeni özelliği başlat.'

Chat, Meet, Formlar ve Daha Fazlası

# Google Chat'te bir ekip bildirimi gönder
gws chat +send --space spaces/TEAM_SPACE \
  --text 'Önemli: Güncellenmiş politika için lütfen e-postanızı kontrol edin.'

# Bir Google Meet odası oluştur
gws meet spaces create --json '{"config": {"accessType": "OPEN"}}'

# Bir geri bildirim formu oluştur
gws forms forms create \
  --json '{"info": {"title": "Etkinlik Geri Bildirimi", "documentTitle": "Etkinlik Geri Bildirim Formu"}}'

# Bir sunum oluştur
gws slides presentations create --json '{"title": "Üç Aylık İnceleme Q2"}'

Desenine dikkat edin. Her eylem tek bir satırdır. `+` yardımcı komutları (+send, +upload, +agenda, +triage, +read, +append, +write gibi) normalde 10 satır boilerplate kod gerektirecek tüm dağınık kodlama ve biçimlendirmeyi halleder. Aracınızın RFC 2822 e-posta biçimlendirmesi veya base64 kodlaması hakkında bilgi sahibi olmasına gerek yoktur. Sadece ne yapmak istediğini söyler ve gws gerisini halleder.

Güvenlik ve Model Armor

İşte yeterince dikkat çekmeyen bir şey. Depo, yanıt temizleme için Google Cloud Model Armor ile entegrasyon içerir.

Model Armor Nedir?

Aracınız Gmail veya Drive'dan veri okuduğunda, bu veriler istem enjeksiyonu saldırıları içerebilir. Birisi, aracınızın davranışını manipüle etmek için özel olarak tasarlanmış bir e-posta hazırlayabilir. Model Armor, API yanıtlarını aracınıza ulaşmadan önce tarar ve potansiyel olarak kötü amaçlı içeriği filtreler.

gws gmail users messages get --params '...' \
  --sanitize "projects/P/locations/L/templates/T"

Temizleme Modları

Mod Davranış
warn Şüpheli içeriği işaretler ancak yine de döndürür
block Potansiyel olarak kötü amaçlı içeriği tamamen çıkarır

Bu Neden Önemli?

Cisco'nun yapay zeka güvenlik ekibi, ClawHub'daki 31.000'den fazla becerinin %26'sının güvenlik açıkları içerdiğini buldu. SecurityScorecard, açıkta kalan OpenClaw örneklerinin %63'ünün yanlış yapılandırıldığını bildirdi. Aracı güvenliği teorik bir sorun değil. Şu anda yaşanıyor.

Veri boru hattına yerleşik güvenlik filtrelemesi olması Google'dan akıllı bir hareket.

Güvenlik İçin Ortam Değişkenleri

# Varsayılan Model Armor şablonu
export GOOGLE_WORKSPACE_CLI_SANITIZE_TEMPLATE="projects/P/locations/L/templates/T"

# Temizleme modu (uyar veya engelle)
export GOOGLE_WORKSPACE_CLI_SANITIZE_MODE="block"

gws ve Alternatifler

gws'yi düşünebileceğiniz diğer yaklaşımlarla karşılaştıralım.

gws ve gcloud CLI

Özellik gws gcloud CLI
Kapsam Google Workspace API'leri Tüm Google Cloud hizmetleri
Aracı Becerileri 100+ önceden oluşturulmuş Yok
OpenClaw Desteği Yerel Manuel kurulum
Çıktı Formatı Yapılandırılmış JSON Değişken
Workspace'e Özgü Evet Kısmi

Altyapı yönetimi için gcloud kullanın. Workspace otomasyonu için gws kullanın.

gws ve Google Apps Script

Özellik gws Apps Script
Yürütme Yerel CLI / Yapay Zeka aracıları Bulut tabanlı
Dil Kabuk komutları JavaScript
Yapay Zeka Entegrasyonu Dahili Manuel
Kimlik Doğrulama OAuth / Hizmet Hesabı OAuth
Kullanım Durumu Otomasyon / Aracıla Workspace içi otomasyon

Apps Script, Google Workspace içinde iş akışlarını otomatikleştirmede mükemmeldir. gws, harici araçlara ve yapay zeka aracılarına Workspace erişimi sağlamada mükemmeldir.

gws ve Üçüncü Taraf Araçlar (Zapier, Make)

Özellik gws Zapier/Make
Maliyet Ücretsiz 20-500$/ay
Özelleştirme Tam kontrol Platformla sınırlı
Oran Limitleri Yalnızca Google API limitleri Platform limitleri
Veri Gizliliği Yerel yürütme Üçüncü taraf sunucular
Öğrenme Eğrisi Teknik Düşük kod

Üçüncü taraf araçlar teknik olmayan kullanıcılar için mantıklıdır. gws, geliştiriciler ve yapay zeka aracı kurulumları için mantıklıdır.


Başlangıç Kılavuzu

Bunu denemeye hazır mısınız? İşte çalışan bir kurulum için en hızlı yol.

Ön Koşullar

Adım 1: gws'yi Yükle

npm install -g @googleworkspace/cli

npm paketi, işletim sisteminiz ve mimariniz için önceden oluşturulmuş yerel ikili dosyaları içerir. Rust araç zinciri gerekmez.

Adım 2: Kimlik Doğrulamayı Ayarla

gws auth setup

Bu, sizi Google Cloud proje yapılandırması boyunca yönlendirir. Bir Cloud projesi oluşturur, API'leri etkinleştirir ve sizi oturum açtırır.

gcloud kurulu değilse, OAuth'yi Google Cloud Console üzerinden manuel olarak ayarlayabilirsiniz.

Adım 3: Oturum Aç

gws auth login

Bu, OAuth kapsam seçimi ve oturum açma için bir tarayıcı açar.

Adım 4: Kurulumunuzu Test Edin

gws drive files list --params '{"pageSize": 5}'

Son dosyalarınızla ilgili bir JSON yanıtı görmelisiniz.

Adım 5: OpenClaw ile Entegre Et

# Depoyu klonla
git clone https://github.com/googleworkspace/cli.git
cd cli

# Tüm becerileri sembolik bağla
ln -s $(pwd)/skills/gws-* ~/.openclaw/skills/

Adım 6: Mesajlaşma Aracılığıyla Kullanmaya Başlayın

Yapılandırılmış OpenClaw mesajlaşma platformunuz aracılığıyla bir mesaj gönderin:

"Son 5 Drive dosyamı listele"

OpenClaw uygun gws komutunu yürütecek ve sonuçları geri gönderecektir.

Sık Karşılaşılan Sorunları Giderme

"Erişim engellendi" veya oturum açma sırasında 403 hatası

OAuth uygulamanız test modundadır ve hesabınız test kullanıcısı olarak listelenmemiştir.

Düzeltme: GCP projenizdeki OAuth onay ekranını açın, Test kullanıcılarına gidin, Google hesabınızın e-postasını ekleyin, ardından gws auth login komutunu tekrar deneyin.

"Google bu uygulamayı doğrulamadı"

Uygulamanız test modundayken beklenen bir durumdur. İlerle (Advanced) seçeneğine tıklayın, ardından "Go to (unsafe)" seçeneğine tıklayarak devam edin. Bu, kişisel kullanım için güvenlidir.

Çok fazla kapsam hatası

Doğrulanmamış (test modu) uygulamalar yaklaşık 25 OAuth kapsamıyla sınırlıdır. Önerilen kapsam ön ayarı birçok kapsam içerir ve bu limiti aşar.

Düzeltme: Yalnızca ihtiyacınız olan kapsamları seçin:

gws auth login --scopes drive,gmail,calendar

API etkinleştirilmedi

Gerekli bir Google API'si GCP projeniz için etkinleştirilmemişse, reason accessNotConfigured ile 403 hatası görürsünüz.

gws, API'yi etkinleştirmek için bir bağlantı içeren eyleme geçirilebilir bir ipucu yazdırır. Bağlantıya tıklayın, etkinleştirin, yaklaşık 10 saniye bekleyin, sonra tekrar deneyin.

Sonuç

Google Workspace CLI, yapay zeka aracı ekosistemi için önemli bir şeyi temsil ediyor. Bu sadece başka bir CLI sarmalayıcısı değil. Bu, yapay zeka otomasyonunu npm yüklü herkesin erişimine sunan bir altyapıdır.

Mimari sağlam. Beceri kapsamı etkileyici. Google'ın ilk günden itibaren OpenClaw uyumluluğunu inşa etmesi, aracı ekosisteminin nereye gittiğini düşündüklerini gösteriyor.

OpenClaw, Claude Code veya herhangi bir aracı platformunda geliştirme yapan geliştiriciler için gws, araç setinizde isteyeceğiniz araçlardan biridir. Google Workspace API'lerinin karmaşıklığını yönetir, böylece aracınız önemli olana odaklanabilir - işi yapmak.

Aracı ekonomisi altyapısını alıyor. Ve çoğu insanın fark ettiğinden daha hızlı oluyor.

button

Sıkça Sorulan Sorular

S: gws'yi kullanmak ücretsiz mi?

C: Evet, gws Apache-2.0 lisansı altında açık kaynaktır. Yalnızca ücretsiz kotaları aşarsanız Google API kullanımı için ödeme yaparsınız.

S: Bir Google Workspace hesabına ihtiyacım var mı?

C: Standart bir Google hesabı çoğu özellik için çalışır. Bazı Yönetici API'leri bir Workspace aboneliği gerektirir.

S: gws'yi OpenClaw olmadan kullanabilir miyim?

C: Kesinlikle. gws bağımsız bir CLI aracı olarak çalışır. OpenClaw entegrasyonu, mesajlaşma tabanlı erişim için isteğe bağlıdır.

S: gws'yi nasıl güncellerim?

C: En son sürümü almak için npm update -g @googleworkspace/cli komutunu çalıştırın. CLI, çalışma zamanında Google'ın Keşif Hizmeti'ni okur, bu nedenle her zaman en son API'lere erişimi vardır.

S: Verilerim gws ile güvende mi?

C: gws, kimlik bilgilerini AES-256-GCM kullanarak işletim sisteminizin anahtar zincirindeki anahtarlarla şifrelenmiş olarak depolar. Model Armor entegrasyonu, aracı iş akışları için ek güvenlik sağlar.

S: gws'yi CI/CD işlem hatlarında kullanabilir miyim?

C: Evet. Kimlik bilgilerinizi gws auth export --unmasked > credentials.json ile dışa aktarın ve CI ortamınızda GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE'ı ayarlayın.

S: gws ve Google APIs Explorer arasındaki fark nedir?

C: gws, otomasyon ve yapay zeka aracı entegrasyonu için tasarlanmış bir CLI aracıdır. APIs Explorer web tabanlı bir test aracıdır. gws yapılandırılmış JSON çıktısı verir ve betiklemeyi destekler.

S: gws hizmet hesaplarıyla çalışır mı?

C: Evet. GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE'ı hizmet hesabı JSON anahtar dosyanıza ayarlayın. Etkileşimli oturum açma gerekmez.

S: gws'ye katkıda bulunabilir miyim?

C: Evet, proje GitHub'da açık kaynaktır. Depo yöneticileri tarafından işbirliği yapmayanlardan gelen pull request'lerin geçici olarak devre dışı bırakıldığını unutmayın.

S: gws hangi platformları destekliyor?

C: gws, macOS, Linux ve Windows için önceden oluşturulmuş ikili dosyalarla birlikte gelir. npm paketi, yerel ikili kurulumunu otomatik olarak halleder.

API Tasarım-Öncelikli Yaklaşımı Apidog'da Uygulayın

API'leri oluşturmanın ve kullanmanın daha kolay yolunu keşfedin