2022年8月14日Garoon APIアップデート情報

API更新情報

2022年8月14日に実施するメンテナンスにおける、Garoon APIのアップデート内容は次のとおりです。

Garoon JavaScript API

機能追加

メールの詳細画面を表示したときのイベントを追加
対象 イベント
備考

プレビュー表示あり（3ペイン）の場合には、プレビューを表示したときにイベントが発生します。

メールの詳細画面で、メールの標題の下の要素を取得するAPIを追加
対象API
備考

プレビュー表示あり（3ペイン）の場合には、プレビューを表示したときに要素を取得します。

機能改善

対象APIを使って、外部 にAPIリクエストを送信してからタイムアウトするまでの時間を、10秒から30秒に変更
対象API
備考

30秒を過ぎると「GRN_CMMN_03008」エラーが返ります。

不具合修正

対象イベントまたはAPIで取得した、申請を処理するときのコメントに含まれる日時や改行コードが正しくないことがある現象を解消
対象イベント／API
修正内容

申請を処理するとき、投稿するコメント（steps.ステップコード.processors[].comment）に含まれる、次の値の書式が修正されます。

  • 修正前：
    • 承認日時／差し戻し日時：ISO 8601形式
    • 改行コード：エスケープされている（\\n）
  • 修正後：
    • 承認日時／差し戻し日時：APIを実行するユーザーが設定した、日時の表示形式の設定の「日付の長い形式」の形式と同じ。
    • 改行コード：エスケープされていない（\n）

Garoon REST API

不具合修正

複数の予定を取得するAPIで、リクエストパラメーターにshowPrivate=falseを指定すると、閲覧権限のない予定の一部情報を取得してしまう現象を解消
対象API
発生条件

リクエストパラメーターにshowPrivate=falseを指定して、対象APIを実行する。

修正内容
  • 修正前：
    APIを実行するユーザーに閲覧権限のない予定の一部情報を含んだ予定一覧も取得できてしまう。
  • 修正後：
    APIを実行するユーザーに閲覧権限のない予定の一部情報は取得できない。
    showPrivateを指定せずに実行したときと同じで、閲覧権限のある予定だけを返します。
通知の取得APIで、作成者のユーザーが削除されている通知を取得すると、エラーが発生する現象を解消
対象API
修正内容
  • 修正前：
    PHP00004エラーが発生してしまう。
  • 修正後：
    通知の内容を取得できる。
対象APIで取得した、申請を処理するときのコメントに含まれる日時や改行コードが正しくないことがある現象を解消
対象API
修正内容

申請を処理するとき、投稿するコメント（steps.ステップコード.processors[].comment）に含まれる、次の値の書式が修正されます。

  • 修正前：
    • 承認日時／差し戻し日時：ISO 8601形式
    • 改行コード：エスケープされている（\\n）
  • 修正後：
    • 承認日時／差し戻し日時：APIを実行するユーザーが設定した、日時の表示形式の設定の「日付の長い形式」の形式と同じ。
    • 改行コード：エスケープされていない（\n）

製品のアップデート情報

API以外のGaroonのアップデートに関する情報は、 クラウド版Garoon更新情報 (External link) を参照してください。
8月定期メンテナンス分は後日公開されます。