Show Menu
主题×

使用API管理数据使用标签

数据集服务API允许您以编程方式管理数据集的使用标签。 它是Adobe Experience Platform的数据目录功能的一部分,但与管理数据集元数据的Catalog Service API分开。
此文档提供有关如何使用数据集服务API管理数据集和字段级别的数据使用标签的步骤。

入门指南

在阅读本指南之前,请按照目录开发人 员指南 “入门”部分中概述的步骤收集所需凭据以调用 Platform API。
要调用以下各节中概述的端点,您必须具有特定数 id 据集的唯一值。 如果没有此值,请参阅列出目录对 象的指南 ,以查找现有数据集的ID。

查找数据集的标签

您可以通过发出GET请求来查找已应用于现有数据集的数据使用标签。
API格式
GET /datasets/{DATASET_ID}/labels

参数
描述
{DATASET_ID}
要查找 id 其标签的数据集的唯一值。
请求
curl -X GET \
  'https://platform.adobe.io/data/foundation/dataset/datasets/5abd49645591445e1ba04f87/labels' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

响应
成功的响应会返回已应用于数据集的数据使用标签。
{
  "AEP:dataset:5abd49645591445e1ba04f87": {
    "imsOrg": "{IMS_ORG}",
    "labels": [ "C1", "C2", "C3", "I1", "I2" ],
    "optionalLabels": [
      {
        "option": {
          "id": "https://ns.adobe.com/{TENANT_ID}/schemas/c6b1b09bc3f2ad2627c1ecc719826836",
          "contentType": "application/vnd.adobe.xed-full+json;version=1",
          "schemaPath": "/properties/repositoryCreatedBy"
        },
        "labels": [ "S1", "S2" ]
      }
    ]
  }
}

属性
描述
labels
应用于数据集的列表数据使用标签。
optionalLabels
列表数据集中已应用数据使用标签的各个字段。

将标签应用于数据集

您可以通过在POST或PUT请求的有效负荷中提供数据集的标签集来创建这些标签。 使用以下任一方法将覆盖任何现有标签,并用有效负荷中提供的标签替换它们。
API格式
POST /datasets/{DATASET_ID}/labels
PUT /datasets/{DATASET_ID}/labels

参数
描述
{DATASET_ID}
要为 id 其创建标签的数据集的唯一值。
请求
以下POST请求会向数据集添加一系列标签以及该数据集中的特定字段。 有效负荷中提供的字段与PUT请求所需的字段相同。
curl -X POST \
  'https://platform.adobe.io/data/foundation/dataset/datasets/5abd49645591445e1ba04f87/labels' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
  "labels": [ "C1", "C2", "C3", "I1", "I2" ],
  "optionalLabels": [
    {
      "option": {
        "id": "https://ns.adobe.com/{TENANT_ID}/schemas/c6b1b09bc3f2ad2627c1ecc719826836",
        "contentType": "application/vnd.adobe.xed-full+json;version=1",
        "schemaPath": "/properties/repositoryCreatedBy"
      },
      "labels": [ "S1", "S2" ]
    }
  ]
}'

属性
描述
labels
要添加到数据集的列表数据使用标签。
optionalLabels
列表数据集中要添加标签的任何单个字段。 此数组中的每个项目都必须具有以下属性:
option : 包含字段的体验数据模型(XDM)属性的对象。 以下三个属性是必需的:
  • id: 与字段关联的 模式的URI $id值。
  • contentType: 模式的内容类型和版本号。 这应采用XDM查找请求的有效 查找资源 接受标头 之一的形式。
  • schemaPath: 数据集模式中字段的路径。
labels : 要添加到字段的列表数据使用标签。
响应
成功的响应会返回已添加到数据集的标签。
{
  "labels": [ "C1", "C2", "C3", "I1", "I2" ],
  "optionalLabels": [
    {
      "option": {
        "id": "https://ns.adobe.com/{TENANT_ID}/schemas/c6b1b09bc3f2ad2627c1ecc719826836",
        "contentType": "application/vnd.adobe.xed-full+json;version=1",
        "schemaPath": "/properties/repositoryCreatedBy"
      },
      "labels": [ "S1", "S2" ]
    }
  ]
}

删除数据集的标签

您可以通过发出DELETE请求删除应用于数据集的标签。
API格式
DELETE /datasets/{DATASET_ID}/labels

参数
描述
{DATASET_ID}
要删除 id 其标签的数据集的唯一值。
请求
curl -X DELETE \
  'https://platform.adobe.io/data/foundation/dataset/datasets/5abd49645591445e1ba04f87/labels' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

响应
成功响应HTTP状态200(OK),表示标签已被删除。 您可以 在单独的调用中查找 数据集的现有标签以确认这一点。

后续步骤

现在,您已在数据集和字段级别添加了数据使用标签,可以开始将数据引入Experience Platform。 要了解更多信息,请阅读开始 获取文档
您现在还可以根据已应用的标签定义数据使用策略。 有关详细信息,请参阅 数据使用策略概述
有关管理中数据集的更 Experience Platform多信息,请参 阅数据集概述