Garoon APIドキュメント

メッセージを作成する

目次

1件のメッセージを作成する

固定リンクがコピーされました

メッセージを作成します。

URL

固定リンクがコピーされました

クラウド版

https://sample.cybozu.com/g/api/v1/message/messages

パッケージ版

環境に合わせてそれぞれ以下を置き換えてください。

  • IP_ADDRESS_OR_HOST_NAME：Garoonのインストール先のIPアドレスまたはホスト名
  • INSTALL_IDENTIFER：Garoonのインストール識別子
Windows環境
http://IP_ADDRESS_OR_HOST_NAME/scripts/INSTALL_IDENTIFER/grn.exe/api/v1/message/messages
Linux環境
http://IP_ADDRESS_OR_HOST_NAME/cgi-bin/INSTALL_IDENTIFER/grn.cgi/api/v1/message/messages

HTTPメソッド

固定リンクがコピーされました

POST

利用できるバージョン

固定リンクがコピーされました

  • クラウド版Garoon

リクエスト

固定リンクがコピーされました

パラメーター
パラメーター名 型 必須 説明
title 文字列 必須 メッセージの標題
最大文字数は、100文字です。
recipients 配列 必須 宛先のリスト
recipients[].id 文字列 必須 宛先のGaroonユーザーID
recipients[].type 文字列 必須 宛先のタイプ
USERを指定します。
acknowledgement 真偽値 省略可 閲覧状況を確認するかどうか
  • true：閲覧状況を確認する
  • false：閲覧状況を確認しない
省略すると「false」が設定されます。
isDraft 真偽値 省略可 下書きとして保存するかどうか
  • true：下書きとして保存する
  • false：下書きとして保存せず、メッセージを送信する
省略すると「false」が設定されます。
body 文字列 省略可 メッセージの本文
isHtmlBody 真偽値 省略可 本文を書式編集（HTML形式）で保存するかどうか
  • true：HTML形式で保存する
  • false：プレーンテキストで保存する
省略すると「false」が設定されます。
operatorType 文字列 省略可 変更/削除の許可
  • ONLY_SENDER：差出人のみ
  • SELECT_USERS：差出人が許可したユーザー
  • ALL_TO_RECIPIENTS：宛先のユーザー
省略すると「ONLY_SENDER」が設定されます。
operators 配列 省略可 変更/削除の許可で許可するユーザーのリスト
SELECT_USERSを指定した場合のみ必須です。
operators[].id 文字列 省略可 メッセージの変更/削除を許可されているGaroonユーザーID
operators[].name 文字列 省略可 メッセージの変更/削除を許可されているユーザーの表示名
operators[].code 文字列 省略可 メッセージの変更/削除を許可されているユーザーのログイン名
operators[].type 文字列 省略可 メッセージの変更/削除を許可されているタイプ
  • USER：ユーザー
リクエストの例
URL

https://sample.cybozu.com/g/api/v1/message/messages

ヘッダー
1
2
3

{
  "X-Cybozu-Authorization": "QWRtaW5pc3RyYXRvcjpjeWJvenU="
}

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

ボディ
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

{
  "title": "This is title of message",
  "recipients": [
    {
      "id": 1,
      "type": "USER"
    }
  ],
  "acknowledgement": true,
  "isDraft": false,
  "body": "This is body of the message.",
  "isHtmlBody": false
}

レスポンス

固定リンクがコピーされました

プロパティ
プロパティ名 型 説明
id 文字列 メッセージのID
title 文字列 メッセージの標題
creator[].id 文字列 作成者のGaroonユーザーID
creator[].code 文字列 作成者のログイン名
creator[].name 文字列 作成者の表示名
createdAt 文字列 作成日時
updater[].id 文字列 更新者のGaroonユーザーID
updater[].code 文字列 更新者のログイン名
updater[].name 文字列 更新者の表示名
recipients[].id 文字列 宛先のGaroonユーザーID
recipients[].name 文字列 宛先の表示名
recipients[].code 文字列 宛先のログイン名
recipients[].type 文字列 宛先のタイプ
  • USER：ユーザー
recipients[].isAcknowledgement 文字列 閲覧状況を確認するかどうか
  • true：閲覧状況を確認する
  • false：閲覧状況を確認しない
acknowledgement 真偽値 閲覧状況を確認するかどうか
  • true：閲覧状況を確認する
  • false：閲覧状況を確認しない
isDraft 真偽値 下書きどうか
  • true：下書き
  • false：下書きではない
body 文字列 メッセージの本文
isHtmlBody 真偽値 本文を書式編集（HTML形式）で保存するかどうか
  • true：HTML形式
  • false：プレーンテキスト
レスポンスの例
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

{
  "id": "1",
  "title": "This is title of message",
  "creator": {
      "id": "1",
      "code": "Administrator",
      "name": "Administrator"
  },
  "createdAt": "2024-04-19T04:46:25Z",
  "recipients": [
    {
      "id": "2",
      "code": "Harry",
      "name": "h000912",
      "type": "USER",
      "isAcknowledged": false
    }
  ],
  "acknowledgement": true,
  "isDraft": false,
  "body": "This is body of the message.",
  "isHtmlBody": false
}

サンプルコード

固定リンクがコピーされました

curlを使ったリクエスト

ご利用の環境によって、curlのフォーマットは異なる場合があります。
詳細は、次のページを参照してください。
curlコマンドでkintone REST APIを実行してみよう/3.API実行 

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

curl -X POST 'https://sample.cybozu.com/g/api/v1/message/messages' \      
  -H 'X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=' \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "This is title of message",
    "recipients": [
      {
        "id": 1,
        "type": "USER"
      }
    ],
    "acknowledgement": false,
    "isDraft": false,
    "body": "This is body of the message.",
    "isHtmlBody": false
  }'
Garoon REST APIリクエストを送信するAPI を使ったリクエスト
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

const body = {
  title: 'This is title of message',
  recipients: [
    {
      id: 1,
      type: 'USER'
    }
  ],
  acknowledgement: false,
  isDraft: false,
  body: 'This is body of the message.',
  isHtmlBody: false
};

await garoon.api('/api/v1/message/messages', 'POST', body);