Flow Service API を使用した Salesforce のExperience Platformへの接続
Flow Service API を使用して Salesforce ソースアカウントをAdobe Experience Platformに接続する方法については、このガイドを参照してください。
はじめに
このガイドでは、Adobe Experience Platform の次のコンポーネントに関する十分な知識が必要です。
Platform API の使用
Platform API を正常に呼び出す方法について詳しくは、Platform API の概要のガイドを参照してください。
Salesforce を Azure のExperience Platformに接続する azure
Azure で Salesforce ソースをExperience Platformに接続する方法については、以下の手順を参照してください。
必要な資格情報の収集
Salesforce ソースは、基本認証と OAuth2 クライアント資格情報をサポートしています。
基本認証を使用して Salesforce アカウントを Flow Service に接続するには、次の資格情報の値を指定します。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 | |
---|---|
資格情報 | 説明 |
environmentUrl |
Salesforce ソースインスタンスの URL。 environmentUrl の形式は https://[domain].my.salesforce.com です。 |
username |
Salesforce ユーザーアカウントのユーザー名。 |
password |
Salesforce ユーザーアカウントのパスワード。 |
securityToken |
Salesforce ユーザーアカウントのセキュリティ トークン。 |
apiVersion |
(オプション)使用している Salesforce インスタンスの REST API バージョン。 API バージョンの値は、10 進数でフォーマットする必要があります。 例えば、API バージョン 52 を使用している場合、値を 52.0 と入力する必要があります。 このフィールドを空白のままにすると、Experience Platformでは使用可能な最新のバージョンが自動的に使用されます。 |
connectionSpec.id |
接続仕様は、ベース接続とソース接続の作成に関連する認証仕様などの、ソースのコネクタプロパティを返します。Salesforce の接続仕様 ID は cfc0fee1-7dc0-40ef-b73e-d8b134c436f5 です。 |
基本について詳しくは、 このSalesforceのドキュメントを参照してください。
OAuth 2 クライアント資格情報を使用して Salesforce アカウントを Flow Service に接続するには、次の資格情報の値を指定します。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
---|---|
資格情報 | 説明 |
environmentUrl |
Salesforce ソースインスタンスの URL。 environmentUrl の形式は https://[domain].my.salesforce.com です |
clientId |
クライアント ID は、OAuth2 認証の一部として、クライアント秘密鍵と並行して使用されます。 クライアント ID とクライアント秘密鍵を一緒に使用すると、Salesforce ーザー先のアプリケーションを識別することにより、お客様のアカウントに代わってアプリケーションが動作することができます。 |
clientSecret |
クライアントの秘密鍵は、クライアント ID と並行して、OAuth2 認証の一部として使用されます。 クライアント ID とクライアント秘密鍵を一緒に使用すると、Salesforce ーザー先のアプリケーションを識別することにより、お客様のアカウントに代わってアプリケーションが動作することができます。 |
apiVersion |
使用している Salesforce インスタンスの REST API バージョン。 API バージョンの値は、10 進数でフォーマットする必要があります。 例えば、API バージョン 52 を使用している場合、値を 52.0 と入力する必要があります。 このフィールドを空白のままにすると、Experience Platformでは使用可能な最新のバージョンが自動的に使用されます。 この値は、OAuth2 クライアント資格情報認証に必須です。 |
connectionSpec.id |
接続仕様は、ベース接続とソース接続の作成に関連する認証仕様などの、ソースのコネクタプロパティを返します。Salesforce の接続仕様 ID は cfc0fee1-7dc0-40ef-b73e-d8b134c436f5 です。 |
Salesforce に対する OAuth の使用について詳しくは、Salesforce OAuth 認証フローのガイドを参照してください。
Azure のExperience Platformに Salesforce のベース接続を作成する
ベース接続は、ソースと Platform 間の情報(ソースの認証資格情報、現在の接続状態、固有のベース接続 ID など)を保持します。ベース接続 ID により、ソース内からファイルを参照および移動し、データタイプやフォーマットに関する情報を含む、取り込みたい特定の項目を識別することができます。
ベース接続を作成し、Salesforce アカウントを Azure のExperience Platformに接続するには、/connections
エンドポイントに対してPOSTリクエストを実行し、リクエスト本文に Salesforce 認証資格情報を指定します。
API 形式
POST /connections
accordion | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
リクエスト | ||||||||||||||||
次のリクエストは、基本認証を使用して Salesforce のベース接続を作成します。
|
accordion | ||
---|---|---|
応答 | ||
正常な応答では、新しく作成したベース接続と、一意の ID が返されます。
|
accordion | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
リクエスト | ||||||||||||||||
次のリクエストは、OAuth 2 クライアント資格情報を使用して、Salesforce のベース接続を作成します。
|
accordion | ||
---|---|---|
応答 | ||
正常な応答では、新しく作成したベース接続と、一意の ID が返されます。
|
Salesforce をAmazon Web ServicesのExperience Platform(AWS)に接続する aws
Salesforce ソースをAWS上のExperience Platformに接続する方法については、以下の手順を参照してください。
前提条件
AWSでExperience Platformに接続できるように Salesforce アカウントを設定する方法については、Salesforce 概要を参照してください。
AWSで Salesforce on Experience Platformのベース接続を作成する
ベース接続を作成し、Salesforce アカウントをAWS上のExperience Platformに接続するには、/connections
エンドポイントに対してPOSTリクエストを実行し、資格情報の適切な値を指定します。
API 形式
POST /connections
リクエスト
次のリクエストは、AWSのExperience Platformに Salesforce ソースのベース接続を作成します。
code language-shell |
---|
|
Salesforce jwtToken
の取得方法について詳しくは、AWSでExperience Platformに接続するソースの設定方法に関するガイドを参 Salesforce してください。
応答
正常な応答では、新しく作成したベース接続と、一意の ID が返されます。
code language-json |
---|
|
接続ステータスの確認
接続ステータスを確認するには、/connections
エンドポイントに対してGETリクエストを行い、作成手順で生成されたベース接続 ID を指定します。
API 形式
GET /connections
リクエスト
次のリクエストは、ベース接続 ID 3e908d3f-c390-482b-9f44-43d3d4f2eb82
の情報を取得します。
code language-shell |
---|
|
応答
accordion | ||
---|---|---|
選択すると応答の例が表示されます | ||
次の応答では、
|
accordion | ||
---|---|---|
選択すると応答の例が表示されます | ||
次の応答では、
|
次の手順
このチュートリアルでは、Flow Service API を使用して Salesforce ベース接続を作成しました。このベース接続 ID は、次のチュートリアルで使用できます。