Destinations 是預先建立的與目標平台的整合,可無縫啟用Adobe Experience Platform的資料。 您可以使用目的地,針對跨頻道行銷活動、電子郵件行銷活動、目標定位廣告和許多其他使用案例,啟用已知和未知的資料。
在啟用資料之前,您必須先設定目的地帳戶,以連線至目的地。 本教學課程涵蓋刪除不再需要的目的地帳戶的步驟,這些帳戶是使用 Flow Service API.
目前僅流程服務API支援刪除目的地帳戶。 無法使用Experience PlatformUI刪除目的地帳戶。
本教學課程要求您具備有效的連線ID。 連線ID代表與目的地的帳戶連線。 如果您沒有有效的連線ID,請從 目的地目錄 並依照下列步驟進行 連線到目的地 在嘗試本教學課程之前。
本教學課程也要求您實際瞭解Adobe Experience Platform的下列元件:
以下小節提供您需要瞭解的其他資訊,才能使用成功刪除目的地帳戶 Flow Service 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。
在Experience PlatformUI中,瀏覽至 目的地 > 帳戶 ,並選取您要刪除的帳戶,方法是在 目的地 欄。
接著,您可以從瀏覽器的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端點遵循一般Experience PlatformAPI錯誤訊息原則。 請參閱 API狀態代碼 和 請求標頭錯誤 (在平台疑難排解指南中)。
依照本教學課程,您已成功使用 Flow Service 用於刪除現有目的地帳戶的API。 如需使用目的地的詳細資訊,請參閱 目的地概觀.