Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

Add admin-directory as a built-in service alias for Admin SDK Directory API

Aperta Adatta ai principianti
  • Qualcosa non va?
#473 1 commento 5 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

  • #476 di @Jah-yee — chiusa senza merge
  • #710 di @nuthalapativarun — chiusa senza merge
  • #807 di @Lubrsy706 — chiusa senza merge

Valutazione

Difficoltà
1/5
Tempo stimato
Meno di un'ora
Idoneità per principianti
82/100
Tipo di issue
Funzionalità
Chiarezza
Specificata chiaramente
Stato di attività
Tranquilla
Stack tecnologico
rust
Ambito
cli

Direzione di ricerca

Inizia in src/services.rs e confronta il admin-reports ServiceEntry esistente con la voce admin-directory proposta. Verifica che l’alias venga risolto in admin:directory_v1 e che i comandi Directory documentati funzionino; il lavoro è completato quando il nuovo alias è disponibile senza modificare gli alias esistenti.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

Summary

The Admin SDK Directory API (admin:directory_v1) is one of the most commonly used Google Workspace APIs for managing users, groups, and organizational units. Currently, accessing it through gws requires using the admin-reports alias with a version override:

gws admin-reports --api-version directory_v1 groups list --params '{"domain":"example.com"}'

This works but is unintuitive — admin-reports implies audit/usage reporting, not user/group management. A built-in admin-directory alias would make the CLI more discoverable and self-documenting.

Proposed Change

Add a new ServiceEntry to src/services.rs:

ServiceEntry {
    aliases: &["admin-directory"],
    api_name: "admin",
    version: "directory_v1",
    description: "Manage users, groups, and organizational units",
},

This would enable:

gws admin-directory groups list --params '{"domain":"example.com"}'
gws admin-directory members list --params '{"groupKey":"[email protected]"}'
gws admin-directory users get --params '{"userKey":"[email protected]"}'

Context

  • The admin-reports alias already maps to admin:reports_v1 — same API name, different version
  • The --api-version directory_v1 workaround works correctly today
  • Adding this alias is backward-compatible (no existing aliases change)
  • The Directory API is core to Workspace administration and used heavily for RBAC, onboarding/offboarding, and compliance workflows
Lingua principale
Rust
Stelle
31.2k
Fork
1.9k
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di googleworkspace/cli

Tutte le issue di googleworkspace/cli

Issue simili

Altre issue su Rust

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.