Question

我一直在寻找如何设置时区的API，但找不到它。无法通过API设置时区吗？

Answer 1

将用户的时区设置为扩展属性的一部分，并使用扩展信息API进行读取，并通过“更新扩展信息”端点（而不是特定的时区端点）进行设置。我将从读取开始，因为响应提供了一种创建更新时区请求的简便方法。

读取时区

要读取用户的当前时区，请使用以下端点检索用户的设置信息。您将获得很多属性。从响应中，您可以看到如何创建更新请求。

GET /restapi/v1.0/account/{accountId}/extension/{extensionId}

响应将包含很多信息，包括所显示的时区。在更新请求中使用此JSON路径，并在下面显示时区ID。

{
    "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/account/11111111/extension/22222222",
    "id": 22222222,
    "extensionNumber": "101",
    ...
    "regionalSettings": {
        "timezone": {
            "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/timezone/60",
            "id": "60",
            "name": "Pacific/Honolulu",
            "description": "Hawaii",
            "bias": "-600"
        },...
    }
}

在API参考中查看更多信息：

https://developer.ringcentral.com/api-reference#User-Settings-loadExtensionInfo

设置时区

要设置用户的时区，请使用PUT方法更新用户的扩展端点，并在正文中指定时区ID，如图所示。可以在下面显示的时区端点中找到时区ID。

PUT /restapi/v1.0/account/{accountId}/extension/{extensionId}

{
    "regionalSettings": {
        "timezone": {
            "id": "58"
        }
    }
}

https://developer.ringcentral.com/api-reference#User-Settings-updateExtension

列出时区

要获取时区列表，请调用时区端点：

GET /restapi/v1.0/dictionary/timezone

响应提供了一个带说明的时区列表，以及在更新用户设置请求中使用的时区ID。

{
    "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/timezone?page=1&perPage=100",
    "records": [
        {
            "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/timezone/1",
            "id": "1",
            "name": "GMT",
            "description": "Casablanca, Monrovia, Reykjavik",
            "bias": "0"
        },
        {
            "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/timezone/2",
            "id": "2",
            "name": "Europe/Lisbon",
            "description": "Dublin, Edinburgh, Lisbon, London",
            "bias": "0"
        },
        ...
        {
            "uri": "https://platform.devtest.ringcentral.com/restapi/v1.0/dictionary/timezone/91",
            "id": "91",
            "name": "Asia/Pyongyang",
            "description": "Pyongyang",
            "bias": "510"
        }
    ],
    "paging": {...},
    "navigation": {...}
}

有关更多信息，请参见API参考：

https://developer.ringcentral.com/api-reference#Regional-Settings-listTimezones

是否可以通过API设置RingCentral用户的时区？

1 个答案: