このレッスンでは、Adobe Developer Console でプロジェクトを設定し、ダウンロードします Postman コレクションを作成して、Platform API の使用を開始できるようにします。
このチュートリアルの API の演習を完了するには、 お使いのオペレーティングシステム用のPostmanアプリをダウンロードします。 Experience PlatformAPI を使用するためには必要ありませんが、Postmanでは API ワークフローが容易になります。Adobe Experience Platformでは、API 呼び出しの実行とその動作方法の学習に役立つ、数十のPostmanコレクションが提供されています。 このチュートリアルの残りの部分では、Postmanの操作に関する知識を前提としています。 不明な点は、 Postmanドキュメント.
Platform は、API を使用して最初に構築されます。 すべての主要タスクに対してインターフェイスオプションも存在しますが、ある時点で Platform API を使用する必要が生じる場合があります。 例えば、データを取り込むには、サンドボックス間で項目を移動したり、ルーチンタスクを自動化したり、ユーザーインターフェイスが構築される前に新しい Platform 機能を使用したりします。
データアーキテクト および データエンジニア このチュートリアル以外で、Platform API を使用する必要が生じる場合があります。
内 権限の設定 レッスンでは、このレッスンを完了するために必要なすべてのアクセス制御を設定します。
Adobe Developerコンソールは、AdobeAPI および SDK へのアクセス、ほぼリアルタイムのイベントのリッスン、Runtime での関数の実行、App Builder アプリのビルドをおこなう開発者の宛先です。 この変数を使用してExperience PlatformAPI にアクセスします。 詳しくは、 Adobe Developer Console ドキュメント
ローカルマシン上に、という名前のフォルダーを作成します。 Luma Tutorial Assets
」を参照してください。
を開きます。 Adobe Developer Console
ログインし、正しい組織に属していることを確認します。
選択 新規プロジェクトを作成 in クイックスタート メニュー
新しく作成されたプロジェクトで、 プロジェクトに追加 ボタンをクリックし、 API
選択してリストをフィルター Adobe Experience Platform
使用可能な API のリストで、 Experience PlatformAPI を選択し、 次へ.
のような外部システムからの認証用 Postmanの場合、公開鍵と秘密鍵のペアが必要です。 新しいキーペアを生成するには、「 」を選択します。 オプション 1 をクリックし、 キーペアを生成 ボタン
キーの準備が整ったら、ローカルマシンにキーをダウンロードするように求められる場合があります。 にパッケージ化されたキーを保存します。 config.zip
フォルダーに Luma Tutorial Assets
. 次の演習では、これらが必要になります。
キーが生成されると、スクリーンショットに示すように、公開鍵がプロジェクトに自動的に追加されます。 を選択します。 次へ 」ボタンをクリックします。
を選択します。 Luma Tutorial Platform
製品プロファイルを選択し、 設定済み API を保存 ボタン
これで、開発者コンソールプロジェクトが作成されました。
内 試す 「 」セクションで、「 」を選択します。 Postman用のダウンロード 次に、 サービスアカウント (JWT) をダウンロードするには Postman 環境 json ファイル。 保存する service.postman_environment.json
の Luma Tutorial Assets
フォルダー。
組織のシステム管理者は、プロジェクトをAdmin Consoleの製品プロファイルで「API 資格情報」として表示できます
プロジェクトに番号が割り当てられていることに気付いたかもしれません(例:「Project 12」)。
パンくずリストでプロジェクト番号を選択
を選択します。 プロジェクトを編集 ボタン
を プロジェクトタイトル から Luma Tutorial API Project
(会社の複数の担当者がこのチュートリアルを受け取る場合は、名前を末尾に追加します)
を選択します。 保存 ボタン
Postmanインターフェイスは定期的に更新されます。 このチュートリアルのスクリーンショットは、Postman v9.0.5 for Macで撮影したものですが、インターフェイスオプションが変更された可能性があります。
ダウンロードとインストール Postman
開く Postman ダウンロードした json 環境ファイルをインポートします。 service.postman_environment.json
In Postman、ドロップダウンで環境を選択します
を選択します。 目 アイコンをクリックして環境変数を表示します。
開発者コンソールから書き出された環境の名前はランダムに生成されるので、説明的な名前を付けてください。そのため、実際の Platform 実装で作業を開始する際に、後で環境を混乱させないようにします。
環境変数画面が開いたまま、「 」を選択します。 編集 右上に
を更新します。 環境名 から Luma Tutorial
終了 環境の管理 次の手順でさらに編集するので、編集モードでモーダルを開きます。
次に、 PRIVATE_KEY 値をPostman環境に追加します
ダウンロードした config.zip
ファイルを作成します。 この zip には次の 2 つのファイルが含まれます。
private.key
certificate_pub.crt
を開きます。 private.key
ファイルを編集し、コンテンツをコピーします。
Postmanで、 環境の管理 > 編集 最後の演習から開いたままのモーダルをコピーし、 PRIVATE_KEY 内 初期値 および 現在の値 列。
選択 保存
Adobeは、 Postman コレクションを参照してください。Experience Platformの API を調べるのに役立ちます。 これらのコレクションは、 Adobe Experience Platform Postmanのサンプル GitHub リポジトリ. このチュートリアル全体でこのを何度も使用するので、後で独自の会社にExperience Platformを実装する際には、このリポジトリをブックマークする必要があります。
最初のコレクションはAdobeIdentity Managementサービス (IMS)API と連携します。 これは、Postman内から JWT_TOKEN と ACCESS_TOKEN を設定する便利な方法です 実稼動以外の使用例向け 例えば、サンドボックスでこのチュートリアルを完了する場合などです。 または、Adobe Developerコンソール内で JWT トークンを生成できます。 ただし、このコレクションは定期的に期限切れになるので、このチュートリアルを完了する際に、Adobe Developerコンソールに再度アクセスしなくても、コレクションを使用して更新できます。
詳しくは、 AdobeIdentity Management Service API の READMEの場合、指定された生成方法は非実稼動での使用に適しています。 ローカル署名は、サードパーティのホストから JavaScript ライブラリを読み込み、リモート署名は秘密鍵をAdobeが所有し、操作する Web サービスに送信します。 Adobeはこの秘密鍵を保存しませんが、実稼働鍵は誰とも共有しないでください。
トークンを生成するには:
をダウンロードします。 開発者コンソールのアクセストークン生成コレクション を Luma Tutorial Assets
フォルダー
コレクションの読み込み先 Postman
リクエストを選択 IMS:JWT 生成+ユーザートークンを介した認証 を選択し、 送信
この JWT_TOKEN および ACCESS_TOKEN の環境変数で自動入力 Postman.
この SANDBOX_NAME
および TENANT_ID
および CONTAINER_ID
変数は、Adobe Developer Console の書き出しには含まれないので、手動で追加します。
In Postman、 環境変数
を選択します。 編集 環境名の右にリンク
内 新しい変数フィールドを追加を入力して、 SANDBOX_NAME
両方の値フィールドに、 luma-tutorial
:前のレッスンでサンドボックスに付けた名前。 サンドボックスに別の名前(例:luma-tutorial-ignatiusjreilly)を使用した場合は、必ずその値を使用してください。
内 新しい変数フィールドを追加を入力して、 TENANT_ID
Web ブラウザーに切り替え、Experience Platformのインターフェイスに移動して URL の一部を抽出し、会社のテナント ID を検索します @記号の後. 例えば、テナント ID がの場合、 techmarketingdemos
でも、君のは違う。
この値をコピーして、 Postman 環境を管理画面
テナント ID を両方の値フィールドに貼り付けます
内 新しい変数フィールドを追加を入力して、 CONTAINER_ID
入力 global
両方の値フィールド
CONTAINER_ID
は、チュートリアルの間に値が複数回変更されるフィールドです。 条件 global
が使用されている場合、API は Platform アカウント内でAdobeが指定した要素とやり取りします。 条件 tenant
が使用されている場合、API は独自のカスタム要素とやり取りします。
選択 保存
次に、Platform API 呼び出しを作成して、すべてが正しく設定されていることを確認します。
を開きます。 Experience Platform Postman GitHub のコレクション. 様々な Platform API に対し、このページには多数のコレクションがあります。 私はそれをブックマークすることを強くお勧めします。
次に、最初の API 呼び出しを作成します。
Luma Tutorial Assets
フォルダーapplication/vnd.adobe.xed-id+json
. スキーマレジストリ API では、次のいずれかが必要です 指定された Accept ヘッダー値 応答で異なる形式を提供するうまくいけば 200 OK
次の図に示すように、サンドボックス内で使用可能な標準 XDM クラスのリストを含む応答。
呼び出しが成功しなかった場合は、API 呼び出しのエラー応答の詳細を使用してデバッグに時間をかけ、上記の手順を確認します。 問題が発生した場合は、 コミュニティフォーラム または、このページの右側にあるリンクを使用して「問題をログに記録」します。
Platform の権限、サンドボックス、 Postman を設定し、 スキーマ内のモデルデータ!