Catalog Service API指南附录
本文档包含帮助您使用Catalog API的其他信息。
查看相互关联的对象 view-interrelated-objects
某些Catalog对象可以与其他Catalog对象相关联。 任何在响应负载中以@为前缀的字段都表示相关对象。 这些字段的值采用URI形式，可以在单独的GET请求中使用，以检索它们表示的相关对象。
在查找特定数据集的文档中返回的示例数据集包含具有以下URI值的files字段： "@/datasetFiles?datasetId={DATASET_ID}"。 可以使用此URI作为新GET请求的路径来查看files字段的内容。
API格式
GET {OBJECT_URI}
{OBJECT_URI}@符号）。请求
以下请求使用提供了示例数据集的files属性的URI检索数据集的关联文件列表。
curl -X GET \
'https://platform.adobe.io/data/foundation/catalog/dataSets/datasetFiles?datasetId={DATASET_ID}' \
-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}'
响应
成功的响应将返回相关对象的列表。 在此示例中，返回了一个数据集文件列表。
{
"7d501090-0280-11ea-a6bb-f18323b7005c-1": {
"id": "7d501090-0280-11ea-a6bb-f18323b7005c-1",
"batchId": "7d501090-0280-11ea-a6bb-f18323b7005c",
"dataSetViewId": "5ba9452f7de80400007fc52b",
"imsOrg": "{ORG_ID}",
"createdUser": "{USER_ID}",
"createdClient": "{CLIENT_ID}",
"updatedUser": "{USER_ID}",
"version": "1.0.0",
"created": 1573256315368,
"updated": 1573256315368
},
"148ac690-0280-11ea-8d23-8571a35dce49-1": {
"id": "148ac690-0280-11ea-8d23-8571a35dce49-1",
"batchId": "148ac690-0280-11ea-8d23-8571a35dce49",
"dataSetViewId": "5ba9452f7de80400007fc52b",
"imsOrg": "{ORG_ID}",
"createdUser": "{USER_ID}",
"createdClient": "{CLIENT_ID}",
"updatedUser": "{USER_ID}",
"version": "1.0.0",
"created": 1573255982433,
"updated": 1573255982433
},
"64dd5e19-8ea4-4ddd-acd1-f43cccd8eddb-1": {
"id": "64dd5e19-8ea4-4ddd-acd1-f43cccd8eddb-1",
"batchId": "64dd5e19-8ea4-4ddd-acd1-f43cccd8eddb",
"dataSetViewId": "5ba9452f7de80400007fc52b",
"imsOrg": "{ORG_ID}",
"createdUser": "{USER_ID}",
"createdClient": "{CLIENT_ID}",
"updatedUser": "{USER_ID}",
"version": "1.0.0",
"created": 1569499425037,
"updated": 1569499425037
}
}
其他请求标头
Catalog提供了几种标头约定，以帮助您在更新期间保持数据的完整性。
If-Match
最好使用对象版本控制，以防止在多个用户近乎同时保存对象时发生的数据损坏类型。
更新对象的最佳实践包括首先进行API调用以查看(GET)要更新的对象。 包含在响应（以及响应中包含单个对象的任何调用）中的E-Tag标头包含对象的版本。 在更新(PUT或PATCH)调用中将对象版本添加为名为If-Match的请求标头，只有在版本仍然相同的情况下才会导致更新成功，这有助于防止数据冲突。
如果版本不匹配（对象在检索后已被另一进程修改），您将收到HTTP状态412（前提条件失败），指示对目标资源的访问已被拒绝。
Pragma
有时，您可能希望在不保存信息的情况下验证对象。 通过使用值为validate-only的Pragma标头，您可以发送POST或PUT请求以进行验证，从而防止保留对数据所做的任何更改。
数据压缩
压缩是一项Experience Platform服务，它在不更改任何数据的情况下将数据从小文件合并到大文件。 出于性能原因，有时将一组小文件合并为大文件会很有用，以便在查询时提供对数据的快速访问。
当已压缩所摄取批次中的文件时，其关联的Catalog对象将更新以进行监视。