通過工作區 API 列出文件和文件夾

返回有關對象（文件、文件夾和 bots) 在公共或私有工作區中。此端點返回對象 id，這是一個數值，在其他 API 中用於標識文件、文件夾或 bot.

先決條件

註: 您可以查看 Control Room APIs 在裡面 Community Edition，但 API 功能有限。你需要一個許可 Automation 360 版本以訪問 API 的全部功能。

所有 API 調用都必須包含來自驗證 API （生成 JSON Web 令牌）或來自 OAuth 服務的不記名令牌。您不能在 API 中同時使用兩者。
要查看私人工作區中的對象，您必須擁有 Bot Creator 許可和包含 查看我的機器人 功能權限的角色。
要查看公共工作區中的對象，必須為您分配一個角色，該角色包括 查看我的機器人 功能權限和 查看內容 bot 對公共工作區中文件夾的權限。

程序

將身份驗證令牌或承載令牌添加到請求標頭。您不能在同一 API 中同時使用兩者。
使用 POST 方法和端點 URL： <control_room_url>/v2/repository/workspaces/{workspaceType}/files/list
{workspaceType} 指定是在公共工作區還是私有工作區中搜索。
以下示例請求搜索名稱中包含字符串 finance 。
要求本文：
```
{
  "filter": {
      "operator": "substring",
      "field": "name",
      "value": "finance"
      }
  }
```
支持的可過濾字段

發送請求。

響應主體：

在此示例響應中，此端點返回一個 bot 對象 ID 為 14277。

{
    "page": {
        "offset": 0,
        "total": 1114,
        "totalFilter": 1
    },
    "list": [
        {
            "id": "14277",
            "parentId": "9",
            "name": "financeWeeklyReport",
            "path": "Automation Anywhere\\Bots\\exampleBots",
            "description": "v1",
            "type": "application/vnd.aa.taskbot",
            "size": "799",
            "folder": false,
            "folderCount": "0",
            "productionVersion": "",
            "latestVersion": "",
            "locked": false,
            "lockedBy": "0",
            "createdBy": "22",
            "lastModifiedBy": "22",
            "lastModified": "2020-10-21T17:42:10.140037Z",
            "permission": {
                "delete": false,
                "download": false,
                "upload": false,
                "run": true,
                "publishBotstore": false,
                "viewContent": false,
                "clone": false
            },
            "workspaceId": "0",
            "botStatus": "PUBLIC",
            "hasErrors": false,
            "workspaceType": "UNKNOWN",
            "metadata": false,
            "uri": "",
            "version": "3",
            "hasTriggers": false,
            "isModified": false
        }
    ]
    }

響應參數：

id：與搜索參數匹配的對象的唯一數字標識符。
parentId：父文件夾的唯一數字標識符。
folder：一個布爾值，如果對像是文件夾則返回 true 如果是文件夾則返回 falsebot 或其他文件。

REST API 使用 HTTP 響應代碼響應每個請求。有關響應代碼的詳細信息，請參見 API響應代碼.

後續步驟

如果您正在執行這些步驟來運行 bot 或者要創建自動化計劃，請執行此任務：列表可用無人值守 Bot Runners 應用程序接口