广场连接API : Retrieving all items within a category

Question

我一直在阅读 Square Connect API 并摆弄目录部分。

我无法找到如何检索与特定类别关联的所有项目及其数据。有人可以指出我正确的方向吗？

我还以为是这个

BatchRetrieveCatalogObjects endpoint

我使用了类别 ID，但它仅返回目录的数据。我需要每个项目的 ID 来检索其各自的数据。

我希望在一个 JSON 请求中传播所有项目及其数据的列表。

要传递到端点的 JSON 数据:

data = {
                "object_ids": [
                    "category id"
                ],
                "include_related_objects": True
            }

我与 API 的连接:

 category_item_endpoint =  self.connection.post('/v2/catalog/batch-retrieve', data)

我正在使用 python3 和 requests 库。

Answer 1

为了列出类别中的项目，我发现使用 /v2/catalog/search 端点最简单。只需遵循有关接受哪些参数的文档即可。下面是我用来按类别 ID 列出项目的搜索参数。

let sParams: JSON = [
        "object_types": [
            "ITEM"
        ],
        "include_related_objects": true,
        "include_deleted_objects": false,
        "query": [
            "exact_query": [
                "attribute_name": "category_id",
                "attribute_value": id
            ]
        ],
        "limit": 1000
    ]