使用流程服務API將對象啟用至檔案型目的地
匯出不Experience Platform的檔案時,請使用增強型檔案匯出功能來存取增強的自訂功能:
- 其他檔案命名選項。
- 能夠透過改善的對應步驟,在您匯出的檔案內設定自訂檔案標頭。
- 能夠選取匯出檔案的檔案型別。
- 能夠自訂轉存的CSV資料檔案的格式。
以下列出的六個雲端儲存卡支援此功能:
本文說明使用流程服務API將合格設定檔從Adobe Experience Platform匯出至上方連結的其中一個雲端儲存空間位置所需的工作流程。
快速入門 get-started
本指南需要您深入了解下列 Adobe Experience Platform 元件:
- Experience Data Model (XDM) System: Experience Platform用來組織客戶體驗資料的標準化架構。
- Segmentation Service: Adobe Experience Platform Segmentation Service可讓您從Real-Time Customer Profile資料建立對象,並在Adobe Experience Platform中產生對象。
- Sandboxes: Experience Platform提供的虛擬沙箱可將單一Platform執行個體分割成個別的虛擬環境,以利開發及改進數位體驗應用程式。
以下章節提供在Platform中以檔案為基礎的目的地啟用資料所需瞭解的其他資訊。
必要權限 permissions
若要匯出設定檔,您需要 檢視目的地、啟用目的地、檢視設定檔 和 檢視區段 存取控制許可權。 閱讀存取控制總覽或連絡您的產品管理員以取得必要的許可權。
若要匯出 身分,您需要 檢視身分圖表 存取控制許可權。
{width="100" modal="regular"}
讀取範例 API 呼叫 reading-sample-api-calls
本教學課程提供範例API呼叫,示範如何格式化您的請求。 這些包括路徑、必要的標頭和正確格式化的請求承載。 此外,也提供 API 回應中傳回的範例 JSON。 如需檔案中所使用範例API呼叫慣例的詳細資訊,請參閱Experience Platform疑難排解指南中如何讀取範例API呼叫一節。
收集必要和選用標題的值 gather-values-headers
若要呼叫Platform API,您必須先完成Experience Platform驗證教學課程。 完成驗證教學課程會提供所有 Experience Platform API 呼叫中每個必要標頭的值,如下所示:
- 授權:持有人
{ACCESS_TOKEN}
- x-api-key:
{API_KEY}
- x-gw-ims-org-id:
{ORG_ID}
Experience Platform中的資源可以隔離到特定的虛擬沙箱。 在對Platform API的請求中,您可以指定將執行作業的沙箱名稱和ID。 這些是選用引數。
- x-sandbox-name:
{SANDBOX_NAME}
包含裝載(POST
、PUT
、PATCH
)的所有要求都需要額外的媒體型別標頭:
- Content-Type:
application/json
API參考檔案 api-reference-documentation
在本教學課程中,您可以找到所有API作業的隨附參考檔案。 請參閱Adobe Developer網站🔗上的流量服務 — 目的地API檔案。 我們建議您同時使用本教學課程和API參考檔案。
字彙 glossary
如需在此API教學課程中將會遇到的術語說明,請閱讀API參考檔案的字彙表區段。
選取匯出受眾的目的地 select-destination
在開始匯出設定檔的工作流程之前,請先識別您要將對象匯出至的目的地之連線規格和流程規格ID。 請參考下表。
4fce964d-3f37-408f-9778-e597338a21ee
1a0514a6-33d4-4c7f-aff8-594799c47549
6d6b59bf-fb58-4107-9064-4d246c0e5bb2
752d422f-b16f-4f0d-b1c6-26e448e3b388
be2c3209-53bc-47e7-ab25-145db8b873e1
17be2013-2549-41ce-96e7-a70363bec293
10440537-2a7b-4583-ac39-ed38d4b848e8
cd2fc47e-e838-4f38-a581-8fff2f99b63a
c5d93acb-ea8b-4b14-8f53-02138444ae99
585c15c4-6cbf-4126-8f87-e26bff78b657
36965a81-b1c6-401b-99f8-22508f1e6a26
fd36aaa4-bf2b-43fb-9387-43785eeeb799
在本教學課程的後續步驟中,您需要這些ID來建構各種流量服務實體。 您還需要參照連線規格本身的零件來設定特定圖元,以便從「流程服務API」擷取「連線規格」。 請參閱以下範例,擷取表格中所有目的地的連線規格:
要求
accordion | ||
---|---|---|
擷取Amazon S3的connection spec | ||
|
回應
accordion | ||
---|---|---|
Amazon S3 — 連線規格 | ||
|
要求
accordion | ||
---|---|---|
擷取Azure Blob Storage的connection spec | ||
|
回應
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec | ||
|
要求
accordion | ||
---|---|---|
擷取Azure Data Lake Gen 2(ADLS Gen2的connection spec) | ||
|
回應
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec | ||
|
要求
accordion | ||
---|---|---|
擷取Data Landing Zone(DLZ)的connection spec | ||
|
回應
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec | ||
|
要求
accordion | ||
---|---|---|
擷取Google Cloud Storage的connection spec | ||
|
回應
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec | ||
|
要求
accordion | ||
---|---|---|
擷取SFTP的connection spec | ||
|
回應
accordion | ||
---|---|---|
SFTP - Connection spec | ||
|
請依照下列步驟,設定將對象匯出資料流至雲端儲存空間目的地。 對於某些步驟,請求和回應會因不同的雲端儲存空間目的地而異。 在這些情況下,請使用頁面上的索引標籤,擷取您想要連線並匯出受眾的目標的特定請求和回應。 請確定您設定的目的地使用正確的connection spec
和flow spec
。
建立Source連線 create-source-connection
決定要將對象匯出到哪個目的地後,您需要建立來源連線。 來源連線代表與內部Experience Platform設定檔存放區的連線。
要求
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除內嵌註解。
code language-shell |
---|
|
回應
code language-json |
---|
|
成功的回應會傳回新建立的來源連線的識別碼(id
)和etag
。 記下來源連線ID,因為稍後建立資料流時會需要它。
建立基礎連線 create-base-connection
基本連線會將認證安全地儲存到您的目的地。 根據目的地型別,針對該目的地進行驗證所需的認證可能會有所不同。 若要尋找這些驗證引數,請先依照選取匯出受眾的目的地一節所述擷取您想要的目的地connection spec
,然後檢視回應的authSpec
。 請參考下列標籤,以取得所有支援目的地的authSpec
屬性。
accordion | ||
---|---|---|
Amazon S3 - Connection spec顯示auth spec | ||
請注意下方connection spec範例中反白顯示內嵌註解的一行,這些註解提供了在connection spec中尋找驗證引數的位置的其他資訊。
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec顯示auth spec | ||
請注意下方connection spec範例中反白顯示內嵌註解的一行,這些註解提供了在connection spec中尋找驗證引數的位置的其他資訊。
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec顯示auth spec | ||
請注意下方connection spec範例中反白顯示內嵌註解的一行,這些註解提供了在connection spec中尋找驗證引數的位置的其他資訊。
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) - Connection spec顯示auth spec | |||||
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec顯示auth spec | ||
請注意下方connection spec範例中反白顯示內嵌註解的一行,這些註解提供了在connection spec中尋找驗證引數的位置的其他資訊。
|
accordion | |||||
---|---|---|---|---|---|
SFTP - Connection spec顯示auth spec | |||||
請注意下方connection spec範例中反白顯示內嵌註解的一行,這些註解提供了在connection spec中尋找驗證引數的位置的其他資訊。
|
使用驗證規格(亦即回應中的authSpec
)中指定的屬性,您可以使用每個目的地型別特定的必要認證來建立基礎連線,如下列範例所示:
要求
accordion | |||||
---|---|---|---|---|---|
Amazon S3 — 具有存取金鑰和機密金鑰驗證的基礎連線要求 | |||||
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除請求中的內嵌註解。
|
accordion | |||||
---|---|---|---|---|---|
Amazon S3 — 具有假定角色驗證的基礎連線要求 | |||||
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除請求中的內嵌註解。
|
回應
accordion | ||
---|---|---|
Amazon S3基本連線回應 | ||
|
要求
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage — 基底連線要求 | |||||
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除請求中的內嵌註解。
|
回應
accordion | ||
---|---|---|
Azure Blob Storage — 基底連線回應 | ||
|
要求
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) — 基底連線要求 | |||||
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除請求中的內嵌註解。
|
回應
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) — 基底連線回應 | ||
|
要求
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone(DLZ) — 基底連線要求 | |||||
|
回應
accordion | ||
---|---|---|
Data Landing Zone — 基底連線回應 | ||
|
要求
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage — 基底連線要求 | |||||
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除請求中的內嵌註解。
|
回應
accordion | ||
---|---|---|
Google Cloud Storage — 基底連線回應 | ||
|
要求
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
使用密碼的SFTP — 基本連線要求 | |||||||||||||||||||
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除請求中的內嵌註解。
|
accordion | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
使用SSH金鑰的SFTP — 基本連線要求 | |||||||||||||||||||
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除請求中的內嵌註解。
|
回應
accordion | ||
---|---|---|
SFTP — 基本連線回應 | ||
|
新增加密至匯出的檔案
您可以選擇將加密新增至匯出的檔案。 若要這麼做,您需要從encryptionSpecs
新增專案。 請參閱以下請求範例,並將強制引數反白顯示:
code language-json line-numbers data-start-1 data-line-offset-4 h-26-27 |
---|
|
要求
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除內嵌註解。
code language-shell line-numbers data-start-1 data-line-offset-4 h-19 |
---|
|
回應
code language-json |
---|
|
記下回應中的連線ID。 建立目標連線時,下個步驟需要此ID。
建立目標連線 create-target-connection
接下來,您需要建立目標連線。 Target連線會儲存匯出對象的匯出引數。 匯出引數包括匯出位置、檔案格式、壓縮和其他細節。 例如,對於CSV檔案,您可以選取多個匯出選項。 在檔案格式設定頁面中,取得所有支援的CSV匯出選項的詳細資訊。
請參閱目的地connection spec
中提供的targetSpec
屬性,以瞭解每個目的地型別的支援屬性。 請參考下列標籤,以取得所有支援目的地的targetSpec
屬性。
accordion | ||
---|---|---|
Amazon S3 - Connection spec顯示目標連線引數 | ||
請注意下方connection spec範例中有內嵌註解之醒目提示的行,這些註解提供了在連線規格中何處尋找target spec引數的相關額外資訊。 您也可以在下列範例中看到,目標引數是 不,適用於對象匯出目的地。
|
accordion | ||
---|---|---|
Azure Blob Storage - Connection spec顯示目標連線引數 | ||
請注意下方connection spec範例中有內嵌註解之醒目提示的行,這些註解提供了在連線規格中何處尋找target spec引數的相關額外資訊。 您也可以在下列範例中看到,目標引數是 不,適用於對象匯出目的地。
|
accordion | ||
---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Connection spec顯示目標連線引數 | ||
請注意下方connection spec範例中有內嵌註解之醒目提示的行,這些註解提供了在連線規格中何處尋找target spec引數的相關額外資訊。 您也可以在下列範例中看到,目標引數是 不,適用於對象匯出目的地。
|
accordion | ||
---|---|---|
Data Landing Zone(DLZ) - Connection spec顯示目標連線引數 | ||
請注意下方connection spec範例中有內嵌註解之醒目提示的行,這些註解提供了在連線規格中何處尋找target spec引數的相關額外資訊。 您也可以在下列範例中看到,目標引數是 不,適用於對象匯出目的地。
|
accordion | ||
---|---|---|
Google Cloud Storage - Connection spec顯示目標連線引數 | ||
請注意下方connection spec範例中有內嵌註解之醒目提示的行,這些註解提供了在連線規格中何處尋找target spec引數的相關額外資訊。 您也可以在下列範例中看到,目標引數是 不,適用於對象匯出目的地。
|
accordion | ||
---|---|---|
SFTP - Connection spec顯示目標連線引數 | ||
請注意下方connection spec範例中有內嵌註解之醒目提示的行,這些註解提供了在連線規格中何處尋找target spec引數的相關額外資訊。 您也可以在下列範例中看到,目標引數是 不,適用於對象匯出目的地。
|
透過使用上述規格,您可以建構專屬於您所需雲端儲存空間目的地的目標連線要求,如下方標籤所示。
要求
accordion | |||||
---|---|---|---|---|---|
Amazon S3 - Target連線要求 | |||||
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除請求中的內嵌註解。
|
accordion | |||||
---|---|---|---|---|---|
Amazon S3 — 具有CSV選項的目標連線要求 | |||||
|
回應
accordion | ||
---|---|---|
目標連線 — 回應 | ||
|
要求
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage - Target連線要求 | |||||
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除請求中的內嵌註解。
|
accordion | |||||
---|---|---|---|---|---|
Azure Blob Storage — 具有CSV選項的目標連線要求 | |||||
|
回應
accordion | ||
---|---|---|
目標連線 — 回應 | ||
|
要求
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) - Target連線要求 | |||||
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除請求中的內嵌註解。
|
accordion | |||||
---|---|---|---|---|---|
Azure Data Lake Gen 2(ADLS Gen2) — 具有CSV選項的目標連線要求 | |||||
|
回應
accordion | ||
---|---|---|
目標連線 — 回應 | ||
|
要求
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone - Target連線要求 | |||||
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除請求中的內嵌註解。
|
accordion | |||||
---|---|---|---|---|---|
Data Landing Zone — 具有CSV選項的目標連線要求 | |||||
|
回應
accordion | ||
---|---|---|
目標連線 — 回應 | ||
|
要求
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage - Target連線要求 | |||||
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除請求中的內嵌註解。
|
accordion | |||||
---|---|---|---|---|---|
Google Cloud Storage — 具有CSV選項的目標連線要求 | |||||
|
回應
accordion | ||
---|---|---|
目標連線 — 回應 | ||
|
要求
accordion | |||||
---|---|---|---|---|---|
SFTP - Target連線要求 | |||||
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除請求中的內嵌註解。
|
accordion | |||||
---|---|---|---|---|---|
SFTP — 具有CSV選項的Target連線請求 | |||||
|
回應
accordion | ||
---|---|---|
目標連線 — 回應 | ||
|
記下回應中的target connection ID
。 建立資料流以匯出對象時,下個步驟將需要此ID。
成功的回應會傳回新目標來源連線的識別碼(id
)和etag
。 記下目標連線ID,因為稍後建立資料流時會需要它。
建立資料流 create-dataflow
目的地設定的下一個步驟是建立資料流。 資料流將先前建立的實體繫結在一起,並提供設定對象匯出排程的選項。 若要建立資料流,請根據您所需的雲端儲存空間目的地,使用下列裝載,並取代先前步驟中的流程實體ID。 請注意,在此步驟中,您不會將任何與屬性或身分對應相關的資訊新增至資料流。 這將在下一個步驟中進行。
要求
accordion | ||
---|---|---|
建立對象匯出資料流至Amazon S3目的地 — 請求 | ||
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除請求中的內嵌註解。
|
回應
accordion | ||
---|---|---|
建立資料流 — 回應 | ||
|
要求
accordion | ||
---|---|---|
建立對象匯出資料流至Azure Blob Storage目的地 — 請求 | ||
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除請求中的內嵌註解。
|
回應
accordion | ||
---|---|---|
建立資料流 — 回應 | ||
|
要求
accordion | ||
---|---|---|
建立對象匯出資料流至Azure Data Lake Gen 2(ADLS Gen2)目的地 — 請求 | ||
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除請求中的內嵌註解。
|
回應
accordion | ||
---|---|---|
建立資料流 — 回應 | ||
|
要求
accordion | ||
---|---|---|
建立對象匯出資料流至Data Landing Zone目的地 — 請求 | ||
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除請求中的內嵌註解。
|
回應
accordion | ||
---|---|---|
建立資料流 — 回應 | ||
|
要求
accordion | ||
---|---|---|
建立對象匯出資料流至Google Cloud Storage目的地 — 請求 | ||
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除請求中的內嵌註解。
|
回應
accordion | ||
---|---|---|
建立資料流 — 回應 | ||
|
要求
accordion | ||
---|---|---|
建立將受眾匯出資料流至SFTP目的地 — 請求 | ||
請注意請求範例中反白顯示內嵌註解的行,這些註解會提供額外資訊。 將請求複製貼上您選擇的終端機時,移除請求中的內嵌註解。
|
回應
accordion | ||
---|---|---|
建立資料流 — 回應 | ||
|
記下回應中的資料流ID。 此ID在後續步驟中是必要的。
將對象新增至匯出
在此步驟中,您也可以選取要匯出至目的地的對象。 如需此步驟以及將對象新增至資料流的要求格式的詳細資訊,請檢視API參考檔案的更新目的地資料流區段中的範例。
設定屬性和身分對應 attribute-and-identity-mapping
建立資料流後,您需要為要匯出的屬性和身分設定對應。 此程式包含下列三個步驟:
- 建立輸入結構描述
- 建立輸出結構描述
- 設定對應集以連線建立的方案
例如,若要取得UI中顯示的以下對應,您需要完成以上列出的三個步驟,並在下一個標題中詳細說明。
的範例
建立輸入結構描述
若要建立輸入結構描述,您必須先擷取您的聯合結構描述以及可匯出到目的地的身分。 這是屬性和身分的結構描述,您可以選取它作為來源對應。
檢視以下要求與回應範例,以擷取屬性和身分。
要求取得屬性
code language-shell |
---|
|
回應
以下回應已縮短,以求簡潔。
code language-json |
---|
|
要求取得身分
code language-shell |
---|
|
回應
回應會傳回您在建立輸入結構描述時可使用的身分。 請注意,此回應會傳回您在Experience Platform中設定的standard和custom身分名稱空間。
code language-json |
---|
|
接下來,您需要複製上方的回應,並使用它建立您的輸入結構描述。 您可以複製上方回應中的整個JSON回應,並將其置於下方指示的jsonSchema
物件中。
要求建立輸入結構描述
code language-shell |
---|
|
回應
code language-json |
---|
|
回應中的ID代表您已建立的輸入結構描述的唯一識別碼。 從回應中複製ID,因為您將在稍後步驟中重複使用它。
建立輸出結構描述
接下來,您必須為匯出設定輸出結構描述。 首先,您需要尋找並檢查現有的合作夥伴結構描述。
要求
請注意,下列範例將connection spec ID
用於Amazon S3。 請以目的地專屬的連線規格ID取代此值。
code language-shell |
---|
|
包含範例結構描述的回應
Inspect會回應您執行上述呼叫時所取得的回應。 您必須深入檢視回應以尋找物件targetSpec.attributes.partnerSchema.jsonSchema
code language-json |
---|
|
接下來,您需要建立輸出結構描述。 複製您上方的JSON回應,並將其貼到下方的jsonSchema
物件中。
要求
code language-shell |
---|
|
回應
code language-json |
---|
|
回應中的ID代表您已建立的輸入結構描述的唯一識別碼。 從回應中複製ID,因為您將在稍後步驟中重複使用它。
建立對應集 create-mapping-set
接下來,使用資料準備API,使用輸入結構描述ID、輸出結構描述ID和所需的欄位對應來建立對應集。
要求
note important |
---|
IMPORTANT |
|
code language-shell line-numbers data-start-1 data-line-offset-4 h-16-38 |
---|
|
回應
code language-json |
---|
|
記下對應集的ID,因為您會在使用對應集ID更新現有資料流的下一個步驟中需要它。
接下來,取得您要更新之資料流的ID。
如需擷取資料流識別碼的資訊,請參閱擷取目的地資料流的詳細資料。
最後,您需要PATCH
具有您剛建立之對應集資訊的資料流。
要求
code language-shell |
---|
|
回應
來自流程服務API的回應會傳回已更新資料流的ID。
code language-json |
---|
|
進行其他資料流更新 other-dataflow-updates
若要對您的資料流進行任何更新,請使用PATCH
作業。 例如,您可以將行銷動作新增至資料流。 或者,您可以更新資料流,以選取欄位作為強制索引鍵或重複資料刪除索引鍵。
新增行銷動作 add-marketing-action
若要新增行銷動作,請參閱以下的請求和回應範例。
PATCH
請求時需要If-Match
標頭。 此標頭的值是您要更新之資料流的唯一版本。 每次成功更新資料流、目標連線等流程實體時,etag值都會隨之更新。https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
端點執行GET要求,其中{ID}
是您要更新的資料流ID。PATCH
請求時,請務必將If-Match
標頭的值括在雙引號中,如下例所示。要求
code language-shell |
---|
|
回應
成功的回應會傳回回應代碼200
,以及更新資料流和更新eTag的ID。
code language-json |
---|
|
新增必要索引鍵 add-mandatory-key
若要新增必要索引鍵,請參閱以下的要求與回應範例。
PATCH
請求時需要If-Match
標頭。 此標頭的值是您要更新之資料流的唯一版本。 每次成功更新資料流、目標連線等流程實體時,etag值都會隨之更新。https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
端點執行GET要求,其中{ID}
是您要更新的資料流ID。PATCH
請求時,請務必將If-Match
標頭的值括在雙引號中,如下例所示。要求
code language-shell |
---|
|
code language-shell |
---|
|
回應
code language-json |
---|
|
新增重複資料刪除索引鍵 add-deduplication-key
若要新增重複資料刪除索引鍵,請參閱以下的請求和回應範例
PATCH
請求時需要If-Match
標頭。 此標頭的值是您要更新之資料流的唯一版本。 每次成功更新資料流、目標連線等流程實體時,etag值都會隨之更新。https://platform.adobe.io/data/foundation/flowservice/flows/{ID}
端點執行GET要求,其中{ID}
是您要更新的資料流ID。PATCH
請求時,請務必將If-Match
標頭的值括在雙引號中,如下例所示。要求
code language-shell |
---|
|
code language-shell |
---|
|
回應
code language-json |
---|
|
驗證資料流(取得資料流執行) get-dataflow-runs
若要檢查資料流的執行,請使用資料流執行API:
要求
code language-shell |
---|
|
回應
code language-json |
---|
|
您可以在API參考檔案中找到有關資料流執行API🔗傳回的各種引數的資訊。
API錯誤處理 api-error-handling
本教學課程中的API端點會遵循一般Experience PlatformAPI錯誤訊息原則。 如需解譯錯誤回應的詳細資訊,請參閱Platform疑難排解指南中的API狀態碼和要求標頭錯誤。
後續步驟 next-steps
依照本教學課程中的指示,您已成功將Platform連線至其中一個慣用的雲端儲存空間目的地,並設定資料流至個別目的地以匯出對象。 如需詳細資訊,請參閱下列頁面,例如如何使用流量服務API編輯現有資料流: