gws-admin-reports は何をしますか？
Google Workspace Admin SDK：監査ログと使用状況レポート。
概要
このスキルは、Google Workspace 管理者が Admin SDK を使用して、組織の監査ログや使用状況レポートを取得するためのものです。
主な機能
- 監査ログの取得: 管理者アクティビティ、ログイン、トークン、グループ、SAM などの監査ログを取得します。
- 使用状況レポート: ユーザー、グループ、アプリケーションなどの使用状況に関するレポートを生成します。
- カスタムクエリ: 特定の日付範囲、ユーザー、イベント名などでフィルタリング可能です。
使用方法
# 監査ログの取得例
gws-admin-reports --report-type admin --date 2023-01-01
# 使用状況レポートの取得例
gws-admin-reports --report-type usage --user [email protected]
サポートされるレポートタイプ
| レポートタイプ | 説明 |
|---|---|
admin | 管理者アクティビティの監査ログ |
login | ログインイベントの監査ログ |
token | OAuth トークンアクティビティの監査ログ |
group | Google グループのアクティビティ |
sam | SAML アプリケーションのアクティビティ |
usage | サービスの使用状況レポート |
設定
- 認証: Google Workspace 管理者アカウントを使用し、OAuth 2.0 またはサービスアカウントで認証します。
- スコープ:
https://www.googleapis.com/auth/admin.reports.audit.readonlyおよびhttps://www.googleapis.com/auth/admin.reports.usage.readonlyが必要です。
注意事項
- 管理者権限が必要です。
- API の呼び出し制限に注意してください。
- 取得できるデータは組織の設定に依存します。