门户中的 RingCentral ReadPresenceSettings 设置在哪里？

Question

我在我的角色的 API 中看到了 ReadPresenceSettings 权限，但在在线帐户门户 (https://service.ringcentral.com) 中没有看到它。这对应于门户中的什么，以便我可以设置/取消设置它？

角色权限

请求

GET /restapi/v1.0/dictionary/user-role/:roleId
GET /restapi/v1.0/dictionary/user-role/3

响应

{
    "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/user-role/3",
    "id": "3",
    "displayName": "Standard (International)",
    "description": "User level access with international dialing access.",
    "custom": false,
    "scope": "Self",
    "hidden": false,
    "siteCompatible": false,
    "permissions": [
        {
            "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission/ReadPresenceSettings",
            "id": "ReadPresenceSettings",
            "assignable": false,
            "readOnly": false,
            "siteCompatible": "Independent"
        },
        ...
    ]
}

权限信息存在

当我检查状态信息端点时，我看到它被称为“读取状态设置”，但门户中没有这样的权限。

请求

GET /restapi/v1.0/dictionary/permission/:permissionId
GET /restapi/v1.0/dictionary/permission/ReadPresenceSettings

响应

{
    "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission/ReadPresenceSettings",
    "id": "ReadPresenceSettings",
    "displayName": "Read Presence Settings",
    "assignable": false,
    "readOnly": false,
    "siteCompatible": "Independent",
    "category": {
        "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission-category/Features",
        "id": "Features"
    },
    "includedPermissions": []
}

我在这里使用 Postman 和集合：

https://github.com/grokify/swaggman

Answer 1

RingCentral 权限可能相当精细，并非每个 API 权限都显示在在线帐户门户中。

可分配给用户的权限由权限的布尔值assignable 属性指示。对于ReadPresenceSettings，此设置为false。

某些权限是另一个可分配权限的子权限。在这种情况下，它们将列在权限includedPermissions 属性中。

在这种情况下，可分配的父权限是：API 中的ConfigurePresence 或 UI 中的“配置状态”。

查找可分配的父权限

要使用 API 找到它，请调用权限列表端点，然后检查 includedPermissions 属性中 ReadPresenceSettings 的每个权限，其中 assignable 属性也是 true。

请求

GET /restapi/v1.0/dictionary/permission

响应

响应将包含一组权限，如下所示。过滤可分配的权限并具有ReadPresenceSettings 权限作为包含权限仅返回ConfigurePresence。

{
    "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission?page=1&perPage=100",
    "records": [
        {
            "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission/ConfigurePresence",
            "id": "ConfigurePresence",
            "displayName": "Configure Presence",
            "description": "Allows to manage Presence settings",
            "assignable": true,
            "readOnly": false,
            "siteCompatible": "Independent",
            "category": {
                "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission-category/Features",
                "id": "Features"
            },
            "includedPermissions": [
                {
                    "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission/EditPresenceStatus",
                    "id": "EditPresenceStatus",
                    "assignable": false,
                    "readOnly": false,
                    "siteCompatible": "Independent"
                },
                {
                    "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission/ReadPresenceSettings",
                    "id": "ReadPresenceSettings",
                    "assignable": false,
                    "readOnly": false,
                    "siteCompatible": "Independent"
                },
                {
                    "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission/ReadPresenceStatus",
                    "id": "ReadPresenceStatus",
                    "assignable": false,
                    "readOnly": false,
                    "siteCompatible": "Independent"
                },
                {
                    "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/permission/EditPresenceSettings",
                    "id": "EditPresenceSettings",
                    "assignable": false,
                    "readOnly": false,
                    "siteCompatible": "Independent"
                }
            ]
        },
        ....
    ]
}

更新权限

一旦您拥有可分配的父权限，您就可以照常为用户更新它。这样做也会启用/禁用子权限。例如，对于ReadPresenceSettings，您将照常使用在线帐户门户更新用户角色的“配置状态”权限。如果用户正在使用内置权限，您可能需要为该用户创建一个新的、已修改的角色（如果还没有）。

您可以在这篇知识库文章中了解有关如何执行此操作的更多信息：

https://success.ringcentral.com/articles/RC_Knowledge_Article/5-10-Editing-the-Extension-Permissions-via-Web