![見出し画像](https://assets.st-note.com/production/uploads/images/143308985/rectangle_large_type_2_a852c982d2d630f5861881cf85691e58.png?width=1200)
Google Apps Script(GAS)を利用して、kintone(キントーン)とスプレッドシートをAPI連携してみた
今回はkintone(キントーン)とスプレッドシートをAPI連携してみたいと思います。
kintoneで運用を開始すると便利さゆえにどうしてもエクセルやCSV、スプレッドシートにデータを反映したくなります。ここではGASを利用して、具体的に、kintoneのデータを、必要な時に、スプレッドシートに取り込む方法を紹介します。
事前必要項目
①kintone(キントーン) スペースまたはアプリの管理権限
②google 一般的なアカウントが必要
kintoneアプリの作成
GASとAPI連携するために、まずはkintoneアプリの設定をしていきます。
既存のアプリでも構いませんが、ここではアプリを作成するところから始めていきます。アプリの作成や設定には、スペースやアプリの管理権限が必要になります。権限のない方はkintone管理者に問い合わせてみてください。
kintoneを開いて、アプリの「+」マークをクリックしてください。
![](https://assets.st-note.com/img/1717924469961-DusOmzZm2J.png)
![](https://assets.st-note.com/img/1717928774404-EEjuSnErLs.png?width=1200)
今回は手っ取り早く連携のイメージをつかむために、既存のテンプレートアプリを使用します。おすすめのアプリから「顧客リスト」を選択してください
![](https://assets.st-note.com/img/1717928878862-HKNVOXFO8D.png)
「サンプルデータを含める」にチェックが入っていることを確認して、
「このアプリを追加」をクリック
![](https://assets.st-note.com/img/1717935617811-y2Y6NCCKM4.png)
![](https://assets.st-note.com/img/1717935713983-Qab0B8hzhZ.png)
追加された「顧客リスト」アプリを開いてみてください
![](https://assets.st-note.com/img/1717935767339-OxrTsCVqJV.png)
![](https://assets.st-note.com/img/1717936872248-oPSe9cLDrT.png?width=1200)
すでにサンプルデータが20件入っています。
このデータをスプレッドシートに反映していきたいと思います。
kintoneアプリ側から必要なデータは3つだけです。
①kintoneドメイン情報
②kintoneアプリのID番号
③kintoneアプリのAPIトークン
以下で取得方法を説明します。
後ほど使用するので、それぞれメモ帳などにコピペしておいてください
kintoneアプリ-①ドメイン情報
kintoneアプリ-②ID番号
①と②は簡単です。
「顧客リスト」アプリのURLを確認してください
[XXXX.cybozu.com/k/YYY/]となっていると思いますが
このXXXX部分が①のドメイン情報になります。(おそらく会社名などが多いかと・・・)
そしてYYYの数字が②のID番号になります。
それぞれメモ帳等にコピペしておいてください。
![](https://assets.st-note.com/img/1717938362919-1VkUGa7ct2.png?width=1200)
kintoneアプリ-③APIトークン
「顧客リスト」アプリの右上「⚙」マークをクリックしてください。
![](https://assets.st-note.com/img/1717939153367-BcfdBFUoFg.png)
右の設定をクリックします
![](https://assets.st-note.com/img/1717939328713-7XHvVIlLZs.png?width=1200)
APIトークンをクリックします
![](https://assets.st-note.com/img/1717939385693-7uZPBci6bq.png?width=1200)
続けて「生成する」をクリックします
![](https://assets.st-note.com/img/1717939829154-zeeiUMBoRe.png?width=1200)
APIトークンが発行されるので同様にメモ帳等にコピペしておいてください
![](https://assets.st-note.com/img/1717940066270-UJPIwChL5a.png?width=1200)
最後に右下の保存ボタンを押してください。
![](https://assets.st-note.com/img/1717940163874-AEfCrwLzdy.png?width=1200)
続けて、アプリを更新します
![](https://assets.st-note.com/img/1717940223074-CeLN0RZbSE.png?width=1200)
![](https://assets.st-note.com/img/1717940333201-59Qwo4GrKH.png)
ここまででkintone側の設定は終了です
Google Apps Script(GAS)の準備
下のリンクからスプシを作成しましょう。googleアカウントない方は作ってログイン。
スプシの名前も何でもオッケーです。左上の「無題のスプレッドシート」をクリックすると簡単に名前を編集できます。
今回は「kintoneテスト」としておきました。
![](https://assets.st-note.com/img/1717942065349-r5zip6tiCv.png)
スプシが作成できたら、次はGoogle Apps Script(GAS)の準備です。
上のメニューから「拡張機能」→「Apps Script」を選択し、GASを起動させてください。こちらも名前は何でも良いのですが、せっかくなのでスプレッドシートの名前と同じにしておきましょう。
![](https://assets.st-note.com/img/1717942134441-kVVsyhZUfD.png)
![](https://assets.st-note.com/img/1717942160815-g9tnOANRGm.png)
![](https://assets.st-note.com/img/1718027029828-btnXDNjlSL.png)
さっそくコードを記入していきます。
初期設定されている「ファイル」の「コード.gs」を選択して、右側に表示された全てのコードを選択します。
![](https://assets.st-note.com/img/1718288341769-QlmShTMzmj.png)
選択したコードに以下のコードをコピペします。
//初期設定
const urlDomain = 'ここ1'; //①ドメイン情報
const appId = ここ2; //②ID番号
const apiToken = 'ここ3'; //③APIトークン
//メニュー追加
function onOpen() {
SpreadsheetApp.getUi()
.createMenu("kintone")
.addItem("kintoneテストより取込む", "getRecords")
.addToUi();
}
//kintoneテストより取込む
function getRecords() {
const activeSpreadSheet = SpreadsheetApp.getActiveSpreadsheet(); // 現在のスプレッドシート
const sheet = activeSpreadSheet.getSheetByName('シート1'); // シート1
sheet.clear();//前回データをクリア
const range = sheet.getRange('A1:I1');
var values = range.setValues([['会社名','部署名','担当者名','郵便番号','TEL','FAX','住所','顧客ランク','メールアドレス']]); //1行目に反映
// kintoneからデータを取得
var paramFields = "&fields=$id," + encodeURIComponent("会社名,部署名,担当者名,郵便番号,TEL,FAX,住所,顧客ランク,メールアドレス"); //取り込みたいデータのフィールドコードを指定
var urlGetRecords = "https://" + urlDomain + ".cybozu.com/k/v1/records.json";
var url = urlGetRecords + "?app=" + appId + paramFields;
var res = JSON.parse(UrlFetchApp.fetch(url, {"method": "get","headers": {"X-Cybozu-API-Token": apiToken}}));
// 取得したデータを整形
var output = [];
res["records"].forEach(function(record){
var row = [];
//先ほど指定したフィールドコードと型を指定
row.push(record["会社名"].value);
row.push(record["部署名"].value);
row.push(record["担当者名"].value);
row.push(record["郵便番号"].value);
row.push(record["TEL"].value);
row.push(record["FAX"].value);
row.push(record["住所"].value);
row.push(record["顧客ランク"].value);
row.push(record["メールアドレス"].value);
output.push(row);
});
// スプレッドシートに出力
sheet.getRange(2, 1, output.length, output[0].length).setValues(output);
}
もちろん、このままでは不十分です。
初期設定部分のコードを書き換える必要があります。
'ここ1' → ①ドメイン情報のXXXX部分を''の間に入力してください
ここ2 → ②ID番号のYYY部分の数字を''なしで入力してください
'ここ3' → ③APIトークンを''の間に入力してください
以下は例です(こちらをコピーしてもエラーになります)
//初期設定
const urlDomain = 'domeinjouhou'; //①ドメイン情報
const appId = 999; //②ID番号
const apiToken = 'H7tw98iajfHofhgJOJOH8t5jogas8t975w879w80w0wuigjsowgso'; //③APIトークン
//メニュー追加
function onOpen() {
SpreadsheetApp.getUi()
.createMenu("kintone")
.addItem("kintoneテストより取込む", "getRecords")
.addToUi();
}
API連携テスト
初期設定部分の書き換えが終わったら、上メニューのデバックの右がonOpenになっていることを確認して、「実行」ボタンを押します
![](https://assets.st-note.com/img/1718290585546-8wgPCYeIwQ.png?width=1200)
すると、承認を求められます。
権限を確認をクリックしてください。
![](https://assets.st-note.com/img/1718290655347-N9z7Dz4fCi.png)
続いて、googleアカウントの確認です。
問題なければログインを選択。
![](https://assets.st-note.com/img/1718290710161-iIWMNB6zQF.png)
このアプリはGoogleで確認されていません
と怖いメッセージが表示されますが、左下の「安全ではないページに移動」をクリックしてください。
![](https://assets.st-note.com/img/1718291452534-QIZeMsBFLe.png?width=1200)
続いて、アカウントの許可を求められたら、許可を選択してください。
![](https://assets.st-note.com/img/1718291623937-yWcKAo8lR0.png)
スクリプトが実行され、ログが表示されます
![](https://assets.st-note.com/img/1718290998542-b2ELgAk0JB.png)
スプレッドシートに戻ると、メニューにkintoneが追加され、さらにkintoneテストより取込むが追加されていることが確認できます。
![](https://assets.st-note.com/img/1718291927476-e9NHr543yk.png?width=1200)
それでは、連携できたか確認しましょう。
メニューの「kintone」をクリックして、さらに「kintoneテストより取込む」をクリックしてみましょう。
「スクリプトを実行しています」と表示されるので、しばらく待ちます。
![](https://assets.st-note.com/img/1718292096437-HSx3ccKgsP.png)
「スクリプトが終了しました」が表示されたら成功です。
![](https://assets.st-note.com/img/1718292164668-Ctihpf9nRB.png)
以下のように反映されていれば成功です
![](https://assets.st-note.com/img/1718292218163-T3qd6EHK4e.png?width=1200)
連携を確認できたら、次は、今回GASで設定したコードとkintoneのフィールド設定を調整することで、実用化へつなげることができると思います。
本記事では、まずはGASとkintoneの連携を体験してみる、ということをコンセプトにやり方の紹介をしてみました。
この記事が気に入ったらサポートをしてみませんか?