> ## Documentation Index
> Fetch the complete documentation index at: https://docs-dev-actions-triggers-prototype.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Management APIを使用してユーザーを管理する

> Management APIを使用してユーザーを作成し、ユーザーとそのプロファイルの詳細を表示する方法を説明します。

Dashboardに加え、[Management API](/docs/ja-jp/api/management/v2#!/Users/get_users)を使用することでも、ユーザーの取得、作成、更新または削除を行うことができます。<Tooltip data-tooltip-id="react-containers-DefinitionTooltip-0" href="/docs/ja-jp/glossary?term=management-api" tip="Management API: 顧客が管理タスクを実行できるようにするための製品。" cta="用語集の表示">Management API</Tooltip>を直接呼び出したい場合は、先に適切なアクセストークンを生成する必要があります。詳細については、「[Management APIのアクセストークン](/docs/ja-jp/secure/tokens/access-tokens/management-api-access-tokens)」をお読みください。あるいは、SDKを使用して、アプリケーションからManagement APIを呼び出すために必要な機能性を実装できます。使用できるSDKのリストについては、[サポートマトリックスのSDKセクション](/docs/ja-jp/troubleshoot/customer-support/product-support-matrix)をお読みください。

チームメンバーによる<Tooltip data-tooltip-id="react-containers-DefinitionTooltip-0" href="/docs/ja-jp/glossary?term=auth0-dashboard" tip="Auth0 Dashboard: サービスを構成するためのAuth0の主製品。" cta="用語集の表示">Auth0 Dashboard</Tooltip>へのアクセスを管理する方法については、「[ダッシュボードアクセスを管理する](/docs/ja-jp/get-started/manage-dashboard-access)」をお読みください。

## 権限

以下の権限を使用して、マシンツーマシンアプリケーションのアクセストークンを取得します。詳細については、「[マシンツーマシンアプリケーションを登録する](/docs/ja-jp/get-started/auth0-overview/create-applications/machine-to-machine-apps)」をお読みください。

| 権限                          | 説明                                                                                                                                                                                                               |
| --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `read:users`                | アプリケーションは、Auth0テナントに保管されている任意のユーザーレコードを検索して取得することができます。これには、`/api/v2/users`、`/api/v2/users-by-email`、および`/api/v2/jobs/users-export`エンドポイントを使用した読み出しが含まれます。                                                       |
| `create:users`              | アプリケーションは、Auth0テナントにある任意のデータベースやパスワードレス接続にユーザーを作成することができます。これには、`/api/v2/users`や`/api/v2/jobs/users-import`エンドポイントを使用した作成が含まれます。`/api/v2/users`エンドポイントには、[サインアップエンドポイント](/docs/ja-jp/api/authentication#signup)。 |
| `update:users`              | アプリケーションは、Auth0テナントに保管されている任意のユーザーを更新することができます。これには、`/api/v2/users`エンドポイントを使用した更新が含まれます。                                                                                                                         |
| `update:users_app_metadata` | アプリケーションは、Auth0テナントに保管されている任意のユーザーの`user.app_metadata`属性だけを更新することができます。これには、`/api/v2/users endpoint`を使用した更新が含まれます。                                                                                               |
| `delete:users`              | アプリケーションは、Auth0テナントに保管されている任意のユーザーを削除することができます。これには、`/api/v2/users`エンドポイントを使用した削除が含まれます。                                                                                                                         |

## 制限事項

特に設定を変更しない限り、Auth0以外のIDプロバイダー（Google、Facebook、Xなど）によって提供されるユーザープロファイル属性は、ユーザーがログインするたびにIDプロバイダーから更新されるため、直接編集することはできません。

正規化ユーザープロファイルのルート属性である`name`、`nickname`、`given_name`、`family_name`、`picture`を編集可能にするには、[接続がAuth0と同期されるように構成](/docs/ja-jp/manage-users/user-accounts/user-profiles/configure-connection-sync-with-auth0)して、ユーザー属性がユーザープロファイルの作成時のみIDプロバイダーに更新されるようにしなければなりません。そうすれば、これらのルート属性を個別に、または一括インポートを通じて編集できるようになります。

パスワードは`create`エンドポイントまたは`update`エンドポイントを使用して設定できますが、セキュリティ上の理由から、`get`コマンドまたは`list user`コマンドでパスワードを閲覧することはできません。APIエクスプローラーの右側に、特定の呼び出しに対して閲覧または編集できるユーザープロファイル属性に関するヒントが提供されています。

## エンドポイント

* [すべてのユーザーに関する情報を取得](/docs/ja-jp/api/management/v2/users/get-users)するには、[`/users`](/docs/ja-jp/api/management/v2/users/get-users)エンドポイントを使用します。特定のユーザーを検索する検索条件を含めることもできます。
* `user_id`に基づいて[1人のユーザーに関する情報を取得](/docs/ja-jp/api/management/v2/users/get-users-by-id)するには、[`/user_id`](/docs/ja-jp/api/management/v2/users/get-users-by-id)を使用します。`user_id`は、接続名とユーザーの一意の識別子で構成される内部識別子です。`user_id`はIDトークンとは異なります。
* [`/userinfo`](/docs/ja-jp/api/authentication/reference#get-user-info)エンドポイントは、入力として[Auth0アクセストークンを受け取り、ユーザープロファイル情報を返します](/docs/ja-jp/api/authentication/reference#get-user-info)。このエンドポイントにはすべてのルールの結果が含まれ、この中には認証トランザクション時にユーザープロファイルを変更した可能性のあるものも含まれますが、結果であるユーザープロファイルはいずれの[スコーピング](/docs/ja-jp/scopes/api-scopes)によってもフィルタリングされません。
* [`/tokeninfo`](/docs/ja-jp/api/authentication/reference#get-token-info)エンドポイントは入力として[Auth0 IDトークンを受け取り、ユーザープロファイル情報を返します](/docs/ja-jp/api/authentication/reference#get-token-info)。このエンドポイントが返す結果には、ユーザープロファイルを変更したいかなるルールの結果も含みません。

## もっと詳しく

* [エラーメッセージを確認する](/docs/ja-jp/troubleshoot/basic-issues/check-error-messages)
* [APIの呼び出しをチェックする](/docs/ja-jp/troubleshoot/authentication-issues/check-api-calls)
* [ユーザープロファイルの確認](/docs/ja-jp/troubleshoot/authentication-issues/check-user-profiles)
* [Auth0.swift：ユーザー管理](/docs/ja-jp/libraries/auth0-swift/auth0-swift-user-management)
* [Auth0.Android：ユーザー管理](/docs/ja-jp/auth0-android-user-management)