Experience Platform に関する FAQ とトラブルシューティングガイド

最終更新日： 2025年4月4日

作成対象：

  • 開発者

このドキュメントでは、Adobe Experience Platform に関するよくある質問への回答と、Experience Platform API で発生する可能性がある一般的なエラーの高度なトラブルシューティングガイドを提供します。個々の Experience Platform サービスのトラブルシューティングガイドについては、以下のサービストラブルシューティングディレクトリを参照してください。

FAQ

次に、Adobe Experience Platform に関するよくある質問に対する回答をリストします。

Experience Platform API とは何ですか？

Experience Platform では、HTTP リクエストを使用して Experience Platform リソースにアクセスするために複数の RESTful API が使用されます。これらのサービス API は、それぞれ複数のエンドポイントを公開し、リスト（GET）、ルックアップ（GET）、編集（PUT または PATCH）および削除（DELETE）リソースに対する操作を実行できます。各サービスで使用できる特定のエンドポイントと操作について詳しくは、Adobe I/O の API リファレンスドキュメントを参照してください。

API リクエストの形式を設定する方法を教えてください。

リクエストの形式は、使用する Experience Platform API によって異なります。API 呼び出しの構造を学ぶ最善の方法は、使用している特定の Experience Platform サービスのドキュメントに記載されている例に従うことです。

API リクエストの形式について詳しくは、『Experience Platform API 入門ガイド』の API 呼び出しのサンプルの読み取り の節を参照しください。

組織とは何ですか？

組織は、アドビにおいて顧客を表現したものです。ライセンスを取得したアドビのソリューションは、この顧客組織に統合されます。組織が Experience Platform の権利を付与されると、開発者にアクセス権を割り当てることができます。組織 ID（x-gw-ims-org-id）は、API 呼び出しの実行対象となる組織を表しているので、すべての API リクエストのヘッダーとして必要です。この ID は、Adobe Developer Console で確認できます。「統合」タブで、特定の統合の「概要」セクションに移動すると「クライアント資格情報」の下に ID が表示されます。Experience Platform への認証方法の詳しい手順については、認証に関するチュートリアルを参照してください。

API キーはどこで入手できますか？

API キーは、すべての API リクエストのヘッダーとして必要です。これは、Adobe Developer Console から入手できます。コンソールの「統合」タブで、特定の統合の「概要」セクションに移動すると、「クライアント資格情報」の下にキーが表示されます。Experience Platform への認証方法の詳しい手順については、認証に関するチュートリアルを参照してください。

アクセストークンはどのように入手できますか？

アクセストークンは、すべての API 呼び出しの Authorization ヘッダーに必要です。組織の統合にアクセスできる場合は、CURL コマンドを使用して生成できます。アクセストークンは 24 時間のみ有効で、その後 API を使用し続けるためには新しいトークンを生成する必要があります。アクセストークンの生成について詳しくは、認証に関するチュートリアルを参照してください。

クエリーパラメーターの使用方法

一部の Experience Platform API エンドポイントは、クエリパラメーターを受け取って特定の情報を検索し、応答で返される結果をフィルタリングします。リクエストパスに疑問符（?）記号が付加され、その後に 1 つ以上のクエリーパラメーターが paramName=paramValue 形式で追加されます。1 回の呼び出しで複数のパラメーターを組み合わせる場合、アンパサンド（&）を使用して個々のパラメーターを区切る必要があります。次の例は、複数のクエリーパラメーターを使用するリクエストがドキュメントでどのように表現されているかを示しています。

以下は、一般的に使用されるクエリーパラメーターの例です。

GET /tenant/schemas?orderby=title
GET /datasets?limit=36&start=10
GET /batches?createdAfter=1559775880000&orderBy=desc:created

特定のサービスまたはクエリで使用できるエンドポイントパラメーターの詳細については、サービス固有のドキュメントを参照してください。

PATCH リクエストで更新する JSON フィールドを指定する方法を教えてください。

Experience Platform API の多くの PATCH 操作では、JSON Pointer 文字列を使用して、更新する JSON プロパティを示します。これらは通常、JSON パッチ 形式を使用してリクエストペイロードに含まれます。これらのテクノロジーに必要な構文について詳しくは、API の基本原則ガイドを参照してください。

Postman を使用して Experience Platform API を呼び出すことはできますか？

Postman は、RESTful API への呼び出しを視覚化する便利なツールです。Experience Platform API 入門ガイドには、Postman コレクションを読み込むためのビデオと手順が含まれています。 さらに、各サービスについて Postman コレクションのリストが提供されます。