ユーザー管理

ユーザー管理ページでは、Studio を利用できるユーザーを管理します。このページにアクセスするには、管理者 (Administrator) 権限を持つユーザーである必要があります。

ユーザー管理ページにアクセスする手順：

Studio にログインします。
管理者 () モジュールを開きます。
ユーザー管理 をクリックします。

ユーザー管理ページでは、以下の情報が表示されます：

姓、名
メールアドレス
ロール - 標準 (Standard)、管理者 (Administrator)、またはカスタムロール
モジュールアクセス - ユーザーがアクセスできるモジュールにはチェックマーク () が付きます。
最終ログイン - ユーザーが Video Cloud Studio に最後にログインした日付と時刻 (すべての Studio アカウントの最終ログイン情報が表示されます)。
設定 () - タブの表示・非表示をカスタマイズできます。また、三点メニューを使用してユーザーの編集や削除が可能です。

ユーザー管理ページでは、以下の操作が可能です：

新しいユーザーの作成
既存のユーザーの編集
ユーザーの削除
プライマリユーザーの変更
ロールの追加
ロールの割り当て
旧ロールの置き換え

ユーザーの上限

作成できるユーザーの数は、アカウントの種類によって異なります。追加のユーザーを作成する必要がある場合は、より多くのユーザーを作成できるプランにアップグレードすることができます。上限は、同時に存在するユーザーの総数にのみ適用されます。例えば、10 人のユーザーを作成し、そのうち 5 人を削除し、新たに 3 人のユーザーを追加した場合、合計 8 人のユーザーがいると見なされます。ユーザー管理ページでは、現在のユーザー数と追加可能なユーザー数を確認することができます。

追加ユーザーの購入

追加のユーザーを作成する必要がある場合は、より多くのユーザーを作成できるプランにアップグレードできます。Pro および Enterprise レベルのアカウントの場合、追加ユーザーの購入については弊社営業までお問い合わせください。

新しいユーザーの作成

新しいユーザーを作成するには、以下の手順に従ってください。

ユーザーを追加をクリックします。
名前 (First Name)、姓 (Last Name)、メールアドレス (Email) を入力します。

ロール を割り当てます。
- 管理者 - 管理メニューにアクセスでき、ユーザーアカウントの作成、トランスコードプロファイルの作成、カスタムフィールドの設定、メディア共有の設定が可能。
- 標準 - 管理メニューにアクセスすることができません。
- カスタムロール - 指定したロールに応じて特定のモジュールにアクセス可能。

保存をクリックします。

作成されたユーザーには、アカウントに追加されたことを知らせるメールが送信されます。

既存ユーザーの編集

既存のユーザーを編集するには、以下の手順に従ってください。

設定タブ の下にあるユーザーの三点メニュー () をクリックし、編集を選択します。ユーザーの詳細情報が表示されます。

利用可能なロールの中から別の ロール を選択して変更できます。

保存をクリックして変更を適用します。

ユーザーの削除

ユーザーを削除するには、以下の手順に従ってください。

設定タブ の下にあるユーザーの三点メニュー () をクリックし、削除を選択します。

削除を確認するには、削除をクリックします。

プライマリユーザーの変更

各アカウントには、1 人のプライマリユーザーが設定されます。プライマリユーザーには常に 管理者 のロールが割り当てられ、Brightcove サポートによってのみ削除できます。

プライマリユーザーを変更するには、設定タブ の下にあるユーザーの三点メニュー () をクリックし、編集を選択します。

このユーザーをこのアカウントのプライマリ管理者にする をクリックします。プライマリユーザーの変更を確認するプロンプトが表示されます。

新しいロールの追加

新しいロールを追加するには、以下の手順に従ってください。

ナビゲーションバーの ロール タブを選択します。
ロールの追加をクリックします。

以下のロール情報を入力します。
- ロール名 - ユーザーの役割を適切に表す名前を設定します。
- 管理者 - このロールに管理者権限を付与するかどうかを選択します。
- モジュールのアクセス権 - ロールにアクセスを許可するモジュールを選択します。
- 非アクティブモジュールを非表示 - 無効なモジュールを隠し、関連するモジュールのみ表示するには ON に設定します。
- 動画機能 - このロールに割り当てられたユーザーが持つビデオ関連の権限を定義します。利用可能なビデオ権限は以下のとおりです。
  - 動画のアクティブ化または非アクティブ化: ユーザーがアカウント内のビデオを有効または無効にできるようにします。
  - 動画の削除: アカウントからビデオを完全に削除する権限を付与します。
  - 動画エディター: Brightcove Studio 内のビデオ編集ツールへのアクセスを許可します。
  - 動画メタデータの編集: タイトル、説明、タグなどのメタデータを編集できるようにします。
  - 動画のアップロード: Brightcove プラットフォームへ新しいビデオをアップロードできるようにします。
  - メールへの公開 : メールプラットフォーム経由でビデオを公開・共有することを許可します。
  - Web への公開 : Web ページやその他のオンラインプラットフォームへビデオを公開する権限を付与します。
  - ビデオの共有 : 他のユーザーやアカウントとビデオを共有できるようにします。
  - すべてのビデオ (非公開および共有ビデオを含む) へのアクセス : この権限を持つユーザーは、アカウント内のすべてのビデオ (非公開および他のユーザーから共有されたビデオを含む) にアクセスできます。また、このロールが割り当てられたユーザーは メディアモジュール (Media Module) の すべてのビデオ (All Videos) タブにアクセスできるようになります。
  - 関連アカウントとの共有: プライマリアカウントに関連付けられた他の Brightcove アカウントとビデオを共有できるようにします。
注: 最大 8 つの異なるロールを作成できます。

保存をクリックします。

ロールタブには以下の情報が表示されます。

ロール名
そのロールが割り当てられたユーザーの数
モジュールアクセス - そのロールがアクセス可能なモジュールにはチェックマーク () が表示されます。
設定 () - ここでは、表示するタブのカスタマイズが可能です。

ロールの割り当て

新しいロールをユーザーに割り当てるには、以下の手順に従ってください。

ロールを割り当てたいユーザーを 1 人以上選択します。
ロールを割り当てる をクリックします。

選択したユーザーに適用する既存のロールを 1 つ以上選択します。

ロールを割り当てるをクリックします。

旧ロールの置き換え

最新のアップデートにより、Brightcove はユーザーロールにより細かな権限設定を追加しました。移行されていないユーザーは (Legacy) ラベルが付けられ、新しい機能を利用できません。

旧ロールを新しいロールに置き換えるには、以下の手順に従ってください。

設定タブ の下にあるユーザーの三点メニュー () をクリックし、編集を選択します。ユーザーの詳細情報が表示されます。

ドロップダウンリストから新しいロールを選択して、旧ロールを置き換えます。
編集をクリックして変更を保存します。

旧ロールの一括置き換え

新しいロールを割り当てたい旧ロールユーザーを 1 人以上選択します。
ロールを割り当てる をクリックします。

選択したユーザーに適用する既存のロールを 1 つ以上選択します。
旧ロールを置き換える のチェックボックスをオンにします。
ロールを割り当てるをクリックします。

複数アカウントの管理

追加アカウントを作成すると、新しい Video Cloud アカウントと同様に追加の 10 ユーザーが付与されると誤解されることがあります。しかし、追加の Video Cloud アカウントには追加のユーザー枠は含まれません。

例えば、最初のアカウントに 10 人のユーザーを追加し、その 10 人を別のアカウントにも追加した場合、合計ユーザー数は依然として 10 のままです。ライセンス契約では、各ユニークユーザー ID は複数のアカウントで使用できるものの、1 人のユーザーとしてカウントされます。

複数のアカウントを持っている場合、ユーザーは各アカウントに個別に追加する必要があります。例えば、アカウント A とアカウント B がある場合、ユーザーをアカウント A に追加しても、自動的にアカウント B にはアクセスできません。必要なアカウントごとにユーザーを追加する必要があります。

複数のアカウントの管理について詳しくは、複数の Video Cloud アカウントの管理を参照してください。

制限事項

旧ロールを新しいロールに一括編集することはできません。一括編集を試みると、次のようなポップアップメッセージが表示されます。

ユーザー管理 API

概要

ユーザー管理 API を使用すると、Brightcove アカウント内のユーザーとロールの割り当てをプログラムで管理できます。利用可能なロールの取得、ユーザーの一覧表示、ユーザーの作成、ロールの割り当ての更新、ユーザーの削除などの操作が可能です。

ベース URL

https://accounts.api.brightcove.com/v1

認証

ユーザー管理 API は OAuth 2.0（クライアント資格情報グラント）を使用します。アクセストークンを取得し、Authorization ヘッダーに Bearer トークンとして送信してください。

必要な権限

クライアント資格情報には以下の権限が必要です：

ユーザー管理: 作成 - 新しいユーザーを作成するか、既存のユーザーをアカウントに追加します
ユーザー管理: 削除 - アカウントからユーザーを削除します
ユーザー管理: 読み取り - ユーザーとロールの情報を取得します
ユーザー管理: 更新 - ユーザーとロールの割り当てを更新します

重要な前提条件

ロールの検証が必要

ユーザーを作成または更新する際は、アカウントに既に存在するロールを割り当てる必要があります。

ユーザー数の上限が適用されます

各アカウントにはユーザー数の上限（maxUsers）があります。上限に達した場合、作成リクエストは以下のエラーで失敗します：

[
          {
            "error_code": "REQUEST_MALFORMED",
            "message": "Maximum number of users reached for this account"
          }
        ]

一般的なワークフロー

OAuth アクセストークンを取得します。
```
https://oauth.brightcove.com/v4/access_token
```
アカウントで利用可能なロールを取得します（GET /v1/accounts/{account_id}/roles）。
有効なロール名を使用してユーザーを作成します（POST /v1/accounts/{account_id}/users）、またはロールの割り当てを更新します（PATCH / PUT）。
ユーザーの一覧（GET /v1/accounts/{account_id}/users）または単一ユーザーの取得（GET /v1/accounts/{account_id}/users/{user_id}）で結果を確認します。

エンドポイント

ユーザー管理 API エンドポイント
ユースケース	メソッドとエンドポイント	備考
アカウントのロールを取得	`GET /v1/accounts/{account_id}/roles`	ロールの割り当てには返された `name` 値を使用します
ユーザー一覧を取得	`GET /v1/accounts/{account_id}/users`	指定されたアカウントのユーザーを返します
ユーザー詳細を取得	`GET /v1/accounts/{account_id}/users/{user_id}`	`user_id` で単一のユーザーを返します
ユーザーを作成	`POST /v1/accounts/{account_id}/users`	新しいユーザーを作成するか、既存のユーザーをアカウントに追加します
ユーザーを更新（部分更新）	`PATCH /v1/accounts/{account_id}/users/{user_id}`	指定したフィールドのみ更新します（主に `roles`）
ユーザーのロールを置き換え	`PUT /v1/accounts/{account_id}/users/{user_id}/roles`	ユーザーのすべてのロール割り当てを置き換えます
ユーザーを削除	`DELETE /v1/accounts/{account_id}/users/{user_id}`	アカウントからユーザーを削除します

リクエストの例

アカウントのロールを取得

curl --location 'https://accounts.api.brightcove.com/v1/accounts/{account_id}/roles' \
          --header 'Authorization: Bearer {access_token}'

ユーザー一覧を取得

curl --location 'https://accounts.api.brightcove.com/v1/accounts/{account_id}/users' \
          --header 'Authorization: Bearer {access_token}'

ユーザーを作成

リクエストボディの roles には、ロールの name 値を指定する必要があります。

curl --location 'https://accounts.api.brightcove.com/v1/accounts/{account_id}/users' \
          --header 'Content-Type: application/json' \
          --header 'Authorization: Bearer {access_token}' \
          --data-raw '{
            "email_address": "newuser@example.com",
            "first_name": "Jane",
            "last_name": "Smith",
            "roles": ["Standard"],
            "skipWelcomeEmail": true
          }'

ユーザーを更新（部分更新）- ロールの置き換え

curl --location --request PATCH 'https://accounts.api.brightcove.com/v1/accounts/{account_id}/users/{user_id}' \
          --header 'Content-Type: application/json' \
          --header 'Authorization: Bearer {access_token}' \
          --data '{
            "roles": ["Admin"]
          }'

ユーザーのロールを置き換え

curl --location --request PUT 'https://accounts.api.brightcove.com/v1/accounts/{account_id}/users/{user_id}/roles' \
          --header 'Content-Type: application/json' \
          --header 'Authorization: Bearer {access_token}' \
          --data '["Standard", "Custom Role"]'

ユーザーを削除

curl --location --request DELETE 'https://accounts.api.brightcove.com/v1/accounts/{account_id}/users/{user_id}' \
          --header 'Authorization: Bearer {access_token}'

エラー処理

API は標準的な HTTP ステータスコードを使用し、JSON 形式のエラーボディを返します。

標準エラー形式

一部のエラーは単一のオブジェクトを返します：

{
          "error_code": "ERROR_CODE_NAME",
          "message": "Human-readable error message"
        }

バリデーションエラーはオブジェクトの配列を返す場合があります：

[
          {
            "error_code": "REQUEST_MALFORMED",
            "message": "Validation message"
          }
        ]

よくあるエラー

ユーザー数の上限に達しました: REQUEST_MALFORMED（シートの追加は Brightcove サポートにお問い合わせください）
ユーザーが既に存在します: CONFLICT
無効または存在しないロール: REQUEST_MALFORMED（ロールを取得して既存のロールの name 値を使用してください）
ユーザーが見つかりません: NOT_FOUND
無効なアクセストークン: UNAUTHORIZED
権限が不足しています: FORBIDDEN