カテゴリー内の他の記事

一般設定の変更

フォローする

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

URI

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

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

HTTPメソッド

PUT

アクセス権

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

リクエスト

パラメータ

リクエストのパラメータの一覧です。指定を省略したパラメータの設定項目は、更新されません。

パラメータ 指定する値 必須 説明
app 文字列 必須 アプリのIDを指定します。
name 文字列   アプリの名前を64文字以内で指定します。
description 文字列   アプリの説明を10,000文字以内で指定します。HTMLタグを使用できます。
icon オブジェクト   アプリのアイコンの情報を表すオブジェクトです。
icon.type 文字列 条件必須 アイコンの種類を、次のいずれかで指定します。
  • kintoneに組み込みのアイコンを使用する場合:PRESET
  • 画像をアップロードする場合:FILE
「icon」パラメータを指定する場合、このパラメータは必須です。
icon.key 文字列 条件必須

「icon.type」パラメータに「PRESET」を指定した場合に、使用するアイコンの識別子*を指定します。

icon.file オブジェクト 条件必須 アイコンのファイル情報を表すオブジェクトです。このパラメータは、「icon.type」パラメータに「FILE」を指定した場合に指定します。
icon.file.fileKey 文字列 条件必須 次のAPIでアップロードしたファイルのキーを指定します。
ファイルのアップロード
800KBまでのファイルをアップロードできます。「icon.type」パラメータに「FILE」を指定する場合、このパラメータは必須です。
theme 文字列  

デザインテーマです。

  • WHITE
  • RED
  • BLUE
  • GREEN
  • YELLOW
  • BLACK

※以前提供していたテーマの CLIPBOARD,BINDER, PENCIL, CLIPS を指定した場合、WHITEのテーマで表示されます。

revision 数値又は文字列   アプリの設定を変更する前のリビジョン番号を指定します。指定したリビジョンが最新ではない場合、リクエストはエラーになります。
指定を省略、または「-1」を指定すると、リビジョンはチェックされません。

*:アイコンごとの識別子を確認するには、アプリの一般設定取得APIで取得したレスポンスのicon.keyパラメータを使用します。

リクエストの例

ヘッダ
PUT /k/v1/preview/app/settings.json HTTP/1.1
Host: example.cybozu.com:443
X-Cybozu-Authorization: QWRtaW5pc3RyYXRvcjpjeWJvenU=
Authorization: Basic QWRtaW5pc3RyYXRvcjpjeWJvenU=
Content-Type: application/json
ボディ

レスポンス

パラメータ

パラメータ名 値の種類 説明
revision 文字列 アプリの設定を変更したあとのリビジョン番号です。

レスポンスの例

JavaScriptサンプル

kintone REST API

XMLHttpRequest

記事に関するフィードバック

直接的に記事と関連がないご質問はcybozu developer コミュニティをご活用ください。

Avatar
草間 豪雄

icon.type==PRESETのときicon.keyが必須項目になっているので情報の修正をお願いいたします。

ログインしてコメントを残してください。
Powered by Zendesk