Platform FAQとトラブルシューティングガイド

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

FAQ

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

Experience Platform APIとは

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

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

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

APIリクエストの形式設定について詳しくは、Platform API入門ガイドサンプルAPI呼び出しのセクションを参照してください。

IMS 組織とは何ですか。

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

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

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

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

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

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

一部の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 フィールドを指定する方法を教えてください。

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

Postmanを使ってPlatform APIを呼び出せますか？

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

Platformの必要システム構成は何ですか？

UI と API のどちらを使用しているかによって、次の必要システム構成が適用されます。

UI ベースの操作の場合：

• 最新の標準的な Web ブラウザー。Chromeの最新バージョンを推奨しますが、Firefox、Internet Explorer、Safariの最新および以前のメジャーリリースもサポートされています。
  • 新しいメジャーバージョンがリリースされるたびに、最新バージョンをサポートするPlatform開始が削除され、3番目に新しいバージョンのサポートは削除されます。
• すべてのブラウザーで、Cookie と JavaScript が有効になっている必要があります。

API および開発者のインタラクションの場合：

• REST、ストリーミング、Webhook 統合を開発する開発環境。

エラーとトラブルシューティング

以下は、Experience Platformサービスを使用する際に発生する可能性があるエラーのリストです。 個々のPlatformサービスのトラブルシューティングガイドについては、下のサービストラブルシューティングディレクトリを参照してください。

API ステータスコード

Experience Platform APIでは、次のステータスコードが検出される場合があります。 それぞれに様々な原因があり、本項で述べる説明は概して一般的なものです。個々のPlatformサービスの特定のエラーに関する詳細は、下のサービストラブルシューティングディレクトリを参照してください。

リクエストヘッダーエラー

Platform内のすべてのAPI呼び出しには、特定のリクエストヘッダーが必要です。 個々のサービスに必要なヘッダーを確認するには、 API リファレンスのドキュメントを参照してください。必要な認証ヘッダーの値を確認するには、認証に関するチュートリアルを参照してください。API 呼び出しをおこなう際に、これらのヘッダーのいずれかが見つからないか無効な場合は、次のエラーが発生する可能性があります。

OAuth token is missing

{
    "error_code": "403010",
    "message": "Oauth token is missing."
}

このエラーメッセージは、API リクエストに Authorization ヘッダーがない場合に表示されます。再試行する前に、Authorization ヘッダーが有効なアクセストークンに含まれていることを確認してください。

OAuth token is not valid

{
    "error_code": "401013",
    "message": "Oauth token is not valid"
}

このエラーメッセージは、Authorization ヘッダーに指定されたアクセストークンが無効な場合に表示されます。トークンが正しく入力されていることを確認するか、Adobe I/O コンソールで新しいトークンを生成します。

API key is required

{
    "error_code": "403000",
    "message": "Api Key is required"
}

このエラーメッセージは、API リクエストに API キーヘッダー（x-api-key）がない場合に表示されます。再試行する前に、ヘッダーが有効な API キーに含まれていることを確認してください。

API key is invalid

{
    "error_code": "403003",
    "message": "Api Key is invalid"
}

このエラーメッセージは、指定された API キーヘッダー（x-api-key）の値が無効な場合に表示されます。再試行する前に、キーが正しく入力されていることを確認してください。API キーがわからない場合は、Adobe I/O コンソールで確認できます。「統合」タブで 、特定の統合の「概要」セクションに移動すると、「クライアント資格情報」の下に API キーが表示されます。

Missing header

{
    "error_code": "400003",
    "message": "Missing header"
}

このエラーメッセージは、IMS 組織ヘッダー（x-gw-ims-org-id）が API リクエストに存在しない場合に表示されます。再試行する前に、IMS 組織の ID を含むヘッダーが含まれていることを確認してください。

Profile is not valid

{
    "error_code": "403025",
    "message": "Profile is not valid"
}

このエラーメッセージは、ユーザーまたは Adobe I/O 統合（🔗 ヘッダーのAuthorizationアクセストークンExperience Platformによって識別）が、x-gw-ims-org-id ヘッダーで提供された IMS 組織に対して API を呼び出す権利がない場合に表示されます。再試行する前に、ヘッダーに IMS 組織の正しい ID が指定されていることを確認してください。組織 ID が不明な場合は、Adobe I/O コンソールで確認できます。「統合」タブで、特定の統合の「概要」セクションに移動すると、「クライアント資格情報」の下に ID が表示されます。

Valid content-type not specified

{
    "type": "/placeholder/type/uri",
    "status": 400,
    "title": "BadRequestError",
    "detail": "A valid content-type must be specified"
}

このエラーメッセージは、POST、PUT、PATCH リクエストの Content-Type ヘッダーが無効か、見つからない場合に表示されます。ヘッダーがリクエストに含まれ、その値が application/json であることを確認します。

ユーザー領域が見つかりません

{
    "error_code": "403027",
    "message": "User region is missing"
}

このエラーメッセージは、アカウント（指定した認証資格情報で表される）がExperience Platform用の製品プロファイルに関連付けられていない場合に表示されます。 プラットフォームAPI認証チュートリアルのアクセス資格情報の生成の手順に従って、アカウントにプラットフォームを追加し、それに応じて認証資格情報を更新します。

サービストラブルシューティングディレクトリ

以下は、Experience Platform APIのトラブルシューティングガイドとAPIリファレンスドキュメントのリストです。 各トラブルシューティングガイドは、個々のPlatformサービスに固有の問題に関するよくある質問と解決方法に対する回答を提供します。 API リファレンスドキュメントは、各サービスで使用可能なすべてのエンドポイントの包括的なガイドを提供し、受け取る可能性のあるリクエストの本文、応答、エラーコードのサンプルを示します。