ユーザーアカウントを管理する

Last updated on October 2, 2026

注釈：本資料はAI技術を用いて翻訳されています。

Overview

ユーザーアカウントを使用すると、ユーザーはプラットフォームにアクセスできるようになります。対象となるのはプレイヤーだけでなく、Admin Portal へのアクセス権を持つ組織内のすべての担当者も含まれます。このガイドでは、AccelByte Gaming Services (AGS) Admin Portal または AGS CLI でユーザーアカウントを管理する方法を説明します。

Prerequisites

この記事の手順を完了するには、AGS Admin Portal へのアクセス権と、ユーザー管理の権限が必要です。

AGS CLI の手順に従う場合は、AGS CLI をインストールし、同じ権限を持つアカウントでサインインしてください。管理者を招待するには、そのアカウントに ADMIN:USER:INVITE の CREATE 権限も必要です。また、ロールを一覧表示するには ADMIN:ROLE の READ 権限が必要です。詳細については、インストールとサインインを参照してください。例では Bash シェルを使用します。

Search for a user

以下では、管理対象のユーザーを検索する方法を説明します。

AGS Public Cloud (search)

Admin Portal

1. Admin Portal のサイドバーで、Foundations > Users に移動します。

2. ドロップダウンメニューから検索フィルターを選択し、テキストボックスにユーザーの認証情報を入力します。その後、Enter を押して検索します。検索結果が表示されます。

サードパーティプラットフォームの認証情報（例: Steam や Epic Games アカウント）を使用してプレイヤーを検索する場合、2 つの新しいドロップダウンメニューが表示されます。1 つ目のドロップダウンメニューから、プレイヤーが使用しているサードパーティプラットフォームを選択します。2 つ目のドロップダウンメニューでは、Platform User ID を選択できます。

AGS CLI

• メールアドレス、表示名、またはユーザー名で検索するには、<YourNamespace> を自分の名前空間に、<SearchText> を手元にある値（3 文字以上）に置き換えます。

  ags iam users search --namespace <YourNamespace> --query <SearchText>

  1 つの属性のみで検索するには、--by を追加し、emailAddress、displayName、uniqueDisplayName、username のいずれかを指定します。

• サードパーティアカウントで検索するには、<PlatformId> を steam や epicgames などのプラットフォームに、<PlatformUserId> をそのプラットフォーム上のプレイヤーのユーザー ID に置き換えます。

  ags iam users search --namespace <YourNamespace> --by thirdPartyPlatform \
    --platform-id <PlatformId> --query <PlatformUserId>

結果には、各ユーザーの userId と namespace が表示されます。このページの他のタスクでは、これらの値を使用します。

AGS Private Cloud (search)

Admin Portal

1. Admin Portal のサイドバーで、Foundations > Users に移動します。

2. Search User パネルのドロップダウンメニューから、お手元にあるユーザーのアカウント情報に対応する検索フィルターを選択します。

その後、テキストボックスにユーザーの認証情報を入力し、Enter を押して検索します。検索結果が表示されます。

サードパーティプラットフォームの認証情報を使用してプレイヤーを検索する場合、2 つの新しいドロップダウンメニューが表示されます。1 つ目のドロップダウンメニューから、Steam や Epic Games など、プレイヤーが使用しているサードパーティプラットフォームを選択します。2 つ目のドロップダウンメニューでは、お手元の認証情報に応じて Platform Display Name または Platform User ID のいずれかを選択します。

AGS CLI

• メールアドレス、表示名、またはユーザー名で検索するには、<YourNamespace> を自分の名前空間に、<SearchText> を手元にある値（3 文字以上）に置き換えます。

  ags iam users search --namespace <YourNamespace> --query <SearchText>

  1 つの属性のみで検索するには、--by を追加し、emailAddress、displayName、uniqueDisplayName、username のいずれかを指定します。

• サードパーティアカウントで検索するには、<PlatformId> を steam や epicgames などのプラットフォームに、<PlatformUserId> をそのプラットフォーム上のプレイヤーのユーザー ID に置き換えます。

  ags iam users search --namespace <YourNamespace> --by thirdPartyPlatform \
    --platform-id <PlatformId> --query <PlatformUserId>

  プラットフォームの表示名で検索する場合は、--platform-by platformDisplayName を追加し、表示名を --query に指定します。

結果には、各ユーザーの userId と namespace が表示されます。このページの他のタスクでは、これらの値を使用します。

Invite an admin user

以下では、ユーザーを管理者として招待する方法を説明します。

AGS Public Cloud (invite admin)

Admin Portal

1. AGS Admin Portal のスタジオ名前空間で、Admin Tasks > Admin Management に移動し、Invite Admin をクリックします。

2. 表示された Invite Admin フォームに、以下の情報を入力します。

   • Email Address: 管理者アクセスを与えたい各担当者のメールアドレスを入力します。キーボードの Enter または Tab を押すか、各アドレスをカンマで区切ることで、一度に複数のユーザーを招待できます。

   • Choose Roles: 新しい管理者に付与したいロールを選択します。選択できる管理者ロールは 3 種類あります。

     • Studio Admin: 招待者のロールが Game Admin または View Only の場合、Studio Admin ロールを付与することはできません。Studio Admin ロールには、以下の機能があります。

       • スタジオ名前空間と、それに関連するすべてのゲーム名前空間へのフルアクセス
       • スタジオ名前空間と、それに関連するすべてのゲーム名前空間にチームメンバーを招待する機能
       • すべてのユーザーに対してロールを割り当て、取り消す機能

     • Game Admin: Game Admin ロールには、以下の機能があります。

       • 特定のゲーム名前空間へのアクセス
       • 特定のゲーム名前空間にユーザーを招待する機能
       • 割り当てられたゲーム名前空間内のユーザーに対してロールを割り当て、取り消す機能

     • View Only: View Only ロールは、特定のゲーム名前空間を表示するアクセス権を持ちますが、ロール管理機能は一切ありません。

   • Select Namespace: 新しい管理者にアクセスを許可したい各名前空間の横にあるチェックボックスを選択します。

   注記

   招待者が Studio Admin ロールを選択した場合、Studio Admin はスタジオ名前空間に関連するすべてのゲーム名前空間にアクセスできるため、名前空間を選択するフィールドは表示されません。

3. 完了したら Invite をクリックすると、入力したメールアドレスに招待状が送信されます。

AGS CLI

1. 新しい管理者に付与したいロールの ID を確認します。出力で、Studio Admin、Game Admin、View Only などの roleName からロールを探し、その roleId をコピーします。

   ags iam roles list --format json

2. 招待内容を記述した JSON ファイルを作成します。ファイル名は任意です。この例では invite.json を使用します。

   {
     "emailAddresses": ["<EmailAddress>"],
     "roleId": "<RoleId>",
     "assignedNamespaces": ["<GameNamespace>"],
     "namespace": "<YourStudioNamespace>",
     "isAdmin": true,
     "isNewStudio": false
   }

   • emailAddresses: 招待したい各担当者のメールアドレス。
   • roleId: 手順 1 で確認したロール ID。
   • assignedNamespaces: 新しい管理者がアクセスできるゲーム名前空間。Studio Admin ロールの場合は、Studio Admin がスタジオのすべてのゲーム名前空間にアクセスできるため、スタジオ名前空間のみを指定します。
   • namespace: スタジオ名前空間。
   • isAdmin と isNewStudio: これらの値は変更しないでください。Admin Portal も同じ値を送信します。

3. 招待を送信します。@ の後に JSON ファイルのパスを指定します。

   ags iam users invite --json @invite.json

注記

招待メールは、デフォルトで送信後 24 時間のみ有効です。招待された管理者ユーザーがメール受信後 24 時間以内にアカウント登録を完了しない場合、新しい招待を送信する必要があります。

AGS Private Cloud (invite admin)

Admin Portal

ゲームの同僚やコミュニティマネージャーを Admin Portal に素早く招待することもできます。そのためには、以下の手順に従ってください。

1. Admin Portal の目的の名前空間で、Admin Task > Admin Management に移動します。

2. Admins ページで、Invite Admin ボタンをクリックします。Invite Admin フォームが表示されます。

3. 以下の情報でフィールドを入力します。

   • Email Address フィールドに、管理者アクセスを与えたい各担当者のメールアドレスを入力します。キーボードの Enter、Tab、またはカンマを使用して各メールアドレスを区切ることで、一度に複数のユーザーを招待できます。

   • Roles フィールドで、新しい管理者に付与したいロールを選択します。

   • ロールを選択した後に Namespace フィールドが表示されます。このフィールドで、新しい管理者にアクセスを許可したい各名前空間の横にあるチェックボックスを選択します。

   注記

   前の手順でグローバルロールを選択した場合、グローバルロールはすべての名前空間にアクセスできるため、Namespace フィールドは表示されません。

4. 完了したら Invite ボタンをクリックします。入力したメールアドレスに招待状が送信されます。

   注記

   招待メールは、デフォルトで送信後 24 時間のみ有効です。招待された管理者ユーザーがメール受信後 24 時間以内にアカウント登録を完了しない場合、新しい招待を送信する必要があります。

AGS CLI

1. 新しい管理者に付与したいロールの ID を確認します。出力で roleName からロールを探し、その roleId をコピーします。

   ags iam roles list --format json

   isWildcard が true に設定されているロールは、グローバルロールです。

2. 招待内容を記述した JSON ファイルを作成します。ファイル名は任意です。この例では invite.json を使用します。

   {
     "emailAddresses": ["<EmailAddress>"],
     "roleId": "<RoleId>",
     "assignedNamespaces": ["<Namespace>"],
     "isAdmin": true
   }

   • emailAddresses: 招待したい各担当者のメールアドレス。
   • roleId: 手順 1 で確認したロール ID。
   • assignedNamespaces: 新しい管理者がアクセスできる名前空間。グローバルロールはすべての名前空間にアクセスできるため、グローバルロールの場合は ["*"] を指定します。
   • isAdmin: true のままにしてください。Admin Portal も同じ値を送信します。

3. 招待を送信します。@ の後に JSON ファイルのパスを指定します。

   ags iam users invite --json @invite.json

   注記

   招待メールは、デフォルトで送信後 24 時間のみ有効です。招待された管理者ユーザーがメール受信後 24 時間以内にアカウント登録を完了しない場合、新しい招待を送信する必要があります。

Delete assigned admin role

以下では、ユーザーに割り当てられた管理者ロールを削除する方法を説明します。

AGS Public Cloud (delete role)

Admin Portal

1. AGS Admin Portal のスタジオ名前空間で、Admin Tasks > Admin Management に移動します。
2. ドロップダウンメニューから適切な検索フィルターを選択し、テキストボックスにユーザーの認証情報を入力して Enter を押します。目的の検索結果の横にある View をクリックします。
3. 詳細ページで、アカウントから削除したいロールの横にある Delete をクリックします。表示されるポップアップで再度 Delete をクリックして確認します。

AGS CLI

1. ユーザーの userId を確認します。ユーザーを検索する を参照してください。

2. ユーザーのロールを一覧表示します。削除したいロールの roleId と assignedNamespaces をコピーします。

   ags iam users list-roles --namespace <YourNamespace> --user-id <UserId>

3. ロールを削除します。<RoleId> と <Namespace> を、手順 2 で確認したロールの roleId と assignedNamespaces に置き換えます。これにより、そのロールが割り当てられているすべての名前空間からロールが削除されます。

   ags iam users revoke-role --namespace <YourNamespace> --user-id <UserId> \
     --json '{"roleId": "<RoleId>", "assignedNamespaces": ["<Namespace>"]}'

AGS Private Cloud (delete role)

Admin Portal

1. Admin Portal のサイドバーで、Foundations > Users に移動します。
2. ドロップダウンメニューから適切な検索フィルターを選択し、テキストボックスにユーザーの認証情報を入力して Enter を押します。目的の検索結果の横にある View をクリックします。
3. 詳細ページで、アカウントから削除したいロールの横にある Delete をクリックします。表示されるポップアップで再度 Delete をクリックして確認します。

AGS CLI

1. ユーザーの userId を確認します。ユーザーを検索する を参照してください。

2. ユーザーのロールを一覧表示します。削除したいロールの roleId と assignedNamespaces をコピーします。

   ags iam users list-roles --namespace <YourNamespace> --user-id <UserId>

3. ロールを削除します。<RoleId> と <Namespace> を、手順 2 で確認したロールの roleId と assignedNamespaces に置き換えます。これにより、そのロールが割り当てられているすべての名前空間からロールが削除されます。

   ags iam users revoke-role --namespace <YourNamespace> --user-id <UserId> \
     --json '{"roleId": "<RoleId>", "assignedNamespaces": ["<Namespace>"]}'

Change a user's email address

以下の手順に従うことで、自分自身を含む任意のユーザーのメールアドレスを変更できます。

Admin Portal

1. Admin Portal のサイドバーで、Foundations > Users に移動します。

2. Search User パネルのドロップダウンメニューから、お手元にあるプレイヤーのアカウント情報に対応する検索フィルターを選択します。その後、テキストボックスにその情報を入力し、キーボードの Enter を押して検索します。

   注記

   ここでは曖昧検索（ファジー検索）が可能なため、お手元のプレイヤーの認証情報の最初の数文字を入力するだけで、探しているプレイヤーを見つけることができます。

3. 検索結果が表示されます。リストを見て探しているアカウントを見つけ、アカウント一覧の Action 列にある View をクリックして開きます。

4. User Overview が表示され、ユーザーのアカウントデータを一目で確認できます。ユーザーのメールアドレスの下にある Change をクリックして変更します。

5. ユーザーのメールアドレスを変更するには、まず本人確認を行う必要があります。表示される Change User's Email の確認ボックスで、Send Verification Code ボタンをクリックすると、現在 Admin Portal にログインしているメールアドレスに確認コードが送信されます。

6. Change User's Email の確認ボックスが変化し、2 つのフォームが表示されます。Verify your identity フィールドに、メールアドレスに送信された確認コードを入力し、Set new email address for the user フィールドにユーザーの新しいメールアドレスを入力します。完了したら、Confirm ボタンをクリックします。

   User Overview ページにリダイレクトされます。ユーザーの古いメールアドレスに確認メッセージが送信されます。ユーザーが更新を確認すると、メールアドレスが自動的に変更されます。

AGS CLI

1. ユーザーの userId と namespace を確認します。ユーザーを検索する を参照してください。

2. 自分のアカウントの詳細を取得します。出力で、自分の userId、namespace、emailAddress を確認します。

   ags iam users get-my --format json

3. 本人確認を行うため、自分のメールアドレスに確認コードを送信します。<YourUserId>、<YourAccountNamespace>、<YourEmailAddress> を手順 2 で確認した値に置き換えます。

   ags iam users send-verification-code --namespace <YourAccountNamespace> --user-id <YourUserId> \
     --json '{"emailAddress": "<YourEmailAddress>", "context": "UpdateEmailAddress"}'

4. ユーザーのメールアドレスを変更します。<UserNamespace> と <UserId> を手順 1 で確認した値に、<VerificationCode> をメールで受け取ったコードに、<NewEmailAddress> をユーザーの新しいメールアドレスに置き換えます。

   ags iam users update-email --namespace <UserNamespace> --user-id <UserId> \
     --json '{"code": "<VerificationCode>", "emailAddress": "<NewEmailAddress>"}'

   AGS はユーザーの古いメールアドレスに確認メッセージを送信します。ユーザーが更新を確認すると、AGS はメールアドレスを自動的に変更します。

Link a third-party account

以下の手順を使用して、サードパーティアカウントをリンクします。

Admin Portal

1. 対象のユーザーを検索し、User Overview ページに移動します。Linked Accounts タブを選択します。

2. Linked Accounts タブで、Link an Account ボタンをクリックします。

3. Link an Account ポップアップが表示されます。以下の情報を入力します。

   • Platform ID フィールドで、ドロップダウンメニューから目的のサードパーティプラットフォームを選択します。

   • Platform User ID に、プレイヤーのアカウント ID を入力します。

   完了したら、Link をクリックします。

4. 新しくリンクされたアカウントが Linked Accounts のリストに追加されます。

AGS CLI

1. ユーザーの userId を確認します。ユーザーを検索する を参照してください。

2. アカウントをリンクします。<PlatformId> を steam などのサードパーティプラットフォームに、<PlatformUserId> をそのプラットフォーム上のプレイヤーのアカウント ID に置き換えます。

   ags iam users link-platform-account-forced --namespace <YourNamespace> --user-id <UserId> \
     --skip-conflict false --json '{"platformId": "<PlatformId>", "platformUserId": "<PlatformUserId>"}'

   警告

   --skip-conflict false はそのままにしてください。指定しない場合はデフォルトで true となり、サードパーティアカウントがリンクされている他のユーザーから、確認なしでアカウントが移動されます。

3. サードパーティアカウントがすでに別のユーザーにリンクされている場合、コマンドはエラーコード 10173 で失敗し、そのユーザーを表示します。そのユーザーからアカウントのリンクを解除してこのユーザーにリンクするには、--skip-conflict true を指定して手順 2 のコマンドを再度実行します。

Unlink a third-party account

Admin Portal

1. 対象のユーザーを検索し、User Overview ページに移動します。Linked Accounts タブを選択します。

2. Linked Accounts タブで、リンクを解除したいサードパーティアカウントを選択し、Action 列の下にある Unlink をクリックします。Delete Item の確認メッセージが表示されます。

3. Unlink をクリックして続行します。選択したサードパーティアカウントがリストから削除されます。

AGS CLI

1. ユーザーの userId を確認します。ユーザーを検索する を参照してください。

2. ユーザーのリンク済みアカウントを一覧表示します。リンクを解除したいアカウントの platformName をコピーします。

   ags iam users list-distinct-platform-accounts --namespace <YourNamespace> --user-id <UserId> --status LINKED

3. アカウントのリンクを解除します。<PlatformName> を手順 2 で確認した platformName に置き換えます。

   ags iam users unlink-platform-all --namespace <YourNamespace> --user-id <UserId> --platform-id <PlatformName>