Можно ли установить часовой пояс пользователя RingCentral через API?

Question

Я искал через API, как установить часовой пояс и не могу его найти. Разве нет способа установить часовой пояс через API?

Answer 1

Часовой пояс пользователя задается как часть его свойств расширения и читается с использованием API-интерфейса Extension Info и устанавливается через конечную точку Update Extension Info, а не конкретную конечную точку часового пояса. Я начну с чтения, потому что ответ предоставляет простой способ создания запроса на обновление часового пояса.

Читать часовой пояс

Чтобы прочитать текущий часовой пояс пользователя, получите информацию о настройках пользователя, используя следующую конечную точку. Вы получите много свойств. Из ответа вы можете увидеть, как создать запрос на обновление.

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

Ответ будет содержать много информации, включая часовой пояс, как показано. Используйте этот путь JSON в своем запросе на обновление с идентификатором часового пояса, показанным ниже.

{
    "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

Установить часовой пояс

Чтобы установить часовой пояс пользователя, обновите конечную точку расширения пользователя, используя PUT метод и укажите идентификатор часового пояса в теле, как показано. Идентификаторы часовых поясов можно найти в конечной точке часового пояса, показанной ниже.

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

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

https://developer.ringcentral.com/api-reference

Список часовых поясов

Чтобы получить список часовых поясов, вызовите конечную точку часового пояса:

GET /restapi/v1.0/dictionary/timezone

Ответ содержит список часовых поясов с описанием и идентификатором часового пояса, который используется в запросе на обновление пользовательских настроек.

{
    "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 Reference для получения дополнительной информации:

https://developer.ringcentral.com/api-reference