Garoon API ドキュメント

予定のカスタム項目（Schedule datastore）を更新する

目次

予定のカスタム項目（Schedule datastore）を更新する

予定 ID とカスタマイズ名を指定して、予定のカスタム項目（Schedule datastore）を更新します。

URL

クラウド版

https://sample.cybozu.com/g/api/v1/schedule/events/予定 ID/datastore/カスタマイズ名

パッケージ版
Windows 環境
http://サーバーのIPアドレスまたはホスト名/scripts/インストール識別子/grn.exe/api/v1/schedule/events/予定 ID/datastore/カスタマイズ名
Linux 環境
http://サーバーのIPアドレスまたはホスト名/cgi-bin/インストール識別子/grn.cgi/api/v1/schedule/events/予定 ID/datastore/カスタマイズ名
パスパラメーター
パラメーター名 説明
予定 ID カスタム項目を更新する予定の予定 ID
カスタマイズ名 更新するカスタム項目のカスタマイズ名
カスタマイズ名の命名規則は、 カスタム項目(Schedule datastore) の命名規則 を確認してください。

HTTP メソッド

PUT

利用できるバージョン

  • クラウド版 Garoon
  • パッケージ版 Garoon 5.9 以降

必要なアクセス権

  • 予定の変更権限

リクエスト

パラメーター
パラメーター名 型 必須 説明
value オブジェクト 必須 カスタム項目の設定内容
キーと値を対にしたオブジェクトの形式で指定します。
キー名は 128 文字以下、値は 80,000 文字以下で指定します。
リクエストの例
URL

https://sample.cybozu.com/g/api/v1/schedule/events/1/datastore/jp.co.cybozu.schedule.sample

1
2
3
4

{
  "X-Cybozu-Authorization": "QWRtaW5pc3RyYXRvcjpjeWJvenU=",
  "Content-Type": "application/json"
}

リクエストヘッダーの詳細は Garoon REST API の共通仕様 を参照してください。

ボディ
1
2
3
4
5
6
7

{
  "value": {
    "key1": "value1",
    "key2": { "key2.1": "value2.1" },
    "key3": ["value3"]
  }
}

レスポンス

プロパティ
プロパティ名 型 説明
value オブジェクト 更新したカスタム項目の設定
キーと値を対にしたオブジェクトの形式です。
レスポンスの例
1
2
3
4
5
6
7

{
  "value": {
    "key1": "value1",
    "key2": { "key2.1": "value2.1" },
    "key3": ["value3"]
  }
}

サンプルコード

curl を使ったリクエスト
 1
 2
 3
 4
 5
 6
 7
 8
 9
10

curl -X PUT 'https://sample.cybozu.com/g/api/v1/schedule/events/1/datastore/jp.co.cybozu.schedule.sample' \
  -H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": {
      "key1": "value1",
      "key2": {"key2.1": "value2.1"},
      "key3": ["value3"]
    }
  }
Garoon REST API リクエストを送信する API を使ったリクエスト
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

const body = {
  value: {
    key1: 'value1',
    key2: {
      'key2.1': 'value2.1'
    },
    key3: ['value3']
  }
};

await garoon.api('/api/v1/schedule/events/1/datastore/jp.co.cybozu.schedule.sample', 'PUT', body);