Brightcove Default Player の一括更新

はじめに

このドキュメントで示す curl コマンドは、複数のアカウントをループ処理し、それらのアカウント内の Brightcove Default Player のみを、指定した Brightcove Player バージョンに更新します。 更新および公開に使用する curl コマンドを実行する前提として、使用するアクセス トークンの取得方法を紹介します。

アクセス トークンの取得

curl コマンドを実行するすべてのアカウントに対して Player Read/Write 権限を持つアクセストークンが必要です。 Studio の 管理者 メニューから API 認証 を選択します。 新しいアプリケーションを登録し、対象となるアカウントを選択します。 公開される Brightcove API では Players > Read/Write と CMS > Videos > Read/Write を選択します。

保存後、Client ID と Client Secret をコピーします。

このプロセスの詳細は、アクセストークンの生成 を参照してください。

次に、サンプルを使用してアクセス トークンを取得します: OAuth API サンプル：アクセス トークンの取得。 アクセス トークンの有効期限は 5 分間のため、必要に応じて再取得してください。

curl コマンド

いくつかのファイルを作成し、Terminal からスクリプトを実行するためのフォルダを作成します。 まず accountList.txt というファイルを作成し、その中に Brightcove Default Player を更新したいアカウントの account ID をコピー＆ペーストします。

次に、bulk-update.sh というファイルを作成し、以下の curl コマンドを記述します:

            #!/bin/bash
      
      #Loop through publisher IDs in accountlist.txt
      while read -r ACCOUNTID; do
      echo {account_id}ID
      
      #Update
      curl -X PATCH "https://players.api.brightcove.com/v1/accounts/ID/players/default/configuration" \
      -H "Authorization: Bearer YOUR_ACCESS_TOKEN_HERE" \
      -H 'Content-Type: application/json' \
      -d '{"player":{"template":{"version":"6.34.3"}}}'
      
      #Publish
      curl -X POST "https://players.api.brightcove.com/v1/accounts/ID/players/default/publish" \
      -H "Authorization: Bearer YOUR_ACCESS_TOKEN_HERE" \
      -H 'Content-Type: application/json' \
      -d '{"comment": "Updated to v6"}'
      
      #Wait 1 second then loop
      sleep 1
      done <accountList.txt
          

当然ながら、YOUR_ACCESS_TOKEN_HERE の 2 か所は実際のアクセストークンに置き換えてください。 アクセストークンを生成してから 5 分以上経っている場合、再度サンプルを実行して新しいトークンを取得する必要があります。 また、使用するプレーヤーのバージョンは任意で、上記の 6.34.3 を変更して構いません。

最後に、作成した 2 つのファイルがあるフォルダで Terminal を開き、以下を実行します:

            bash ./bulk-update.sh
          

このスクリプトは、プレーヤー バージョンの更新とプレーヤーの公開を実行します。