Video Cloud API を使用する場合、Player サービス設定で基本認証を有効にしない限り、メソッド呼び出しにアクセストークンが必要になります。基本認証の有効化の詳細については、「アカウント設定の管理」を参照してください。
クライアント登録の作成
[API 認証] ページを使用して、新しいクライアント登録を作成します。登録を作成するときに、登録で有効にするサービスとロールを選択できます。
アカウントに新しいクライアント登録を作成するには：
- Studio ヘッダーの [ 管理者]リンクをクリックします。
- [ API 認証]リンクをクリックします。API 認証ページが開き、現在のクライアント登録が表示されます。
- [新規アプリケーションの登録]をクリックします。
- クライアント登録の [ 名前]と [ 説明 ] を入力します。
- 承認するアカウントを 1 つ以上選択します。
- この登録で有効にする API と権限を選択します。
- [保存]をクリックします。
- クライアント ID とクライアントシークレットが返されます。
クライアント登録の管理
[API 認証] ページを使用して、クライアント登録を表示および管理できます。Studio ヘッダーの [ 管理者]リンクをクリックし、[ API 認証] をクリックします。現在の登録のリストが表示されます。
登録の詳細を表示するには、名前のをクリックします。ここから、次の操作を実行できます。
- 名前を変更する
- クライアント ID をコピーします
- 承認のためのアカウントを追加する
- 有効にする追加の API を選択してください
- 資格情報を削除する
[ 保存] をクリックして、変更を保存します。
複数のアカウントに対してクレデンシャルを作成した場合、すべてのアカウントにアクセスできる場合にのみ、その資格情報が表示されます。たとえば、ユーザー 1 はアカウント A と B の資格情報を作成します。ユーザー 2 はログインし、アカウント A にのみアクセス権を持ちます。ユーザー 2 には、アカウント B へのアクセス権がないため、資格情報が表示されません。
クライアント登録の削除
クライアント登録を削除するには、削除アイコン（
) 登録の横にあるか、登録を編集し、[ 登録の削除] をクリックします。登録を削除すると、その登録は完全に無効になり、元に戻すことはできません。
DFP の操作
現在、DFP でコンテンツソースとして複数の Video Cloud アカウントを設定している場合は、次の 2 つのオプションがあります。
- DFP でコンテンツソースとして設定された Video Cloud アカウントごとに、一意のクライアント ID とクライアントシークレットを作成できます。たとえば、10 の Video Cloud アカウントがある場合、Video Cloud の API 認証設定に DFP という名前のアプリケーションが 10 個あります。
- DFP でコンテンツソースとして設定されているすべての Video Cloud アカウントに対して、単一のクライアント ID とクライアントシークレットを作成できます。たとえば、10 の Video Cloud アカウントがある場合、Video Cloud の API 認証設定に DFP という名前のアプリケーションが 1 つあります。
オプション #1 または #2 のどちらを選択したかに関係なく、DFP で設定したコンテンツソースごとに、一意のアカウント ID を指定する必要があります。したがって、DFP で現在設定されているコンテンツソースの数を減らすことはありません。読み取りトークンを、クライアント ID とクライアントシークレットに置き換えるだけです。クライアントシークレットは、コンテンツソース間で同じか、またはそれぞれで一意にすることができます。
オプション #1 は前面に時間がかかります。ただし、クライアント ID とクライアントシークレットがすべてのコンテンツソースで同じ場合 (オプション #2 と同様)、新しいクライアント ID とクライアントシークレットを生成し、DFP 内のすべてのコンテンツソースを更新する必要があるため、新しいコンテンツソースを追加するのは負担になります。したがって、ブライトコーブはオプション #1 を推奨しています。