kintone APIドキュメント

アプリのアイコンのURLを取得する

目次

アプリのアイコンのURLを取得する

固定リンクがコピーされました

アプリのアイコンのURLを取得します。
このAPIは非同期なAPIです。
同期的に処理したい場合は、次のページを参照してください。

関数

固定リンクがコピーされました

PC／モバイル

kintone.app.getIcons()

引数

固定リンクがコピーされました

引数名 型 必須 説明
apps 配列 必須 アプリIDのリスト
最大で100件のアプリIDを指定できます。

戻り値

固定リンクがコピーされました

戻り値はkintone.Promiseオブジェクトです。
kintone.Promiseオブジェクトの解決時に次の要素をもつオブジェクトの配列が取得できます。

プロパティ名 型 説明
app 数値 アプリID
url 文字列 アイコンURL
URLの形式は、今後のkintoneのアップデートによって変わる可能性があります。
URLは保存せず、画像表示のタイミングでAPIからURLを取得するようにしてください。

利用できる画面

固定リンクがコピーされました

PC

アプリの設定画面およびkintoneシステム管理画面を除くすべての画面で利用できます。

モバイル

すべての画面で利用できます。

サンプルコード

固定リンクがコピーされました

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

(async () => {
  const icons = await kintone.app.getIcons([1, 2]);
  console.log(icons);
  // [
  //   {
  //     app: 1,
  //     url: "アプリIDが1のアプリのアイコンURL"
  //   },
  //   {
  //     app: 2,
  //     url: "アプリIDが2のアプリのアイコンURL"
  //   }
  // ]
  const img = document.createElement('img');
  img.src = icons[0].url;
})();

注意事項

固定リンクがコピーされました

あらかじめkintoneに用意されているアイコンの知的財産権は、cybozu.comサービスご利用規約第22条に定めるとおりサイボウズおよびその供給者に帰属します。
本APIは、kintoneカスタマイズおよびプラグインにおいて同一環境内のアプリを表すためにアイコンを表示する目的のみで使用してください。