smartsheet api 搜索支持哪些特殊字符

What are special characters supported on the smartsheet api search

根据我的理解,现在 smartsheet 搜索正在寻找与所搜索的字词相似的任何内容。

假设我正在寻找 'test' :

https://api.smartsheet.com/2.0/search?query=test

可以 return :

是否有任何特殊字符可以执行更高级的搜索(如 SQL 类查询)?

很遗憾,没有。返回搜索结果后,您需要在本地过滤结果。如果结果太多,请尝试限制搜索范围,例如一次搜索一个工作区,或者只搜索报告。

我不确定 /search 端点是否以与 SQL 查询相同的方式支持特殊字符。但是,支持以下两种情况:

  • 场景#1:查找指定字符串作为单独单词存在的位置(不区分大小写)

  • 场景 #2: 查找指定字符串作为单独单词或作为另一个单词的一部分(不区分大小写)存在的位置

下面的两个示例通过搜索如下所示的 sheet 来演示这些场景中的每一个:

场景#1:查找指定字符串作为单独单词存在的位置(不区分大小写)

要查找指定字符串作为单独单词存在的位置,请将该字符串(即 query 参数的值)括在双引号中。

API 请求:GET https://api.smartsheet.com/2.0/search/sheets/5831916227192708?query="new"

API 响应:响应仅包含第 2 行和第 3 行的条目——因为单词 "new"(作为单独的单词)仅存在于这两行中。

{
    "results": [
        {
            "text": "New York, NY",
            "objectType": "row",
            "objectId": 5895212085602180,
            "parentObjectType": "sheet",
            "parentObjectId": 5831916227192708,
            "parentObjectName": "SOTest",
            "contextData": [
                "Row 2: Meeting #2"
            ]
        },
        {
            "text": "Scranton, new jersey",
            "objectType": "row",
            "objectId": 3643412271916932,
            "parentObjectType": "sheet",
            "parentObjectId": 5831916227192708,
            "parentObjectName": "SOTest",
            "contextData": [
                "Row 3: Meeting #3"
            ]
        }
    ],
    "totalCount": 2
}

场景 #2:查找指定字符串作为单独单词或作为另一个单词的一部分(不区分大小写)存在的位置

要查找指定字符串作为单独单词或作为另一个单词的一部分存在的位置,请不要将该字符串(即 query 参数的值)括在引号中。

API 请求:https://api.smartsheet.com/2.0/search/sheets/5831916227192708?query=new

API 响应:响应包含所有 5 行的条目——因为 string "new" 存在于所有这些行中。

{
    "results": [
        {
            "text": "New York, NY",
            "objectType": "row",
            "objectId": 5895212085602180,
            "parentObjectType": "sheet",
            "parentObjectId": 5831916227192708,
            "parentObjectName": "SOTest",
            "contextData": [
                "Row 2: Meeting #2"
            ]
        },
        {
            "text": "Avonew, MS",
            "objectType": "row",
            "objectId": 6198495731836804,
            "parentObjectType": "sheet",
            "parentObjectId": 5831916227192708,
            "parentObjectName": "SOTest",
            "contextData": [
                "Row 4: Meeting #4"
            ]
        },
        {
            "text": "Newtown, PA",
            "objectType": "row",
            "objectId": 1391612458231684,
            "parentObjectType": "sheet",
            "parentObjectId": 5831916227192708,
            "parentObjectName": "SOTest",
            "contextData": [
                "Row 1: Meeting #1"
            ]
        },
        {
            "text": "Anewston, MI",
            "objectType": "row",
            "objectId": 3946695918151556,
            "parentObjectType": "sheet",
            "parentObjectId": 5831916227192708,
            "parentObjectName": "SOTest",
            "contextData": [
                "Row 5: Meeting #5"
            ]
        },
        {
            "text": "Scranton, new jersey",
            "objectType": "row",
            "objectId": 3643412271916932,
            "parentObjectType": "sheet",
            "parentObjectId": 5831916227192708,
            "parentObjectName": "SOTest",
            "contextData": [
                "Row 3: Meeting #3"
            ]
        }
    ],
    "totalCount": 5
}