Flow Service API を使用した汎用 REST API ベース接続の作成

最終更新日： 2025年4月4日
  • トピック：

作成対象：

  • 開発者
メモ
Generic REST API ソースはベータ版です。ベータ版のコネクタの使用に関して詳しくは、 ソースの概要を参照してください。

ベース接続は、ソースと Adobe Experience Platform 間の認証済み接続を表します。

このチュートリアルでは、Flow Service API を使用して、Generic REST API のベース接続を作成する手順を説明します。

はじめに

このガイドでは、Adobe Experience Platform の次のコンポーネントに関する十分な知識が必要です。

  • ソース:Experience Platformを使用すると、データを様々なソースから取得しながら、Experience Platform サービスを使用して受信データの構造化、ラベル付け、拡張を行うことができます。
  • サンドボックス: Experience Platformには、1 つのExperience Platform インスタンスを別々の仮想環境に分割し、デジタルエクスペリエンスアプリケーションの開発と発展に役立つ仮想サンドボックスが用意されています。

Experience Platform API を正常に呼び出す方法について詳しくは、Experience Platform API の概要を参照してください。

必要な資格情報の収集

Flow Service が Generic REST API に接続するには、選択した認証タイプの有効な資格情報を指定する必要があります。 Generic REST API は、OAuth 2 更新コードと基本認証の両方をサポートしています。 次の表に、サポートされる 2 つの認証タイプの資格情報を示します。

OAuth 2 更新コード

資格情報説明
hostリクエスト先のソースのホスト URL。 この値は必須であり、requestParameterOverride を使用してバイパスすることはできません。
authorizationTestUrl（オプション）認証テスト URL は、ベース接続の作成時に資格情報を検証するために使用されます。指定しない場合、代わりにソース接続の作成時に資格情報が自動的にチェックされます。
clientId（オプション）ユーザーアカウントに関連付けられたクライアント ID。
clientSecret（オプション）ユーザーアカウントに関連付けられたクライアントの秘密鍵。
accessTokenアプリケーションへのアクセスに使用するプライマリ認証情報。 アクセストークンは、ユーザーのデータの特定の側面にアクセスするための、アプリケーションの認証を表します。 この値は必須であり、requestParameterOverride を使用してバイパスすることはできません。
refreshToken（オプション）アクセストークンの有効期限が切れた場合に、新しいアクセストークンの生成に使用されるトークン。
expirationDate（オプション）アクセストークンの有効期限を定義する非表示の値。
accessTokenUrl（任意）アクセストークンの取得に使用する URL エンドポイント。
requestParameterOverride（オプション）上書きする資格情報パラメーターを指定できるプロパティ。
connectionSpec.id接続仕様は、ベース接続とソース接続の作成に関連する認証仕様などの、ソースのコネクタプロパティを返します。Generic REST API の接続仕様 ID は 4e98f16f-87d6-4ef0-bdc6-7a2b0fe76e62 です。