APIを使用した操作

記事番号:040820

APIを使用した操作をしたときに出力されるログについて説明します。

API operation

モジュールが「API operation」である監査ログは、下記のとおりです。

App create

アクションが「App create」である監査ログについて説明します。

実行された操作

動作テスト環境にアプリを作成するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名

出力されるログの例

app id: *, app name: *

App deploy

アクションが「App deploy」である監査ログについて説明します。

実行された操作

動作テスト環境のアプリの設定を、運用環境に反映するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリの設定の変更をキャンセルしたかどうか
    • アプリの設定の変更をキャンセルした場合:true
    • アプリの設定の変更を運用環境へ反映した場合:false

出力されるログの例

app id: [*], revert: {true/false}

アプリIDはカンマ区切りで出力されます。

App update

アクションが「App update」である監査ログについて説明します。

実行された操作

動作テスト環境のアプリに対して、下記の設定を変更するAPIを実行した。

  • 「アプリの設定」の「アプリ管理者用メモ」を変更した
  • 「アプリの設定」の「一般設定」の設定を変更した
  • 「アプリの設定」の「レコードのタイトル」の設定を変更した
  • 「アプリの設定」の「高度な設定」で、サムネイル表示の設定を変更した
  • 「アプリの設定」の「高度な設定」で、レコードの一括削除機能の設定を変更した
  • 「アプリの設定」の「高度な設定」で、レコードのコメント機能の設定を変更した
  • 「アプリの設定」の「高度な設定」で、レコードの再利用機能の設定を変更した
  • 「アプリの設定」の「高度な設定」で、レコード一覧でのインライン編集機能の設定を変更した
  • 「アプリの設定」の「高度な設定」で、数値と計算の精度の設定を変更した
  • 「アプリの設定」の「高度な設定」で、第一四半期の開始月を変更した

レベル

情報

「補足」に出力される内容

「アプリ管理者用メモ」を変更した場合

次の項目が出力されます。

  • アプリID
  • アプリ名
  • 変更した設定項目(target)

変更した設定項目には、「adminNotes」が出力されます。

「一般設定」の設定を変更した場合

次の項目が出力されます。

  • アプリID
  • アプリ名
「レコードのタイトル」の設定を変更した場合

次の項目が出力されます。

  • アプリID
  • アプリ名
  • 変更した設定項目の状態

設定項目の状態は、下記のどちらかです。

  • 「レコードのタイトルとして利用するフィールド」の設定で「自動設定を利用する」を選択する場合:AUTO
  • 「レコードのタイトルとして利用するフィールド」の設定で「フィールドを選択する」を選択する場合:MANUAL

「フィールドを選択する」を選択する場合、「レコードのタイトルとして利用するフィールド」のフィールドコードも出力されます。

「高度な設定」の設定を変更した場合

次の項目が出力されます。

  • アプリID
  • アプリ名
  • 変更した設定項目と状態

変更した設定項目は、下記が出力されます。

  • サムネイル表示(enableThumbnails)
  • レコードの一括削除機能(enableBulkDeletion)
  • レコードのコメント機能(enableComments)
  • レコードの再利用機能(enableDuplicateRecord)
  • レコード一覧でのインライン編集機能(enableInlineRecordEditing)
  • 数値と計算の精度の設定
  • 第一四半期の開始月の設定

変更した設定項目の状態は、下記のどちらかです。

  • 有効にした:true
  • 無効にした:false

数値と計算の精度の設定は、下記の値が出力されます。

  • 全体の桁数に設定された値(numberPrecision digits)
  • 小数部の桁数に設定された値(numberPrecision decimalPlaces)
  • 丸めかた(numberPrecision roundingMode)
    • 最近接偶数への丸め:HALF_EVEN
    • 切り上げ:UP
    • 切り下げ:DOWN

第一四半期の開始月の設定は、設定された値(firstMonthOfFiscalYear)が出力されます。

出力されるログの例

「アプリ管理者用メモ」を変更した場合
app id: *, app name: *, target: adminNotes
「一般設定」の設定を変更した場合
app id: *, app name: *
「レコードのタイトル」の設定を変更した場合
app id: *, app name: *, titleField selectionMode: {AUTO/MANUAL}, titleField code: *
「高度な設定」のサムネイル表示の設定を変更した場合
app id: *, app name: *, enableThumbnails: {true/false}
「高度な設定」のレコードの一括削除機能の設定を変更した場合
app id: *, app name: *, enableBulkDeletion: {true/false}
「高度な設定」のレコードのコメント機能の設定を変更した場合
app id: *, app name: *, enableComments: {true/false}
「高度な設定」のレコードの再利用機能の設定を変更した場合
app id: *, app name: *, enableDuplicateRecord: {true/false}
「高度な設定」のレコード一覧でのインライン編集機能の設定を変更した場合
app id: *, app name: *, enableInlineRecordEditing: {true/false}
「高度な設定」の数値と計算の精度の設定を変更した場合
app id: *, app name: *, numberPrecision digits: *, numberPrecision decimalPlaces: *, numberPrecision roundingMode: {HALF_EVEN/UP/DOWN}
「高度な設定」の第一四半期の開始月の設定を変更した場合
app id: *, app name: *, firstMonthOfFiscalYear: *

App status update

アクションが「App status update」である監査ログについて説明します。

実行された操作

動作テスト環境のアプリに対して、プロセス管理の設定を変更するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • プロセス管理の有効/無効
  • 更新後にあるステータス名のリスト
  • 更新後にあるアクション名のリスト

ステータス名のリスト、アクション名のリストはデフォルトの言語で出力されます。

出力されるログの例

app id: *, app name: *, enable: *, status: [*], actions: [*]

App customize update

アクションが「App customize update」である監査ログについて説明します。

実行された操作

動作テスト環境のアプリに対して、JavaScript / CSSのカスタマイズの設定を変更するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名

出力されるログの例

app id: *, app name: *

Notification update

アクションが「Notification update」である監査ログについて説明します。

実行された操作

動作テスト環境のアプリに対して、アプリ、レコード、またはリマインダーの条件通知の設定を変更するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名

出力されるログの例

app id: *, app name: *

App permission update

アクションが「App permission update」である監査ログについて説明します。

実行された操作

アプリのアクセス権を変更するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • 動作テスト環境の場合:preview

出力されるログの例

運用環境の場合
app id: *, app name: *
動作テスト環境の場合
app id: *, app name: *, preview

Record permission update

アクションが「Record permission update」である監査ログについて説明します。

実行された操作

レコードのアクセス権を変更するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • 動作テスト環境の場合:preview

出力されるログの例

運用環境の場合
app id: *, app name: *
動作テスト環境の場合
app id: *, app name: *, preview

Field permission update

アクションが「Field permission update」である監査ログについて説明します。

実行された操作

フィールドのアクセス権を変更するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • 動作テスト環境の場合:preview

出力されるログの例

運用環境の場合
app id: *, app name: *
動作テスト環境の場合
app id: *, app name: *, preview

App action update

アクションが「App action update」である監査ログについて説明します。

実行された操作

動作テスト環境のアプリに対して、アクション設定を変更するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • 変更後に存在するアクションのリスト

出力されるログの例

app id: *, app name: *, actions: [*]

アクションのリストはカンマ区切りで出力されます。

App category update

アクションが「App category update」である監査ログについて説明します。

実行された操作

アプリのカテゴリーの設定を変更するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名

出力されるログの例

app id: *, app name: *

App move started

アクションが「App move started」である監査ログについて説明します。

実行された操作

アプリの所属スペースを変更するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • 変更前のスペースID
  • 変更後のスペースID

出力されるログの例

app id: *, source space id: *, destination space id: *

Form update

アクションが「Form update」である監査ログについて説明します。

実行された操作

動作テスト環境のアプリに対して、次のAPIを実行した。

  • フィールドの追加
  • フィールドの設定の変更
  • フィールドの削除
  • フォームのレイアウトの変更

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • 追加、変更、または削除したフィールドコード

出力されるログの例

フィールドを追加、変更、または削除した場合
app id: *, app name: *, field code: [*]

フィールドコードはカンマ区切りで出力されます。

フォームのレイアウトを更新した場合
app id: *, app name: *

App view update

アクションが「App view update」である監査ログについて説明します。

実行された操作

動作テスト環境のアプリに対して、一覧の設定を変更するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • 変更後に存在する一覧のリスト

出力されるログの例

app id: *, app name: *, views: [*]

一覧のリストはカンマ区切りで出力されます。

App report update

アクションが「App report update」である監査ログについて説明します。

実行された操作

動作テスト環境のアプリに対して、グラフの設定を変更するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • 変更後に存在するグラフ名のリスト

出力されるログの例

app id: *, app name: *, reports: [*]

グラフ名のリストはカンマ区切りで出力されます。

Record add

アクションが「Record add」である監査ログについて説明します。

実行された操作

レコードを登録するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • レコード番号

出力されるログの例

1件のレコードを登録するAPIを使用した場合
app id: *, app name: *, record id: *
複数のレコードを登録するAPIを使用した場合
app id: *, app name: *, record id: [*]

レコード番号はカンマ区切りで出力されます。

Record update

アクションが「Record update」である監査ログについて説明します。

実行された操作

レコードを更新するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • レコード番号(レコード番号を指定して更新した場合)
  • フィールドコード(フィールドコードと値を指定して更新した場合)
  • 指定した値(フィールドコードと値を指定して更新した場合)

出力されるログの例

1件のレコードを更新するAPIを、レコード番号を指定して実行した場合
app id: *, app name: *, record id: *
1件のレコードを更新するAPIを、フィールドコードと値を指定して実行した場合
app id: *, app name: *, field: *, value: *
複数のレコードを更新するAPIを実行した場合
app id: *, app name: *, record id: [*], record key: [[field: *, value: *]]

レコード番号、フィールドコード、指定した値はカンマ区切りで出力されます。
レコード番号とレコードキーは、空の場合「[]」と出力されます。

Record delete

アクションが「Record delete」である監査ログについて説明します。

実行された操作

レコードを削除するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • レコード番号

出力されるログの例

app id: *, app name: *, record id: [*]

レコード番号はカンマ区切りで出力されます。

Cursor create

アクションが「Cursor create」である監査ログについて説明します。

実行された操作

レコードを一括取得するためのカーソルを作成するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名

出力されるログの例

app id: *, app name: *

Record comment get

アクションが「Record comment get」である監査ログについて説明します。

実行された操作

レコードのコメントを取得するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • レコード番号
  • コメント番号

出力されるログの例

app id: *, app name: *, record id: *,  comment id: [*]

コメント番号はカンマ区切りで出力されます。

Record comment add

アクションが「Record comment add」である監査ログについて説明します。

実行された操作

レコードのコメントを投稿するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • レコード番号
  • コメント番号

出力されるログの例

app id: *, app name: *, record id: *,  comment id: *

Record comment delete

アクションが「Record comment delete」である監査ログについて説明します。

実行された操作

レコードのコメントを削除するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • レコード番号
  • コメント番号

出力されるログの例

app id: *, app name: *, record id: *,  comment id: *

Record assignees update

アクションが「Record assignees update」である監査ログについて説明します。

実行された操作

レコードの作業者を更新するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • レコード番号

出力されるログの例

app id: *, app name: *, record id: *

Record status update

アクションが「Record status update」である監査ログについて説明します。

実行された操作

レコードのステータスを変更するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • レコード番号

出力されるログの例

1件のレコードのステータスを更新するAPIを実行した場合
app id: *, app name: *, record id: *
複数のレコードのステータスを更新するAPIを実行した場合
app id: *, app name: *, record id: [*]

レコード番号はカンマ区切りで出力されます。

Space add

アクションが「Space add」である監査ログについて説明します。

実行された操作

スペースを作成するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • スペースID
  • スペース名

出力されるログの例

space id: *, space name: *

Space update

アクションが「Space update」である監査ログについて説明します。

実行された操作

スペースの設定を更新するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • スペースID
  • スペース名

出力されるログの例

space id: *, space name: *

Space delete

アクションが「Space delete」である監査ログについて説明します。

実行された操作

スペースを削除するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • スペースID
  • スペース名
  • アプリID
  • アプリ名

出力されるログの例

指定したスペースIDが存在しない場合
space id: *
kintoneシステム管理画面の「利用する機能の選択」で「スペース機能を利用する」がオフになっている場合
space id: *
スペース内にアプリが配置されていなかった場合
space id: *, space name: *
スペース内にアプリが配置されていた場合
space id: *, space name: *, (app id: *, app name: *), (...

Thread comment add

アクションが「Thread comment add」である監査ログについて説明します。

実行された操作

スペース内のスレッドにコメントを投稿するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • スペースID
  • スペース名
  • スレッドID
  • スレッド名
  • コメント番号

出力されるログの例

space id: *, space name: *, thread id: *, thread name: *, comment id: *

Guests delete

アクションが「Guests delete」である監査ログについて説明します。

実行された操作

ゲストユーザーを削除するAPIを実行した。

レベル

情報

「補足」に出力される内容

削除したゲストユーザーのメールアドレスが出力されます。

出力されるログの例

guest user code: *

ゲストユーザーのメールアドレスは、カンマ区切りで出力されます。

Record file download

アクションが「Record file download」である監査ログについて説明します。

実行された操作

レコードの添付ファイルをダウンロードするAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • レコード番号
  • ファイル名

出力されるログの例

app id: *, app name: *, record id: *, filename: *

Webhook notify

アクションが「Webhook notify」である監査ログについて説明します。

実行された操作

APIによる操作でWebhookの通知が送信された。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • レコード番号
  • 通知ID
  • イベントタイプ
  • 送信先サーバーのURL

通知に成功した場合は、次の項目が出力されます。

  • 通知のステータスコード

kintoneのエラーで通知に失敗した場合は、次の項目が出力されます。

  • エラータイプ:CLIENT_ERROR
  • エラーメッセージ

通知を受け取るWebサービスのエラーで通知に失敗した場合は、次の項目が出力されます。

  • エラータイプ:SERVER_ERROR
  • 通知のHTTPステータスコード

出力されるログの例

通知に成功した場合
app id: *, app name: *, record id: *, notification id: *, event type: [ADD_RECORD / ADD_RECORD_COMMENT / UPDATE_RECORD / UPDATE_STATUS], server url: *, status code: *
kintoneのエラーで通知に失敗した場合
app id: *, app name: *, record id: *, notification id: *, event type: [ADD_RECORD / ADD_RECORD_COMMENT / UPDATE_RECORD / UPDATE_STATUS], server url: *, error type: CLIENT_ERROR, error message: *
通知を受け取るWebサービスのエラーで通知に失敗した場合
app id: *, app name: *, record id: *, notification id: *, event type: [ADD_RECORD / ADD_RECORD_COMMENT / UPDATE_RECORD / UPDATE_STATUS], server url: *, error type: SERVER_ERROR, status code: *

Send slack dm

アクションが「Send slack dm」である監査ログについて説明します。

実行された操作

APIによる操作でSlackの通知が送信された。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • レコード番号
  • 通知先のSlackサブドメイン
  • 対象ユーザーのログイン名
  • 対象ユーザーのメールアドレス

通知に成功した場合は、次の項目が出力されます。

  • Slack APIのレスポンスステータスコード

kintoneのエラーで通知に失敗した場合は、次の項目が出力されます。

  • エラータイプ:CLIENT_ERROR
  • エラーメッセージ

通知を受け取るWebサービスのエラーで通知に失敗した場合は、次の項目が出力されます。

  • エラータイプ:SERVER_ERROR
  • エラーになったSlack APIのレスポンスステータスコード
  • エラーメッセージ

出力されるログの例

通知に成功した場合
app id: *, app name: *, record id: *, slack subdomain: *, user: *, Email: *, status code: *
kintoneのエラーで通知に失敗した場合
app id: *, app name: *, record id: *, slack subdomain: *, user: *, Email: *, error type: CLIENT_ERROR, error message: *
通知を受け取るWebサービスのエラーで通知に失敗した場合
app id: *, app name: *, record id: *, slack subdomain: *, user: *, Email: *, error type: SERVER_ERROR, status code: *, error message: *

Plug-in installed

アクションが「Plug-in installed」である監査ログについて説明します。

実行された操作

APIによる操作でkintoneシステム管理にプラグインを読み込んだ。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • プラグインID
  • プラグイン名

出力されるログの例

plugin id: *, plugin name: *

Plug-in updated

アクションが「Plug-in updated」である監査ログについて説明します。

実行された操作

APIによる操作でkintoneシステム管理に読み込まれているプラグインを更新した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • プラグインID
  • プラグイン名

出力されるログの例

plugin id: *, plugin name: *

Plug-in removed

アクションが「Plug-in removed」である監査ログについて説明します。

実行された操作

APIによる操作でkintoneシステム管理からプラグインをアンインストールした。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • プラグインID
  • プラグイン名

出力されるログの例

plugin id: *, plugin name: *

App plugins add

アクションが「App plugins add」である監査ログについて説明します。

実行された操作

アプリにプラグインを追加するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名

出力されるログの例

app id: *, app name: *

Plugin config update

アクションが「Plugin config update」である監査ログについて説明します。

実行された操作

アプリに追加されているプラグインの設定情報を変更するAPIを実行した。

レベル

情報

「補足」に出力される内容

次の項目が出力されます。

  • アプリID
  • アプリ名
  • プラグインID

出力されるログの例

app id: *, app name: *, plugin id: *

プロパティ

監査ログの「補足」欄に出力されるプロパティは次のとおりです。

actions

アプリアクションのリストです。

app id

アプリのIDです。

app name

アプリ名です。

comment id

コメント番号です。

Email

メールアドレスです。

enableBulkDeletion

レコードの一括削除機能の設定値です。
状態は下記のどちらかです。

  • 有効にした:true
  • 無効にした:false

enableComments

レコードのコメント機能の設定値です。
状態は下記のどちらかです。

  • 有効にした:true
  • 無効にした:false

enableDuplicateRecord

レコードの再利用設定の設定値です。

  • 有効にした:true
  • 無効にした:false

enableThumbnails

サムネイルを表示する機能の設定値です。 状態は下記のどちらかです。

  • 有効にした:true
  • 無効にした:false

error message

エラーメッセージです。

error type

エラータイプです。次のエラータイプが出力されます。

  • CLIENT_ERROR:kintone側のエラーが原因で失敗している場合に出力されます。
  • SERVER_ERROR:通知を受け取るWebサービス側のエラーが原因で失敗している場合に出力されます。

event type

イベントタイプです。次のイベントタイプが出力されます。

  • ADD_RECORD:レコードの追加
  • ADD_RECORD_COMMENT:レコードコメントの追加
  • UPDATE_RECORD:レコードの更新
  • UPDATE_STATUS:ステータスの更新
  • DELETE_RECORD:レコードの削除

field code

フィールドコードです。

field

フィールドコードです。

filename

ファイル名です。

firstMonthOfFiscalYear

第一四半期の開始月に設定された値です。

guest user code

ゲストユーザーのメールアドレスです。

notification id

通知IDです。

numberPrecision digits

全体の桁数に設定された値です。

numberPrecision decimalPlaces

小数部の桁数に設定された値です。

numberPrecision roundingMode

小数部の丸めかたの設定の状態が出力されます。

  • 最近接偶数への丸め:HALF_EVEN
  • 切り上げ:UP
  • 切り下げ:DOWN

plugin id

プラグインIDです。

plugin name

プラグイン名です。

preview

動作テスト環境の場合に出力されます。

record id

レコード番号です。

record key

フィールドコードと指定した値のリストです。

reports

グラフ名のリストです。

revert

アプリの設定をキャンセルしたかどうかが出力されます。

  • true:アプリの設定の変更をキャンセルしました。
  • false:アプリの設定の変更を本番環境へ反映しました。

server url

サーバーURLです。

slack subdomain

Slackサブドメインです。

slack workspace

Slack連携を設定した相手先のSlackのURLです。

space id

スペースIDです。

space name

スペース名です。

status code

ステータスコードです。

status

ステータスのリストです。

target

「アプリの設定」で、設定を変更した箇所が出力されます。

thread id

スレッドIDです。

thread name

スレッド名です。

titleField selectionMode

レコードタイトルとして使用するフィールドの設定の状態が出力されます。

  • AUTO:「レコードのタイトルとして利用するフィールド」の設定で「自動設定を利用する」を選択している
  • MANUAL:「レコードのタイトルとして利用するフィールド」の設定で「フィールドを選択する」を選択している

titleField code

レコードタイトルとして指定されているフィールドのフィールドコードです。

user

ログイン名です。

value

指定した値です。

views

一覧のリストです。