dropbox team content member list

チームフォルダや共有フォルダのメンバー一覧

セキュリティ

watermint toolboxは認証情報をファイルシステム上に保存します. それは次のパスです:

OS	パス
Windows	`%HOMEPATH%\.toolbox\secrets` (e.g. C:\Users\bob.toolbox\secrets)
macOS	`$HOME/.toolbox/secrets` (e.g. /Users/bob/.toolbox/secrets)
Linux	`$HOME/.toolbox/secrets` (e.g. /home/bob/.toolbox/secrets)

これらの認証情報ファイルはDropboxサポートを含め誰にも共有しないでください. 不必要になった場合にはこれらのファイルを削除しても問題ありません. 認証情報の削除を確実にしたい場合には、アプリケーションアクセス設定または管理コンソールからアプリケーションへの許可を取り消してください.

方法は次のヘルプセンター記事をご参照ください:

Dropbox for teams: https://help.dropbox.com/installs-integrations/third-party/business-api#manage

認可スコープ

説明
Dropbox for teams：Dropboxのファイルやフォルダに関する情報を表示
Dropbox for teams：チームのグループメンバーシップを表示
Dropbox for teams：チームメンバーの確認
Dropbox for teams：Dropboxの共有設定と共同作業者を表示
Dropbox for teams：チームやメンバーのフォルダ構造を表示
Dropbox for teams：チーム内のファイルやフォルダのコンテンツを閲覧・編集できます。
Dropbox for teams：名前、ユーザー数、チーム設定など、チームの基本情報を表示します。

認可

最初の実行では、tbxはあなたのDropboxアカウントへの認可を要求します. リンクをブラウザにペーストしてください. その後、認可を行います. 認可されると、Dropboxは認証コードを表示します. tbxにこの認証コードをペーストしてください.

watermint toolbox xx.x.xxx
==========================

© 2016-2025 Takayuki Okazaki
オープンソースライセンスのもと配布されています. 詳細は`license`コマンドでご覧ください.

1. 次のURLを開き認証ダイアログを開いてください:

https://www.dropbox.com/oauth2/authorize?client_id=xxxxxxxxxxxxxxx&response_type=code&state=xxxxxxxx

2. 'Allow'をクリックします (先にログインしておく必要があります):
3. 認証コードをコピーします:
認証コードを入力してください

インストール

最新リリースからコンパイル済みのバイナリをダウンロードしてください. Windowsをお使いの方は、tbx-xx.x.xxx-win.zipのようなzipファイルをダウンロードしてください. その後、アーカイブを解凍し、デスクトップフォルダに tbx.exe を配置します. watermint toolboxは、システムで許可されていれば、システム内のどのパスからでも実行できます. しかし、説明書のサンプルでは、デスクトップフォルダを使用しています. デスクトップフォルダ以外にバイナリを配置した場合は、パスを読み替えてください.

利用方法

このドキュメントは”デスクトップ”フォルダを例として使用します.

実行

Windows:

cd $HOME\Desktop
.\tbx.exe dropbox team content member list 

macOS, Linux:

$HOME/Desktop/tbx dropbox team content member list

macOS Catalina 10.15以上の場合: macOSは開発者情報を検証します. 現在、tbxはそれに対応していません. 実行時の最初に表示されるダイアログではキャンセルします. 続いて、”システム環境設定”のセキュリティーとプライバシーから一般タブを選択します. 次のようなメッセージが表示されています:

“tbx”は開発元を確認できないため、使用がブロックされました。

“このまま開く”というボタンがあります. リスクを確認の上、開いてください. ２回目の実行ではダイアログに”開く”ボタンがありますので、これを選択します

オプション:

オプション	説明	デフォルト
`-base-path`	ファイルパス標準を選択します。これは、特にDropbox for Teams向けのオプションです。Dropboxの個人版を使用している場合は、選択したものが何であってもほとんど問題ありません。Dropbox for Teamsでは、更新されたチームスペースで`home`を選択すると、ユーザー名付きの個人フォルダが選択されます。これは、個人フォルダ内のファイルを参照したりアップロードしたりする場合に便利です。なぜなら、パスにユーザー名付きのフォルダ名を指定する必要がないからです。一方、`root`を指定すると、アクセス権のあるすべてのフォルダにアクセスできます。ただし、個人フォルダにアクセスする場合には、個人フォルダの名前を含むパスを指定する必要があります。	root
`-folder-name`	フォルダ名によるフィルター. 名前による完全一致でフィルター.
`-folder-name-prefix`	フォルダ名によるフィルター. 名前の前方一致によるフィルター.
`-folder-name-suffix`	フォルダ名によるフィルター. 名前の後方一致によるフィルター.
`-member-type-external`	フォルダメンバーによるフィルター. 外部メンバーのみを残します (同じチームにいないメンバー). 注意: 招待済ユーザーは外部ユーザーとしてマークされます.
`-member-type-internal`	フォルダメンバーによるフィルター. 内部メンバーのみを残します (同じチームのメンバー)注意: 招待済ユーザーは外部ユーザーとしてマークされます.
`-peer`	アカウントの別名	default
`-scan-timeout`	スキャンのタイムアウト設定. スキャンタイムアウトした場合、チームフォルダのサブフォルダのパスは `TEAMFOLDER_NAME/:ERROR-SCAN-TIMEOUT:/SUBFOLDER_NAME` のようなダミーパスに置き換えられます.	short

共通のオプション:

オプション	説明	デフォルト
`-auth-database`	認証データベースへのカスタムパス (デフォルト: $HOME/.toolbox/secrets/secrets.db)
`-auto-open`	成果物フォルダまたはURLを自動で開く	false
`-bandwidth-kb`	コンテンツをアップロードまたはダウンロードする際の帯域幅制限(Kバイト毎秒). 0の場合、制限を行わない	0
`-budget-memory`	メモリの割り当て目標 (メモリ使用量を減らすために幾つかの機能が制限されます)	normal
`-budget-storage`	ストレージの利用目標 (ストレージ利用を減らすためログ、機能を限定します)	normal
`-concurrency`	指定した並列度で並列処理を行います	プロセッサー数
`-debug`	デバッグモードを有効にする	false
`-experiment`	実験的機能を有効化する
`-extra`	追加パラメータファイルのパス
`-lang`	表示言語	auto
`-output`	出力書式 (none/text/markdown/json)	text
`-output-filter`	出力フィルタ・クエリ（jq構文）。レポートの出力はjq構文を使ってフィルタリングされる。このオプションは、レポートがJSONとして出力される場合にのみ適用される。
`-proxy`	HTTP/HTTPS プロクシ (hostname:port). プロキシの設定を省略したい場合は`DIRECT`を指定してください
`-quiet`	エラー以外のメッセージを抑制し、出力をJSONLフォーマットに変更します	false
`-retain-job-data`	ジョブデータ保持ポリシー	default
`-secure`	トークンをファイルに保存しません	false
`-skip-logging`	ローカルストレージへのログ保存をスキップ	false
`-verbose`	現在の操作を詳細に表示します.	false
`-workspace`	ワークスペースへのパス

実行結果

作成されたレポートファイルのパスはコマンド実行時の最後に表示されます. もしコマンドライン出力を失ってしまった場合には次のパスを確認してください. [job-id]は実行の日時となります. このなかの最新のjob-idを各委任してください.

OS	パスのパターン	例
Windows	`%HOMEPATH%\.toolbox\jobs\[job-id]\reports`	C:\Users\bob.toolbox\jobs\20190909-115959.597\reports
macOS	`$HOME/.toolbox/jobs/[job-id]/reports`	/Users/bob/.toolbox/jobs/20190909-115959.597/reports
Linux	`$HOME/.toolbox/jobs/[job-id]/reports`	/home/bob/.toolbox/jobs/20190909-115959.597/reports

レポート: membership

このレポートは共有フォルダまたはチームフォルダと、そのメンバーを一覧できます. フォルダに複数メンバーがいる場合には、メンバーは1行ずつ出力されます. このコマンドはレポートを3種類の書式で出力します. membership.csv, membership.json, ならびに membership.xlsx.

列	説明
path	パス
folder_type	フォルダの種別. (`team_folder`: チームフォルダまたはチームフォルダ以下のフォルダ, `shared_folder`: 共有フォルダ)
owner_team_name	このフォルダを所有するチームの名前
access_type	このフォルダに対するユーザーのアクセスレベル
member_type	メンバーの種類 (user, group または invitee)
member_name	このメンバーの名前
member_email	このメンバーのメールアドレス
same_team	メンバーが同じチームかどうか. もしメンバーが同じチームかどうか判定できない場合は空白を返します.

-budget-memory lowオプションを指定した場合、レポートはJSON形式のみで生成されます

レポートが大きなものとなる場合、.xlsxフォーマットのファイルは次のようにいくつかに分割されて出力されます; membership_0000.xlsx, membership_0001.xlsx, membership_0002.xlsx, …

レポート: no_member

このレポートはメンバーのいないフォルダの一覧を出力します. このコマンドはレポートを3種類の書式で出力します. no_member.csv, no_member.json, ならびに no_member.xlsx.

列	説明
owner_team_name	このフォルダを所有するチームの名前
path	パス
folder_type	フォルダの種別. (`team_folder`: チームフォルダまたはチームフォルダ以下のフォルダ, `shared_folder`: 共有フォルダ)