アカウントとメンバー

アカウントとメンバー

アカウントとメンバー機能は、アカウントの編成方法と、保護された受信トレイ マネージャーの操作にロールを割り当てる方法を定義します。 これにより、各アカウントを誰が使用できるか、各リクエストに対してどのアカウントがアクティブになるかを直接制御できます。

なぜこれが重要なのか

この機能は、資格情報、タスク、ジョブ、電子メール、ログのアカウント境界を設定します。これにより、アカウントの切り替えとメンバーシップでのロールの割り当てが明示的に維持されるため、チームが親アカウントと子アカウントをまたいで作業するときの間違いが軽減されます。

コアフロー

クライアントは、まずアクセス可能なアカウントをリストし、アクティブなアカウントを選択し、アカウント ビューの切り替えを通じてその選択を保存します。そこから、アカウントとメンバーシップのデータがロードされ、そのアカウントでアカウントまたはメンバーの変更が実行されます。

操作

操作	エンドポイント	目的
アカウントのリスト	GET /api/accounts	アクセス可能なアカウントのリストを取得する
アカウントの検索	POST /api/accounts/search	フィルタによって設定されたアカウントのクエリ
アカウントを取得	GET /api/accounts/:account_id	アカウントの詳細を取得する
アクティブなアカウントを切り替える	POST /api/account-views/switch	アクティブなアカウントの選択を保存
アカウントを作成する	POST /api/accounts	ルートまたは子アカウントを作成する
アカウントを更新する	PATCH /api/accounts/:account_id	アカウントフィールドを変更する
アカウントを削除	DELETE /api/accounts/:account_id	アカウントを削除
メンバーのリスト	GET /api/accounts/:account_id/members	アカウントのメンバーシップを取得する
メンバーを追加	POST /api/accounts/:account_id/members	メンバーシップを作成する
メンバーを更新	PATCH /api/accounts/:account_id/members/:member_id	ロールまたはメンバーシップのメタデータを変更する
メンバーを削除	DELETE /api/accounts/:account_id/members/:member_id	アカウントアクセスを取り消す

主要なデータと状態

{
  account_id: "acc_...",
  parent_account_id: "acc_parent_...", // optional for hierarchy
  membership: {
    user_id: "uid_...",
    role: "owner" | "member" | "viewer"
  }
}

故障モードと制御

発信者のメンバーシップ セット外のアカウントのリクエストは拒否され、メンバーの変更には適切なロールが必要です。アカウントの切り替えは、呼び出し元がアクセスできるアカウントをターゲットにする必要があり、アカウントのライフサイクルの変更は、明示的なアカウント エンドポイントを通じてのみ発生します。

関連

アカウント、メンバーシップ、受信トレイ マネージャー クライアント フロー。