管理者権限で施設を登録する
固定リンクがコピーされました
施設情報を登録します。
このAPIを実行するには、管理者権限が必要です。詳細は
必要なアクセス権を参照してください。
クラウド版
https://sample.cybozu.com/g/api/v1/schedule/admin/facilities
パッケージ版
環境に合わせてそれぞれ以下を置き換えてください。
IP_ADDRESS_OR_HOST_NAME
:Garoonのインストール先のIPアドレスまたはホスト名
INSTALL_IDENTIFER
:Garoonのインストール識別子
- Windows環境
- http://
IP_ADDRESS_OR_HOST_NAME
/scripts/INSTALL_IDENTIFER
/grn.exe/api/v1/schedule/admin/facilities
- Linux環境
- http://
IP_ADDRESS_OR_HOST_NAME
/cgi-bin/INSTALL_IDENTIFER
/grn.cgi/api/v1/schedule/admin/facilities
POST
利用できるバージョン
固定リンクがコピーされました
- クラウド版Garoon
- パッケージ版Garoon 5.15以降
次のいずれかの権限が必要です。
- Garoonのシステム管理者権限
- 予定のアプリケーション管理者権限
パラメーター
パラメーター名 |
型 |
必須 |
説明 |
name |
文字列 |
必須 |
施設名 |
nameLocale.ja |
文字列 |
省略可 |
日本語で表示したときの施設名 |
nameLocale.en |
文字列 |
省略可 |
英語で表示したときの施設名 |
nameLocale.zh |
文字列 |
省略可 |
簡体字で表示したときの表示名 |
nameLocale.zh-tw |
文字列 |
省略可 |
繁体字で表示したときの表示名 |
code |
配列(文字列) |
必須 |
施設コード |
notes |
文字列 |
省略可 |
メモ |
facilityGroup |
配列(数値) |
省略可 |
施設グループID |
リクエストの例
ヘッダー
1
2
3
4
|
{
"X-Cybozu-Authorization": "QWRtaW5pc3RyYXRvcjpjeWJvenU=",
"Content-Type": "application/json"
}
|
リクエストヘッダーの詳細は
Garoon REST APIの共通仕様を参照してください。
ボディ
1
2
3
4
5
6
7
8
9
10
11
12
|
{
"name": "Library",
"nameLocale": {
"ja": "会議室A",
"en": "Meeting room A",
"zh": "会议室A",
"zh-tw": "會議室A"
},
"code": "meeting_room_a",
"notes": "This is note",
"facilityGroup": 1
}
|
プロパティ
プロパティ名 |
型 |
説明 |
id |
数値 |
施設ID |
name |
文字列 |
施設名 |
nameLocale |
オブジェクト |
言語ごとに設定した施設の表示名 |
nameLocale.ja |
文字列 |
日本語で表示したときの施設名 |
nameLocale.en |
文字列 |
英語で表示したときの施設名 |
nameLocale.zh |
文字列 |
簡体字で表示したときの施設名 |
nameLocale.zh-tw |
文字列 |
繁体字で表示したときの施設名 |
code |
文字列 |
施設コード |
notes |
文字列 |
メモ |
facilityGroup |
数値 |
施設グループID |
レスポンスの例
1
2
3
4
5
6
7
8
9
10
11
12
13
|
{
"id": 1,
"name": "Library",
"nameLocale": {
"ja": "会議室A",
"en": "Meeting room A",
"zh": "会议室A",
"zh-tw": "會議室A"
},
"code": "meeting_room_a",
"notes": "This is note",
"facilityGroup": 1
}
|
curlを使ったリクエスト
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
curl -X POST 'https://sample.cybozu.com/g/api/v1/schedule/admin/facilities' \
-H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=' \
-H 'Content-Type: application/json' \
-d '{
"name": "Library",
"nameLocale": {
"ja": "会議室A",
"en": "Meeting room A",
"zh": "会议室A",
"zh-tw": "會議室A"
},
"code": "meeting_room_a",
"notes": "This is note",
"facilityGroup": 1
}'
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
const body = {
name: 'Library',
nameLocale: {
ja: '会議室A',
en: 'Meeting room A',
zh: '会议室A',
'zh-tw': '會議室A'
},
code: 'meeting_room_a',
notes: 'This is note',
facilityGroup: 1
};
await garoon.api('/api/v1/schedule/admin/facilities', 'POST', body);
|