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

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。 如需使用目的地的詳細資訊，請參閱 目的地概觀.

本頁內容