Developer ConsoleとPostmanのセットアップ
このレッスンでは、Adobeデベロッパーコンソールにプロジェクトを設定し、Postmanコレクションをダウンロードして、プラットフォームAPIを使用して開始できるようにします。
このチュートリアルのAPIの演習を完了するには、Postmanアプリをお使いのオペレーティングシステム用にダウンロードしてください。 Experience PlatformAPIを使用するために必要ありませんが、PostmanはAPIワークフローを容易にします。Adobe Experience PlatformはAPI呼び出しの実行や動作の習得に役立つ多数のPostmanコレクションを提供しています。このチュートリアルの残りの部分は、Postmanに関する作業上の知識を前提としています。 援助が必要な場合は、ポストマンのドキュメントを参照してください。
プラットフォームはAPIから構築されます。 すべての主要なタスクに対してインターフェイスオプションも存在しますが、いつかPlatform APIを使用することをお勧めします。 例えば、データを取り込むには、サンドボックス間をアイテムを移動し、ルーチンタスクを自動化するか、UIが構築される前に新しいプラットフォーム機能を使用します。
データ アーキテクチャと データ エンジニアは、このチュートリアル以外でプラットフォームAPIを使用する必要がある場合があります。
必要な権限
権限の設定のレッスンでは、このレッスンを完了するのに必要なすべてのアクセス制御を設定します。具体的には、次のようにします。
- 権限項目サンドボックス>
Luma Tutorial Luma Tutorial Platform製品プロファイルへの開発者ロールのアクセス
Adobe開発者コンソールの設定
-
Luma Tutorial Assetsという名前のローカルマシン上にフォルダーを作成します。 このフォルダは、チュートリアルで使用するファイルの保存に使用されます -
Adobe開発者コンソールを開きます
-
ログインし、正しい組織であることを確認します。
-
クイック開始メニューの「新しいプロジェクトを作成」ボタンをクリックします。
-
新しく作成したプロジェクトで、「プロジェクトへ追加」ボタンをクリックし、「API」を選択します
-
Adobe Experience Platformをクリックしてリストをフィルターします
-
使用可能なAPIのリストで、Experience PlatformAPIを選択し、次へをクリックします。
-
Postmanのような外部システムからの認証には、公開鍵と秘密鍵のペアが必要です。 新しいキーペアを生成するには、オプション1を選択し、キーペアを生成ボタンを押します
-
キーの準備が整ったら、ローカルマシンにキーをダウンロードするように求められる場合があります。
config.zipにパッケージ化されたキーをフォルダーLuma Tutorial Assetsに保存します。 次の練習で必要になります。 -
キーが生成されると、スクリーンショットに示すように公開鍵がプロジェクトに自動的に追加されます。 「次へ」ボタンをクリックします。
-
Luma Tutorial Platform製品プロファイルを選択し、「設定済みAPIを保存」ボタンをクリックします
-
これで、Developer Consoleプロジェクトが作成されました。
-
ページの「試す」セクションで、「Postman用にダウンロード」をクリックし、「サービスアカウント(JWT)」をクリックしてPostman環境jsonファイルをダウンロードします。
service.postman_environment.jsonをLuma Tutorial Assetsフォルダーに保存します。
メモ組織のシステム管理者は、Admin Consoleの製品プロファイルでプロジェクトを「統合」として表示できます。
プロジェクトに番号が割り当てられていることに気付いたかもしれません(例："プロジェクト12":
-
階層リンクでプロジェクト番号をクリックします
-
「プロジェクトを編集」ボタンをクリックします
-
プロジェクトのタイトルを
Luma Tutorial API Projectに変更します(会社の複数の人がこのチュートリアルを受ける場合は、最後に自分の名前を追加します) -
「保存」ボタンをクリックします。
郵便配達員の設定
-
Postmanをダウンロードしてインストール
-
Postmanを開き、ダウンロードしたJSON環境ファイル
service.postman_environment.jsonを読み込みます
-
Postmanで、右上のドロップダウンで環境を選択し、eyeアイコンをクリックして環境変数を表示します。 ACCESS_TOKEN、PRIVATE_KEY、JWT_TOKEN変数は空白であることがわかります。
環境名の更新
Developer Consoleから書き出した環境の名前はランダムに生成されるので、後で実際のプラットフォームの実装を開始する際に環境を混乱させないように、わかりやすい名前を付けておきます
-
環境変数画面が開いたままの状態で、右上の「編集」をクリックします
-
環境名を
Luma Tutorialに更新 -
環境の管理モーダルを編集モードで開いたままにします。次の手順でさらに編集します
秘密鍵追加
次に、Postman環境にPRIVATE_KEY値を追加します。
- ダウンロードした
config.zipファイルを抽出します。このファイルは、前の練習で生成したもので、Developer Console Projectの作成時に作成したものです。 これには、次の2つのファイルが含まれます。private.keycertificate_pub.crt
private.keyファイルをテキストエディターで開き、使用可能なすべてのコンテンツをコピーします。- Postmanの場合、前の練習でまだ開いている環境を管理/モーダルを編集に、初期値列と現在値列のPRIVATE_KEYの前にコピーした値を貼り付けます。.
- 「更新」ボタンをクリックして、PRIVATE_KEYと更新した環境名を保存します。
JWT追加とアクセストークン
Adobeは、Experience PlatformのAPIを調べるのに役立つ豊富なPostmanコレクションのセットを提供します。 これらのコレクションは、GitHubリポジトリAdobe Experience Platformポストマンサンプルにあります。 このレポートは、このチュートリアルを通して何度も使用するので、ブックマークを付けてください。後で、独自の会社にExperience Platformを導入する際に使用します。
最初のコレクションは、AdobeIdentity Managementサービス(IMS)APIと連携します。 JWT_TOKENとACCESS_TOKENをPostman 内から入力する便利な方法で、実稼働以外の使用例に対してサンドボックスでの入力などを意図しています。 また、JWTトークンはAdobe開発者コンソール内で生成できますが、定期的に期限が切れるので、このコレクションを使用して更新すれば、このチュートリアルを完了する際に、Adobe開発者コンソールに再度アクセスする必要はありません。
Adobe I/Oアクセストークン生成ポストマンコレクションREADMEに記載されているように、表記された生成方式は非実稼働での使用に適しています。 ローカル署名では、サードパーティのホストからJavaScriptライブラリが読み込まれ、リモート署名では、所有および操作されるWebサービスがAdobeに秘密鍵を送信します。 Adobeはこの秘密鍵を保存しませんが、プロダクションキーを他のユーザーと共有することは避けてください。
トークンを生成するには：
-
Developer Consoleアクセストークン生成コレクションを
Luma Tutorial Assetsフォルダーにダウンロードします -
コレクションをPostmanにインポート
-
リクエストIMSを選択します。JWT Generate + Auth via User Tokenをクリックし、「Send」をクリックします。
-
JWT_TOKENとACCESS_TOKENは、Postmanの環境変数に自動入力されます。
サ追加ンドボックス名とテナントID
SANDBOX_NAME変数とTENANT_ID変数とCONTAINER_ID変数は、Adobe開発者コンソールからの環境エクスポートでは提供されないので、手動で追加します。
-
Postmanで、環境変数モーダルを開きます。
-
環境名の右にある編集リンクをクリックします
-
追加新しい変数フィールドに、
SANDBOX_NAMEと入力します。 -
両方の値フィールドに、前のレッスンでSandboxに与えた名前
luma-tutorialと入力します。 サンドボックスに別の名前( luma-tutorial-ignatiusjreilly、必ずこの値を使用してください。 -
追加新しい変数フィールドに、
TENANT_IDと入力します。 -
Webブラウザーに切り替え、Experience Platformのインターフェイスに移動し、@記号の後に URLの一部を抽出して、会社のテナントIDを検索します。 例えば、私のテナントIDは
techmarketingdemosですが、あなたのテナントIDは何か別のものになります。
-
この値をコピーしてPostman環境の管理画面に戻ります
-
テナントIDを両方の値フィールドに貼り付けます
-
追加新しい変数フィールドに、
CONTAINER_IDと入力します。 -
両方の値フィールドに
globalを入力メモCONTAINER_IDは、このチュートリアルの間に値を何度か変更するフィールドです。globalを使用すると、APIはプラットフォームアカウント内のAdobe提供の要素とやり取りします。tenantを使用すると、APIは独自のカスタム要素とやり取りします。 -
「更新」ボタンをクリックして、変数を保存します
「環境の管理」モーダルを閉じることができるようになりました。
プラットフォームAPI呼び出しの作成
次に、API呼び出しを行って、すべてが正しく設定されたことを確認します。
GithubのPostmanexperience-platform-postman-samples🔗にあるExperience Platformの別のグループを開きます。 このページには様々なプラットフォーム機能に関連した多数のコレクションがあります。
このチュートリアルで必要となるコレクションをダウンロードします。 このGithubリポジトリは、会社に対するプラットフォームの実装を開始する際に、このチュートリアルの終了後に非常に役立つものとなるので、ブックマークを設定することを強くお勧めします。
では、最初のAPI呼び出しを行います。
- スキーマレジストリAPIコレクションを
Luma Tutorial Assetsフォルダーにダウンロードします - Postmanにインポート
- スキーマレジストリAPI >クラス>指定したコンテナのすべてのクラスをリストを開きます。
- 「Params」タブと「Headers」タブを見て、前に入力した環境変数の一部がこれらに含まれていることを確認してください。
- ヘッダー/値を受け入れるフィールドをクリックし、
application/vnd.adobe.xed-id+jsonに変更します。 スキーマレジストリAPIでは、応答に異なる形式を提供する指定されたのいずれかを受け入れる必要があります。 - 「Send」ボタンをクリックして、最初のプラットフォームAPI呼び出しを行います。
以下の図のように、サンドボックス内の標準XDMクラスのリストを含む200 OKの応答が成功したことを願います。
呼び出しが成功しなかった場合は、API呼び出しのエラー応答の詳細を使用してデバッグを行い、上記の手順を確認します。 問題が解決しない場合は、コミュニティフォーラムでヘルプを要求するか、このページの右側のリンクを使用して「問題を記録」してください。
その他のリソース
プラットフォームの権限、サンドボックス、Postmanの設定が完了したら、スキーマ🔗のモデルデータを使用する準備が整いました。
adobe.com 上のリソース
アドビアカウント
