使用流量服务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。 有关使用目标的更多信息，请参阅 目标概述.

在此页面上