метод REST
scope: calendar
calendar.resource.update
Обновить ресурс
Описание
Метод обновляет ресурс.
Параметры
resourceId
integer
обязательный
Идентификатор ресурса.
Получить идентификатор можно методом создания ресурса calendar.resource.add или методом получения списка ресурсов calendar.resource.list
name
string
обязательный
Новое наименование ресурса
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"resourceId":197,"name":"Changed Resource Name"}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/calendar.resource.update
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"resourceId":197,"name":"Changed Resource Name","auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/calendar.resource.update
// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame } from '@bitrix24/b24jssdk'
declare const $b24: B24Frame
// Shape of the payload returned in result (match the "response handling" section of the page)
type ResourceUpdateResult = number
try {
const response = await $b24.actions.v2.call.make<ResourceUpdateResult>({
method: 'calendar.resource.update',
params: {
resourceId: 197,
name: 'Changed Resource Name',
},
requestId: Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
} else {
const result = response.getData()!.result
console.info('Updated resource ID:', result)
}
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
async function updateCalendarResource() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
const response = await $b24.actions.v2.call.make({
method: 'calendar.resource.update',
params: {
resourceId: 197,
name: 'Changed Resource Name',
},
requestId: B24Js.Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
return
}
const result = response.getData().result
console.info('Updated resource ID:', result)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', updateCalendarResource)
</script>
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
try:
bitrix_response = client.calendar.resource.update(
resource_id=197,
name="Changed Resource Name",
).response
result = bitrix_response.result
print(result)
except BitrixAPIError as error:
print(
"Ошибка Bitrix API",
f"error: {error.error}",
f"error_description: {error.error_description}",
sep="\n",
)
except BitrixSDKException as error:
print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
print(f"Непредвиденная ошибка: {error}")
try {
$response = $b24Service
->core
->call(
'calendar.resource.update',
[
'resourceId' => 197,
'name' => 'Changed Resource Name',
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . print_r($result, true);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error updating resource: ' . $e->getMessage();
}
BX24.callMethod(
'calendar.resource.update',
{
resourceId: 197,
name: 'Changed Resource Name'
}
);
require_once('crest.php');
$result = CRest::call(
'calendar.resource.update',
[
'resourceId' => 197,
'name' => 'Changed Resource Name'
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "calendar.resource.update", b24.Params{
"resourceId": 197,
"name": "Changed Resource Name",
})
if err != nil {
return fmt.Errorf("calendar.resource.update: %w", err)
}
var value b24.ID
if err := json.Unmarshal(res.Result, &value); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("результат:", value)
Ответ
HTTP-статус: 200
{
"result": 197,
"time": {
"start": 1733318565.183275,
"finish": 1733318565.695058,
"duration": 0.5117831230163574,
"processing": 0.29406094551086426,
"date_start": "2024-12-04T13:22:45+00:00",
"date_finish": "2024-12-04T13:22:45+00:00"
}
}
Возвращаемые данные
result
integer
Идентификатор обновленного ресурса
Обработка ошибок
HTTP-статус: 400
{
"error": "",
"error_description": "Не задан обязательный параметр \"name\" для метода \"calendar.resource.update\""
}
| Код | Описание | Значение |
|---|---|---|
| — | Не задан обязательный параметр "resourceId" для метода "calendar.resource.update" | Не передан обязательный параметр resourceId |
| — | Не задан обязательный параметр "name" для метода "calendar.resource.update" | Не передан обязательный параметр name |
| — | Доступ запрещен | Метод вызывается внешним пользователем или пользователю запрещено изменение ресурсов |
| — | При изменении ресурса произошла ошибка | Другая ошибка |

