使用Flow Service API連線Salesforce以Experience Platform
閱讀本指南,瞭解如何使用Flow Service API將您的Salesforce來源帳戶連結至Adobe Experience Platform。
快速入門
本指南需要您深入了解下列 Adobe Experience Platform 元件:
使用平台API
如需如何成功呼叫Platform API的詳細資訊,請參閱Platform API快速入門的指南。
連線Salesforce至Azure上的Experience Platform azure
請閱讀下列步驟,以瞭解如何連線您的Salesforce來源以在Azure上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來源執行個體的網址。 environmentUrl 的格式為https://[domain].my.salesforce.com 。 |
username |
Salesforce使用者帳戶的使用者名稱。 |
password |
Salesforce使用者帳戶的密碼。 |
securityToken |
Salesforce使用者帳戶的安全性權杖。 |
apiVersion |
選用性)您正在使用的Salesforce執行個體的REST API版本。 API版本的值必須使用小數點格式化。 例如,如果您使用API版本52 ,則必須以52.0 的形式輸入值。 如果此欄位留空,則Experience Platform將自動使用最新可用版本。 |
connectionSpec.id |
連線規格會傳回來源的聯結器屬性,包括與建立基礎連線和來源連線相關的驗證規格。 Salesforce的連線規格識別碼為: 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來源執行個體的網址。 environmentUrl 的格式為https://[domain].my.salesforce.com |
clientId |
使用者端ID會與使用者端密碼搭配使用,作為OAuth2驗證的一部分。 使用者端ID和使用者端密碼可讓您的應用程式透過向Salesforce識別您的應用程式,以代表您的帳戶運作。 |
clientSecret |
使用者端密碼會與使用者端ID搭配使用,做為OAuth2驗證的一部分。 使用者端ID和使用者端密碼可讓您的應用程式透過向Salesforce識別您的應用程式,以代表您的帳戶運作。 |
apiVersion |
您正在使用的Salesforce執行個體的REST API版本。 API版本的值必須使用小數點格式化。 例如,如果您使用API版本52 ,則必須以52.0 的形式輸入值。 如果此欄位留空,則Experience Platform將自動使用最新可用版本。 此值是OAuth2使用者端認證驗證的必要專案。 |
connectionSpec.id |
連線規格會傳回來源的聯結器屬性,包括與建立基礎連線和來源連線相關的驗證規格。 Salesforce的連線規格識別碼為: cfc0fee1-7dc0-40ef-b73e-d8b134c436f5 。 |
如需針對Salesforce使用OAuth的詳細資訊,請參閱OAuth授權流程🔗的Salesforce 指南。
在Azure的Experience Platform中為Salesforce建立基底連線
基礎連線會保留您的來源和平台之間的資訊,包括來源的驗證認證、連線的目前狀態,以及您唯一的基本連線ID。 基礎連線ID可讓您從來源內部探索及導覽檔案,並識別您要擷取的特定專案,包括其資料型別和格式的資訊。
若要建立基底連線並連線您的Salesforce帳戶以Experience Platform於Azure,請向/connections
端點發出POST要求,並在要求內文中提供您的Salesforce驗證認證。
API格式
POST /connections
accordion | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
要求 | ||||||||||||||||
下列要求使用基本驗證建立Salesforce的基本連線:
|
accordion | ||
---|---|---|
回應 | ||
成功的回應會傳回您新建立的基本連線及其唯一ID。
|
accordion | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
要求 | ||||||||||||||||
以下要求使用OAuth 2使用者端認證為Salesforce建立基礎連線:
|
accordion | ||
---|---|---|
回應 | ||
成功的回應會傳回您新建立的基本連線及其唯一ID。
|
連線Salesforce以在Amazon Web Services (AWS)上Experience Platform aws
請閱讀下列步驟,以瞭解如何連線您的Salesforce來源以在AWS上Experience Platform。
先決條件
如需有關如何設定您的Salesforce帳戶以便在AWS上連線到Experience Platform的資訊,請閱讀Salesforce 總覽。
在AWS上Experience Platform為Salesforce建立基礎連線
若要建立基礎連線並連線您的Salesforce帳戶以Experience Platform在AWS上,請向/connections
端點發出POST請求並提供您認證的適當值。
API格式
POST /connections
要求
下列要求會為AWS上的Experience Platform中的Salesforce來源建立基底連線。
code language-shell |
---|
|
如需如何擷取您的Salesforce jwtToken
的詳細資訊,請閱讀上的指南如何設定 Salesforce 來源以連線到AWS上的Experience Platform。
回應
成功的回應會傳回您新建立的基本連線及其唯一ID。
code language-json |
---|
|
驗證您的連線狀態
若要驗證您的連線狀態,請向/connections
端點發出GET要求,並提供在建立步驟中產生的基本連線ID。
API格式
GET /connections
要求
下列要求會擷取基底連線識別碼的資訊: 3e908d3f-c390-482b-9f44-43d3d4f2eb82
。
code language-shell |
---|
|
回應
accordion | ||
---|---|---|
選取以檢視回應範例 | ||
下列回應顯示基底連線識別碼的資訊:
|
accordion | ||
---|---|---|
選取以檢視回應範例 | ||
下列回應顯示基底連線識別碼的資訊:
|
後續步驟
依照此教學課程,您已使用Flow Service API建立Salesforce基礎連線。 您可以在下列教學課程中使用此基本連線ID: