OAuthガイド

入門

システムを使用するためにOAuthについて何も知る必要はありません。以下では、開始するために必要なすべてのことを説明します。OAuthの詳細な概要については、 Brightcove OAuth APIドキュメント。

OAuth認証を使用するには、次の手順に従います。

1. クライアントの資格情報を取得する
2. アクセストークンを取得する
3. 電話Player Management API
4. 手順2と3を簡略化するには、サーバー側プロキシを使用します

で作業するときPlayer Management API、基本認証を使用することもできます。詳細については、ステップバイステップ：プレイヤー管理ドキュメント。

クライアント認証情報を取得する

OAuthを使用するには、最初にクライアントの資格情報を取得する必要があります（client_idそしてclient secret）。これらの認証情報は、使用しているアカウントとAPI操作に有効です。これらの資格情報を将来の使用のために安全な場所に保存する場合、これは1回限りの操作です。

資格情報を取得するには、次の2つの方法があります。

権限が必要な操作は次のとおりです。

• 推奨される方法は、Studio AdminUIを使用することです。 API認証資格情報の管理資料。
• に示すようにcURLを使用することもできますcURLを使用してクライアント資格情報を取得する資料。
  1. スタジオの場合：

     

  2. OAuth APIを介して認証情報を取得するには：
     • video-cloud/player/read
     • video-cloud/player/all

次に、OAuthアクセストークンを取得する必要があります。

アクセストークンの取得

前の手順で取得したクライアント資格情報は、アクセストークンを要求するために使用されます（access_token）、API呼び出しを行うための承認を提供します。このトークンは5分間しか有効ではないため、ほとんどの場合、API呼び出しごとにトークンを取得する必要があります。

cURLを使用してアクセストークンを取得するには、次の手順に従います。

1. コマンドラインで、exportクライアントIDとクライアントシークレットの値を設定するコマンド。

       export CLIENT_ID=your client id value
                 export CLIENT_SECRET=your client secret value

2. 次の cURL ステートメントをコピーしてコマンドラインに貼り付け、Enter キーを押します。

       curl
                 -s
                 --user $CLIENT_ID:$CLIENT_SECRET
                 --header "Content-Type: application/x-www-form-urlencoded"
                 --data "grant_type=client_credentials"
                 https://oauth.brightcove.com/v4/access_token

3. 回答は次のようになります。

       {"access_token":"AGUq5IQzLzrRvs8CNbhYlBFeB1_B6jTJrcE8grFHEJaPRsPeEg3-S_Apgv8VKiZ-nzxjDGtKwAco9q3z8tdzrxq76k6B9tUXk9HYQOIYgqziWbuvA50VaW8AK2MQFc0G3-woH_kgQxNQUaVNEpE1sePE9GUb2u9FfeQyLw8XQE_QfriYwkkcQoaGOusoIpujx8H6dLFovPuH5F5N3OSxNYhNZrdOhJwkdN7oe076j3xwNRarHn5IRPYKzjOMbqDk552aAhJxo2pYWoDh3q63pBrzre4Bj1rCHKJPifPEMrgPWzG1Uz1BPhQb5_ubr4P8mtnhCjJn4zzT_1-C8ActMUof45kVFhG4VTWRA8rh05THqEBj_TzPIR7L1t5oHhLo5ziILNSp7mZRM3folvYJC6YIhY7M4qLNGR5iq3nerlv5Ufr_bI-1AnP7a68JasawDpZxjfoGf3h6cwIZJr2uG_iU4FO9Ig-Gotaqv5mLWmUgR-DJ3sfRADc",
                 "token_type":"Bearer",
                 "expires_in":300}

アクセストークンを使用して、Player Management API。

電話Player Management API

OAuthを使用して通信するにはPlayer Management API、前のセクションで生成したアクセストークンが必要になります。このトークンは5分後に期限切れになるため、アクセストークンの有効期限が切れている場合は、前のセクションの手順を繰り返す必要がある場合があります。

cURLを使用してプレーヤー構成情報を取得するには、次の手順に従います。

1. コマンドラインで、exportアクセストークン、アカウントID、プレーヤーIDの値を設定するコマンド。

       export ACCESS_TOKEN=your access token value
                 export ACCOUNT_ID=your account id
                 export PLAYER_ID=your player id

2. 次の cURL ステートメントをコピーしてコマンドラインに貼り付け、Enter キーを押します。

       curl
                 --header "Content-Type: application/json"
                 --header "Authorization: Bearer $ACCESS_TOKEN"
                 --request GET
                 https://players.api.brightcove.com/v2/accounts/{account_id}/players/{player_id}/configuration

3. 回答は次のようになります。

       {"video_cloud":{"video":null,"policy_key":"BCpkADawqM3VpA66ktTO5bdLTmz6kLGMvGZrSyp-YTvbc4MHllmDmuwzEseO1uTeYYRqygGHhB_MgMaM6ndh5ch-cKYtMFx3LerHyziID8M19b162eeIXKYaxDf8uh4OsLTxVijM-qT1N5QR"},
                 "stylesheets":["http://solutions.brightcove.com/bcls/brightcove-player/disabled-scrubber/disabled-scrubber.css"],
                 "scripts":[],"plugins":[],
                 "player":{"template":{"version":"1.14.22","name":"single-video-template"}},
                 "autoadvance":0}

あなたがすることができるすべての要求について学ぶためにPlayer Management API、を参照してくださいブライトコーブPlayer Management API参照ドキュメント。