アプリの一般設定を変更します。
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 | 文字列 | 条件必須 | アイコンの種類を、次のいずれかで指定します。
|
| icon.key | 文字列 | 条件必須 |
「icon.type」パラメータに「PRESET」を指定した場合に、使用するアイコンの識別子*を指定します。 |
| icon.file | オブジェクト | 条件必須 | アイコンのファイル情報を表すオブジェクトです。このパラメータは、「icon.type」パラメータに「FILE」を指定した場合に指定します。 |
| icon.file.fileKey | 文字列 | 条件必須 | 次のAPIでアップロードしたファイルのキーを指定します。 ファイルのアップロード 800KBまでのファイルをアップロードできます。「icon.type」パラメータに「FILE」を指定する場合、このパラメータは必須です。 |
| theme | 文字列 |
デザインテーマです。
※以前提供していたテーマの 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サンプル
XMLHttpRequest
icon.type==PRESETのときicon.keyが必須項目になっているので情報の修正をお願いいたします。