使用流程服務API刪除目的地帳戶

上次更新: 2023-05-25
  • 建立對象:
  • Developer
    User
    Admin
    Leader

Destinations 是預先建立的與目標平台的整合,可無縫啟用Adobe Experience Platform的資料。 您可以使用目的地,針對跨頻道行銷活動、電子郵件行銷活動、目標定位廣告和許多其他使用案例,啟用已知和未知的資料。

在啟用資料之前,您必須先設定目的地帳戶,以連線至目的地。 本教學課程涵蓋刪除不再需要的目的地帳戶的步驟,這些帳戶是使用 Flow Service API.

注意

目前僅流程服務API支援刪除目的地帳戶。 無法使用Experience PlatformUI刪除目的地帳戶。

快速入門

本教學課程要求您具備有效的連線ID。 連線ID代表與目的地的帳戶連線。 如果您沒有有效的連線ID,請從 目的地目錄 並依照下列步驟進行 連線到目的地 在嘗試本教學課程之前。

本教學課程也要求您實際瞭解Adobe Experience Platform的下列元件:

  • 目的地: Destinations 是預先建立的與目標平台的整合,可無縫啟用Adobe Experience Platform的資料。 您可以使用目的地,針對跨頻道行銷活動、電子郵件行銷活動、目標定位廣告和許多其他使用案例,啟用已知和未知的資料。
  • 沙箱: Experience Platform 提供分割單一區域的虛擬沙箱 Platform 將執行個體整合至個別的虛擬環境中,以協助開發及改進數位體驗應用程式。

以下小節提供您需要瞭解的其他資訊,才能使用成功刪除目的地帳戶 Flow Service API。

讀取範例API呼叫

本教學課程提供範例API呼叫,示範如何格式化您的請求。 這些包括路徑、必要的標頭,以及正確格式化的請求裝載。 此外,也提供API回應中傳回的範例JSON。 如需檔案中用於範例API呼叫的慣例相關資訊,請參閱以下章節: 如何讀取範例API呼叫 在 Experience Platform 疑難排解指南。

收集必要標題的值

為了呼叫 Platform API,您必須先完成 驗證教學課程. 完成驗證教學課程後,會在所有標題中提供每個必要標題的值 Experience Platform API呼叫,如下所示:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

中的所有資源 Experience Platform,包括屬於 Flow Service,會隔離至特定的虛擬沙箱。 的所有要求 Platform API需要標頭,用於指定將在其中執行操作的沙箱名稱:

  • x-sandbox-name: {SANDBOX_NAME}
注意

如果 x-sandbox-name 標頭未指定,請求解析於 prod 沙箱。

包含裝載(POST、PUT、PATCH)的所有請求都需要額外的媒體型別標頭:

  • Content-Type: application/json

尋找要刪除的目的地帳戶的連線ID

注意

本教學課程使用 飛艇目的地 例如,但概述的步驟適用於下列任何步驟: 可用的目的地.

刪除目的地帳戶的第一步,是找出與您要刪除的目的地帳戶對應的連線ID。

在Experience PlatformUI中,瀏覽至 目的地 > 帳戶 ,並選取您要刪除的帳戶,方法是在 目的地 欄。

選取要刪除的目的地帳戶

接著,您可以從瀏覽器的URL擷取目的地帳戶的連線ID。

從URL擷取連線ID

刪除連線

重要

在刪除目的地帳戶之前,您必須先刪除目的地帳戶的任何現有資料流。
若要刪除現有資料流,請參閱以下頁面:

擁有連線ID並確保目的地帳戶不存在任何資料流後,請對執行DELETE請求 Flow Service API。

API格式

DELETE /connections/{CONNECTION_ID}
參數 說明
{CONNECTION_ID} 唯一 id 要刪除之連線的值。

要求

curl -X DELETE \
    'https://platform.adobe.io/data/foundation/flowservice/connections/c8622ec7-7d94-44a5-a35a-ffcc6bdcc384' \
    -H 'Authorization: Bearer {ACCESS_TOKEN}' \
    -H 'x-api-key: {API_KEY}' \
    -H 'x-gw-ims-org-id: {ORG_ID}' \
    -H 'x-sandbox-name: {SANDBOX_NAME}'

回應

成功的回應會傳回HTTP狀態204 (無內容)和空白內文。 您可以嘗試向連線查詢(GET)要求以確認刪除。 API將傳回HTTP 404 (找不到)錯誤,這表示已刪除目的地帳戶。

API錯誤處理

本教學課程中的API端點遵循一般Experience PlatformAPI錯誤訊息原則。 請參閱 API狀態代碼請求標頭錯誤 (在平台疑難排解指南中)。

後續步驟

依照本教學課程,您已成功使用 Flow Service 用於刪除現有目的地帳戶的API。 如需使用目的地的詳細資訊,請參閱 目的地概觀.

此頁面上的