Square Connect API:检索类别中的所有项目

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和请求库。

Answer 1

为了列出类别中的项目，我发现最容易使用/v2/catalog/search endpoint。只需遵循接受哪些参数的文档即可。以下是我用来按类别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
    ]

Answer 2

您可能最幸运地列出了整个目录GET /v2/catalog/list，然后在获取数据后应用过滤（在这种情况下是特定于catagory_id s）。根据文档，按照端点/查询的梳理作用似乎是不可能的。