Frame.io V4 モジュール

IMPORTANT
この記事では、Frame.io コネクタの新しいバージョンについて説明します。 このコネクタは、Frame.io バージョン 4 への接続に使用します。
Frame.io コネクタのレガシーバージョンの手順については、Frame.io レガシーコネクタを参照してください。

Adobe Workfront Fusion Frame.io モジュールを使用すると、Frame.io アカウント内のアセットやコメントをモニター、作成、更新、取得、削除できます。

Workfrontには、接続先の Frame.io のバージョンに基づく 2 つの Frame.io コネクタが用意されています。

コネクタ
Frame.io バージョン
Frame.io
V4
Frame.io (レガシー)
V3

Frame.io コネクタのレガシーバージョンの手順については、Frame.io レガシーコネクタを参照してください。

Frame.io コネクタの紹介ビデオについては、以下を参照してください。

アクセス要件

展開すると、この記事の機能のアクセス要件が表示されます。

この記事で説明している機能を使用するには、次のアクセス権が必要です。

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront パッケージ 任意
Adobe Workfront プラン

新規:標準

または

現在:仕事以上

Adobe Workfront Fusion ライセンス**

現在:Workfront Fusion ライセンス要件なし

または

従来のバージョン:作業の自動化と統合のためのWorkfront Fusion

製品

新規:

  • Prime Workfront パッケージを選択する:Adobe Workfront Fusion を購入する必要があります。
  • Ultimate Workfront パッケージ:Workfront Fusion が含まれています。

または

現在:Adobe Workfront Fusion を購入する必要があります。

このテーブルの情報について詳しくは、 ドキュメントのアクセス要件を参照してください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

前提条件

Frame.io モジュールを使用するには、Frame.io アカウントが必要です。

Frame.io API 情報

Frame.io コネクタでは、以下を使用します。

ベース URL
https://api.frame.io/v4
API バージョン
v2
API タグ
v1.0.76

Frame.io から Adobe Workfront Fusion への接続

ユーザー資格情報を使用して自動的に接続したり、ユーザー資格情報の接続を手動で作成したり、サーバー間接続を作成したりできます。

ユーザーの資格情報を使用して自動的に接続

この方法では、Frame.io にログインしている場合に自動的に接続が作成されます。または、Frame.io のログインページに接続され、ログインできるようになります。

  1. 任意の Frame.io Beta モジュールで、「接続」ボックスの横にある「追加」をクリックします。
  2. 接続に名前を入力します。
  3. 続行」をクリックします。
  4. Frame.io アカウントにログインするように求められたら、ログインします。
  5. 複数の Frame.io 組織に属している場合は、この接続に使用する組織を選択します。

接続が作成されます。

ユーザー資格情報接続の手動作成

ユーザー資格情報接続を作成するには、Frame.io にログインするか、クライアント ID またはクライアント シークレットを指定します。

サーバー間接続を作成するには、まずAdobe Developer Consoleでアプリケーションを設定する必要があります。

Adobe Developer Consoleでのユーザー資格情報の作成

Adobe Developer Console プロジェクトのサーバー間資格情報がまだない場合は、作成できます。

  1. Adobe Developer Console を開きます。

  2. この連携に使用する既存のプロジェクトをAdobe Developer Consoleで選択

    または

    Adobe Developer Consoleで新規プロジェクトを作成します。 手順については、 空のプロジェクトの作成を参照してください。

  3. プロジェクトの概要ページまたは新しいプロジェクトの基本を学ぶページで、「API を追加」をクリックします。

  4. 開いたページで、Frame.io API を見つけてクリックします。

  5. 認証タイプを選択ページで「ユーザー認証」を選択し、「次へ」をクリックします。

  6. ユーザー認証資格情報を追加ページで、「OAuth Web アプリ」を選択し、「次へ」をクリックします。

  7. OAuth Web アプリ資格情報を設定ページで、以下を入力します。

    table 0-row-2 1-row-2 layout-auto html-authored no-header
    の既定のリダイレクト URI https://oauth.app.workfrontfusion.com/oauth/cb/frame-io2
    リダイレクト URI パターン ​ https://oauth\.app\.workfrontfusion\.com/oauth/cb/frame-io2
  8. 次へ」をクリックします。

  9. 設定済み API を保存 をクリックします。

  10. 製品ページで、作成した資格情報のカードをクリックします。

    ここでは、クライアント ID とクライアント秘密鍵を確認できます。

NOTE
Adobe Workfront Fusion で接続の設定を開始する際は、このウィンドウを開いたままにすることをお勧めします。 クライアント ID をコピーし、このページからクライアント秘密鍵を取得およびコピーして、接続フィールドに貼り付けることができます。

ユーザー認証接続の設定

  1. 任意の Frame.io Beta モジュールで、「接続」ボックスの横にある「追加」をクリックします。

  2. 「接続を作成」ボックスで、「詳細設定を表示」をクリックします。

  3. 次のフィールドに入力します。

    table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
    Connection type IMS ユーザー認証 を選択します。
    Connection name この接続の名前を入力します。
    Client ID

    Adobe Client ID を入力します。これは、Adobe Developer Console の Credentials details セクションで確認できます。

    資格情報の作成方法については、この記事の Adobe Developer Consoleでのユーザー資格情報の作成を参照してください。

    Client Secret

    Adobe Client Secret を入力します。これは、Adobe Developer Console の Credentials details セクションで確認できます。

    資格情報の作成方法については、この記事の Adobe Developer Consoleでのユーザー資格情報の作成を参照してください。

  4. Frame.io アカウントにログインするように求められたら、ログインします。

  5. 複数の Frame.io 組織に属している場合は、この接続に使用する組織を選択します。

接続が作成されます。

サーバー間接続の作成

サーバー間接続を作成するには、まずAdobe Developer Consoleでアプリケーションを設定する必要があります。

Adobe Developer Consoleでのサーバー間資格情報の作成

Adobe Developer Console プロジェクトのサーバー間資格情報がまだない場合は、作成できます。

  1. Adobe Developer Console を開きます。

  2. この連携に使用する既存のプロジェクトをAdobe Developer Consoleで選択

    または

    Adobe Developer Consoleで新規プロジェクトを作成します。 手順については、 空のプロジェクトの作成を参照してください。

  3. プロジェクトの概要ページまたは新しいプロジェクトの基本を学ぶページで、「API を追加」をクリックします。

  4. 開いたページで、Frame.io API を見つけてクリックします。

  5. 認証タイプを選択ページで「サーバー間認証」を選択し、「次へ」をクリックします。

  6. 資格情報の名前を入力します。 これにより、後でAdobe Admin Consoleの「API 資格情報」領域で資格情報を識別できます。

  7. 次へ」をクリックします。

  8. 製品プロファイルを選択ページで、接続先の Frame.io アカウントを含む製品プロファイルを選択します。

  9. 設定済み API を保存 をクリックします。

  10. 製品ページで、作成した資格情報のカードをクリックします。

    ここでは、クライアント ID とクライアント秘密鍵を確認できます。

NOTE
Adobe Workfront Fusion で接続の設定を開始する際は、このウィンドウを開いたままにすることをお勧めします。 クライアント ID をコピーし、このページからクライアント秘密鍵を取得およびコピーして、接続フィールドに貼り付けることができます。

サーバー間接続の設定

  1. 任意の Frame.io Beta モジュールで、「接続」ボックスの横にある「追加」をクリックします。

  2. 次のフィールドに入力します。

    table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
    Connection type IMS サーバーからサーバーへ を選択します。
    Connection name この接続の名前を入力します。
    Client ID

    Adobe Client ID を入力します。これは、Adobe Developer Console の Credentials details セクションで確認できます。

    資格情報の作成方法については、この記事の Adobe Developer Consoleでのサーバー間資格情報の作成を参照してください。

    Client Secret

    Adobe Client Secret を入力します。これは、Adobe Developer Console の Credentials details セクションで確認できます。

    資格情報の作成方法については、この記事の Adobe Developer Consoleでのサーバー間資格情報の作成を参照してください。

  3. 続行」をクリックして接続を保存し、モジュールに戻ります。

Frame.io モジュールとそのフィールド

Frame.io モジュールを設定すると、Workfront Fusion には以下のフィールドが表示されます。これらとともに、アプリやサービスのアクセスレベルなどの要因に応じて、追加の「Frame.io」フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 モジュール間で情報をマッピングするを参照してください。

マップ切り替え

アセット

​ アセットを作成 ​

このアクションモジュールでは、新しいアセットを作成できます。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
アカウントを選択するか、アセットを作成するプロジェクトを含むアカウントの ID をマッピングします。
Workspace ID
ワークスペースを選択するか、アセットを作成するプロジェクトを含むワークスペースの ID をマッピングします。
Project ID
アセットを作成するプロジェクトを選択するか、プロジェクトの ID をマッピングします。
Path
アセットを作成するパスを選択します。
File Name
このアセットに使用するファイルの名前を入力します。
ファイルサイズ
ファイルサイズをバイト単位で入力またはマッピングします。
Source URL
ファイルを作成する場合、アップロードするファイルの URL を入力します。
メディアの種類 ​
このアセットのメディアタイプを選択します。

​ アセットの削除 ​

このアクションモジュールは、指定したアセットを削除します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
アカウントを選択するか、削除するアセットを含むアカウントの ID をマッピングします。
Asset ID
削除するアセットを選択またはマッピングします。

​ アセットの取得 ​

このアクションモジュールは、アセットの詳細を取得します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
アカウントを選択するか、取得するアセットを含むアカウントの ID をマッピングします。
Asset ID
取得するアセットを選択またはマッピングします。

​ アセットのリスト ​

この検索モジュールは、指定されたプロジェクトのフォルダー内のすべてのアセットを取得します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
アカウントを選択するか、リストするアセットを含むアカウントの ID をマッピングします。
返されるアセットの最大数 ​
各シナリオの実行サイクル中に、モジュールが返すアセットの最大数を入力またはマッピングします。

ウォッチのアセットが削除されました

このトリガーモジュールは、アセットが削除されたときにシナリオを開始します。

このモジュールに使用する Webhook を選択するか、Webhook フィールドの横にある「追加」をクリックして、次の情報を入力します。

Webhook name
新しい Webhook の名前を入力します。
Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
アカウントを選択するか、削除されたアセットを監視するアカウントの ID をマッピングします。

新しいアセットをウォッチ

このトリガーモジュールは、新しいアセットが作成される際にシナリオを開始します。

このモジュールに使用する Webhook を選択するか、Webhook フィールドの横にある「追加」をクリックして、次の情報を入力します。

Webhook name
新しい Webhook の名前を入力します。
Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
アカウントを選択するか、新しいアセットを監視するアカウントの ID をマッピングします。

コメント

コメントの作成

このアクションモジュールは、新しいコメントまたは返信をアセットに追加します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
アカウントを選択するか、コメントを追加するアセットを含むアカウントの ID をマッピングします。
Workspace ID
アカウントを選択するか、コメントを追加するアセットを含むワークスペースの ID をマッピングします。
Project ID
プロジェクトを選択するか、コメントを追加するアセットが含まれるプロジェクトの ID をマッピングします。
Path
コメントを追加するアセットへのパスを選択します。
Text
コメントまたは返信のテキスト内容を入力します。
Timestamp
コメントのリンク先となるビデオのフレーム番号を入力します。
ページ ​
アセットがPDFの場合は、コメントを添付するページを入力またはマッピングします。

コメントを削除

このアクションモジュールは、既存のコメントを削除します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
アカウントを選択するか、削除するコメントを含むアカウントの ID をマッピングします。
Comment ID
削除するコメントの ID を入力またはマッピングします。

​ コメントを取得 ​

このアクションモジュールは、指定されたコメントの詳細を取得します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
アカウントを選択するか、詳細を取得するコメントを含むアカウントの ID をマッピングします。
Comment ID
詳細を取得するコメントを選択します。

コメントの一覧表示

この検索モジュールは、指定されたアセットのすべてのコメントを取得します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
コメントを取得するアセットを含んだアカウントを選択またはマッピングします。
Workspace ID
コメントを取得するアセットを含むワークスペースを選択またはマッピングします。
Project ID
コメントを取得するアセットを含んだプロジェクトを選択します。
Path
コメントをリストするアセットを含むパスを選択します。
Maximum number of returned comments
各シナリオの実行サイクル中にモジュールが返すコメントの最大数を入力またはマッピングします。

​ コメントの更新 ​

このアクションモジュールは、既存のコメントを編集します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
コメントを更新するアセットを含んだプロジェクトを含んだアカウントを選択またはマッピングします。
Comment ID
更新するコメントを選択します。
Text
コメントのテキストコンテンツを入力します。
Timestamp
コメントのリンク先となるビデオのフレーム番号を入力します。
ページ ​
アセットがPDFの場合は、コメントが添付されているページを入力またはマッピングします。

コメントを見る更新されました

このトリガーモジュールは、コメントが更新されると、シナリオを開始します。

このモジュールに使用する Webhook を選択するか、Webhook フィールドの横にある「追加」をクリックして、次の情報を入力します。

Webhook name
新しい Webhook の名前を入力します。
Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
アカウントを選択するか、更新されたコメントを監視するアカウントの ID をマッピングします。

新しいコメントを見る

このトリガーモジュールは、コメントが作成されるとシナリオを開始します。

このモジュールに使用する Webhook を選択するか、Webhook フィールドの横にある「追加」をクリックして、次の情報を入力します。

Webhook name
新しい Webhook の名前を入力します。
Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
アカウントを選択するか、新しいコメントを監視するアカウントの ID をマッピングします。

フォルダー

フォルダーを作成

このアクションモジュールは、Frame.io に新しいフォルダーを作成します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
フォルダーを作成するアカウントを選択またはマッピングします。
Workspace ID
フォルダーを作成するワークスペースを選択またはマッピングします。
Project ID
フォルダーを作成するを選択します。
Path
フォルダーを作成するパスを選択します。
名前
新しいフォルダーの名前を入力またはマッピングします。

プロジェクト

プロジェクトを作成

このアクションモジュールは、Frame.io に新しいプロジェクトを作成します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
プロジェクトを作成するアカウントを選択またはマッピングします。
Workspace ID
プロジェクトを作成するワークスペースを選択またはマッピングします。
名前
新しいプロジェクトの名前を入力またはマッピングします。

Frame.io プロジェクトへのユーザーの招待

このアクションモジュールは、指定された Frame.io プロジェクトにユーザーを招待します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
ユーザーを招待するプロジェクトを含むアカウントを選択またはマッピングします。
Workspace ID
ユーザーを招待するプロジェクトを含んだワークスペースを選択またはマッピングします。
プロジェクト ID
ユーザーを招待するプロジェクトを選択またはマッピングします。
ユーザー ID
プロジェクトに招待するユーザーを選択またはマッピングします。

プロジェクトのリスト

この検索モジュールは、指定したチームのすべてのプロジェクトを取得します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
プロジェクトを取得するアセットを含んだアカウントを選択またはマッピングします。
Workspace ID
プロジェクトを取得するアセットを含むワークスペースを選択またはマッピングします。
返されるプロジェクトの最大数 ​
プロジェクトの最大数を入力またはマッピング 各シナリオ実行サイクル中にモジュールを返す必要があります。

株式

共有リンクへのアセットの追加

このアクションモジュールは、Frame.io の共有リンクにアセットを追加します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
アセットを追加する共有リンクを含むアカウントを選択またはマッピングします。
共有リンク ID
アセットを追加する共有リンクを選択またはマッピングします。
Asset ID
共有リンクに追加するアセットの ID を入力またはマッピングします。

共有リンクの作成

このアクションモジュールは、Frame.io に新しい共有リンクを作成します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
共有リンクを作成するアカウントを選択またはマッピングします。
Workspace ID
共有リンクを作成するワークスペースを選択またはマッピングします。
Project ID
共有リンクを作成するプロジェクトを選択またはマッピングします。
アクセス
このリンクへの公開アクセス権と制限アクセス権のどちらを持つかを選択します。
アセット
共有リンクに追加するアセットごとに、「 項目を追加 をクリックしてアセット ID を入力します。
説明
共有リンクの説明を入力またはマッピングします。
名前
共有リンクの有効期限を入力またはマッピングします。
名前
新しい共有リンクの名前を入力またはマップします。
名前
共有リンクのパスフレーズを入力またはマッピングします。

ワークスペース

ワークスペースの作成

このアクションモジュールは、Frame.io に新しいワークスペースを作成します。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
ワークスペースを作成するアカウントを選択またはマッピングします。
Name
ワークスペースの新しい名前を入力またはマッピングします。

ワークスペースのリスト

このモジュールは、アカウント内のすべてのワークスペースをリストします。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
ワークスペースを取得するアセットを含むアカウントを選択またはマッピングします。
返されるワークスペースの最大数 ​
ワークスペースの最大数を入力またはマッピング 各シナリオ実行サイクル中にモジュールを返す必要があります。

その他

カスタム API 呼び出しの実行

このモジュールでは、カスタム API 呼び出しを実行できます。

Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
URL

https://api.frame.io からの相対パスを入力します。例: /v4/me

メモ:使用可能なエンドポイントの一覧については、Frame.io API リファレンスを参照してください。

Method
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、HTTP リクエストメソッドを参照してください。
Headers

リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。

例: {"Content-type":"application/json"}

Workfront Fusion は、認証ヘッダーを自動的に追加します。

クエリ文字列 ​
リクエストクエリ文字列を入力します。クエリ文字列に含める各パラメーターに対して、Add item をクリックして、フィールドの名前と必要な値を入力します。
Body

標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。

メモ:

if などの条件文を JSON で使用する場合は、条件文を引用符で囲みます。

ウォッチのメタデータ値が更新されました

このトリガーモジュールは、コメントが更新されると、シナリオを開始します。

このモジュールに使用する Webhook を選択するか、Webhook フィールドの横にある「追加」をクリックして、次の情報を入力します。

Webhook name
新しい Webhook の名前を入力します。
Connection
Frame.io への接続を作成する方法については、この記事の Adobe Workfront Fusion への Frame.io の接続を参照してください。
アカウント ID
アカウントを選択するか、更新されたメタデータ値を監視するアカウントの ID をマッピングします。
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3