一覧の設定の変更

アプリの一覧の設定を変更します。

URI

https://(サブドメイン名).cybozu.com/k/v1/preview/app/views.json

ゲストスペースのアプリの場合：https://(サブドメイン名).cybozu.com/k/guest/(スペースのID)/v1/preview/app/views.json

HTTPメソッド

PUT

アクセス権

• アプリに管理権限が必要です。
• このAPIの実行には、APIトークンは使用できません。

リクエスト

パラメータ

指定するパラメータの一覧です。省略したパラメータの設定は変更されません。

パラメータ名	指定する値	必須	説明
app	数値	必須	アプリのIDを指定します。
views	オブジェクト	必須	一覧の設定を表すオブジェクトです。複数の一覧を指定します。
views.（一覧名）	オブジェクト	必須	各一覧の設定を表すオブジェクトです。「（一覧名）」には更新前の一覧名を指定します。 存在しない一覧を「（一覧名）」に指定した場合は、新規の一覧として追加します。
views.（一覧名）.index	文字列	必須	一覧の表示順を数字で指定します。指定した数字の昇順に、一覧が並びます。
views.（一覧名）.type	文字列	必須	一覧の表示形式を指定します。 表形式の場合：LIST カレンダー形式の場合：CALENDAR カスタマイズ形式：CUSTOM
views.（一覧名）.name	文字列	条件必須	一覧の名前を、64文字以内で指定します。新しい一覧を追加する場合は必須となり、「views（一覧名）」のキー名と同じ値を指定します。
views.（一覧名）.fields	配列		表形式の一覧で、表示する各フィールドのコードを指定します。
views.（一覧名）.date	文字列		カレンダー形式の一覧で、日付として使用するフィールドのコードを指定します。省略すると、更新日時フィールドが指定されます。
views.（一覧名）.title	文字列		カレンダー形式の一覧で、タイトルとして使用するフィールドのコードを指定します。省略すると、レコード番号フィールドが指定されます。
views.（一覧名）.html	文字列		カスタマイズ形式の一覧で、カスタマイズに使用するHTMLの内容を指定します。
views.（一覧名）.pager	真偽値		カスタマイズ形式の一覧で、ページネーションを表示するかどうかを指定します。 表示する場合（初期設定）：true 表示しない場合：false
views.（一覧名）.device	文字列		カスタマイズ形式の一覧で出力されます。一覧を表示する範囲です。 指定せず一覧の設定を追加する場合はDESKTOPが設定されます。 指定せず一覧の設定を更新する場合は変更されません。 DESKTOP：PC版のみで表示する ANY：PC版とモバイル版で表示する
views.（一覧名）.filterCond	文字列		レコードの絞り込み条件をクエリ形式で指定します。クエリ形式については、次のページを参照してください。 レコードの一括取得（クエリで条件を指定）
views.（一覧名）.sort	文字列		レコードのソート条件をクエリ形式で指定します。クエリ形式については、次のページを参照してください。 レコードの一括取得（クエリで条件を指定）
revision	数値		アプリの設定を変更する前のリビジョン番号を指定します。指定したリビジョンが最新ではない場合、リクエストはエラーになります。 指定を省略、または「-1」を指定すると、リビジョンはチェックされません。

リクエストの例

ヘッダ

PUT /k/v1/preview/app/views.json HTTP/1.1
Host: example.cybozu.com:443
X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=
Authorization: Basic QWRtaW5pc3RyYXRvcjpjeWJvenU=
Content-Type: application/json

ボディ

レスポンス

パラメータ

パラメータ名	値の種類	説明
revision	文字列	アプリの設定を変更したあとのリビジョン番号です。
views	オブジェクト	一覧の情報を表すオブジェクトです。
views.（一覧名）.id	文字列	ビューのIDです。

レスポンスの例

JavaScriptサンプル

kintone REST API

XMLHttpRequest

制限事項

アプリ内で、リクエストで指定した一覧と同じ名前の一覧が存在する場合、このAPIで設定を変更することができません。