チーム

チームを使うと、複数の開発者が一連のアプリケーションを共同所有できます。Discord と同等で、同じ 4 つのロール、同じ片方向の移譲モデルに加え、開発中アプリの公開／非公開ゲートを回避できるアプリテスター一覧があります。

ロール

ロール	アプリを編集できる	チームを管理できる	アプリを削除できる
オーナー	はい	はい（所有権の移譲を含む）	はい
管理者	はい	はい（メンバー、テスター）	いいえ
開発者	はい	いいえ	いいえ
閲覧のみ	いいえ	いいえ	いいえ

アプリに対する実効ロールはチームでのロールです。ただし、リクエストした本人が個人としての所有者（移譲元）でもある場合は、オーナー相当のアクセスが適用されます。

招待

管理者以上が、既存の GameVox ユーザーにメールで招待を送ります。
招待された人はポータルのホームで保留中の招待を見て、承諾か辞退を選びます。
招待は承諾されるまでいつでも取り消せます。
再送するには、いったん取り消してから招待し直してください。（専用の「再送」ボタンはありません。）

アプリケーションの移譲

個人のアプリは、あなたがオーナーまたは管理者であるチームに移譲できます。移譲ダイアログでは確認のためアプリ名の入力が必要です。移譲後は次のようになります。

アプリのレコードはチームの所有になります。owner_user_id はクリアされ、owner_team_id が設定されます。
既存のトークン（ボットトークン、クライアントシークレット、Webhook トークン）はすべて有効なままです。移譲でローテーションはされません。
アプリアイコンとカバーの保存先の接頭辞は変わらないため、再アップロードなしでそのまま使えます。
移譲は片方向です（Discord と同じ）。「戻す」には、新しく個人アプリを作成してデータを手動で移行してください。

チームアイコン

チームの「一般」タブからアップロードします。アプリアイコンと同じ画像アップロードのウィジェットで、S3 の接頭辞だけが別です（team-icons/{team_id}/）。チーム一覧、チーム詳細のヘッダー、そのチームが所有するアプリのカードの小さなオーバーレイに表示されます。

アプリテスター

テスター一覧はチームごとではなくアプリケーションごとなので、チームの各アプリがそれぞれの一覧を持ちます。テスターは通常の OAuth インストール URL で非公開アプリ（公開トグルがオフ）をインストールできます。一覧にいない人には「見つかりません」のページが表示されます。

1 アプリケーションにつきテスター 100 人まで。
招待は GameVox のユーザー ID かメールアドレスで行います。自分自身を招待した場合は自動的に承諾されます（すでに信頼された相手のためです）。
テスターにアプリケーションのポータルページへのアクセス権は付きません。付与されるのはインストールの許可だけです。
テスターを外しても、そのテスターが OAuth ですでに取得したトークンは失効しません。必要に応じて別途失効させてください。

エンドポイント（ポータル）

GET    /developer-portal/teams
POST   /developer-portal/teams
GET    /developer-portal/teams/{id}
PATCH  /developer-portal/teams/{id}
DELETE /developer-portal/teams/{id}

GET    /developer-portal/teams/{id}/members
POST   /developer-portal/teams/{id}/members        {email, role}
PATCH  /developer-portal/teams/{id}/members/{user_id}  {role}
DELETE /developer-portal/teams/{id}/members/{user_id}

POST   /developer-portal/applications/{id}/transfer  {team_id, app_name}

GET    /developer-portal/applications/{id}/testers
POST   /developer-portal/applications/{id}/testers   {email|user_id}
DELETE /developer-portal/applications/{id}/testers/{user_id}

← ドキュメントに戻る