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

【问题标题】：Is it possible to set a RingCentral user's timezone through the API?是否可以通过 API 设置 RingCentral 用户的时区？
【发布时间】：2018-08-04 01:52:19
【问题描述】：

我正在通过 API 查找如何设置时区，但找不到它。有没有办法通过 API 设置时区？

【问题讨论】：

标签： ringcentral settings

【解决方案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"
        },...
    }
}

设置时区

要设置用户的时区，请使用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

【讨论】：