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

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 用户的时区？

Is it possible to set a RingCentral user's timezone through the API?

ringcentral

settings