管理者権限で施設を登録する

目次

管理者権限で施設を登録する

施設情報を登録します。
このAPIを実行するには、管理者権限が必要です。詳細は 必要なアクセス権を参照してください。

URL

クラウド版

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

HTTPメソッド

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
  }'
Garoon REST APIリクエストを送信するAPIを使ったリクエスト
 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);