サポート サポートへのお問い合わせ | システムステータス システムステータス
ページコンテンツ

    OAuth ガイド

    Brightcove ブはOAuth2システムこれは、承認のためにすべての新しいAPIで使用できます。このトピックでは、OAuth を使用してプレーヤー管理 API と通信する方法について説明します。

    はじめに

    システムを使用するために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つの方法があります。

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

    次に、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、を参照してくださいBrightcove ブPlayer Management API参照ドキュメント。