ノンプロ研初心者向け講座【GAS+freee APIコース】第2期・第9回「データの取得」

もり@テックライター📙 @moripro3

20時～ GAS+freeeAPIコース（第2期）の9回目！ テーマは「データの取得」です。 パラメーターを設定して、検索条件を絞る方法を学びます！ 【freee APIパート】 7．HTTP通信・API 8．freee APIとリクエストの基礎 9．データの取得👈 10．データの登録 #ノンプロ研 #GAS_freeeAPI講座 #freeeAPI pic.twitter.com/mZv48hgl1Z

拡大

kiriharaHiro 電子工作とIoT_ICT活用を勉強中 @KiriharaHiro

#ノンプロ研 #GAS_freeeAPI講座　始まりました。 今日も講座Zoomホストを担当させて頂きます。

Jun FUJIKI | be a good friend @bagoodfriendJP

今日も #ノンプロ研 で#GAS_freeeAPI講座 です！TA（ティーチングアシスタント）させて頂いてますー。 twitter.com/moripro3/statu…

kiriharaHiro 電子工作とIoT_ICT活用を勉強中 @KiriharaHiro

TAのfujikiさん　freeeAPIで請求書一括照合に使われているそうです。 紙無しでPC画面上に一気に開けて効率的。 #ノンプロ研 #GAS_freeeAPI講座

Jun FUJIKI | be a good friend @bagoodfriendJP

アイスブレイクが電子契約と固定電話置き換え（クラウドPBX）で盛り上がった。 #ノンプロ研 #GAS_freeeAPI講座

Jun FUJIKI | be a good friend @bagoodfriendJP

さて、今日はいよいよfreeeから取引データを取得していきます！webでも見られるじゃん！って思いますよね？でもGASだと時刻指定で定期実行とかできちゃうんです。そして、怪しい取引だけ絞り込んでSlackとかChatWorkに通知とかもできちゃうんです。 #ノンプロ研 #GAS_freeeAPI講座

kiriharaHiro 電子工作とIoT_ICT活用を勉強中 @KiriharaHiro

今日のFreeeAPIで取り扱うJSONのデータ構造は前回と違って複雑らしい。 #ノンプロ研 #GAS_freeeAPI講座

Jun FUJIKI | be a good friend @bagoodfriendJP

APIで取りたいデータ別にそれぞれこのデータちょうだいねーとリクエストするURLが用意されています。それらはfreeeの会計リファレンスのページに書かれています。 developer.freee.co.jp/docs/accountin… #ノンプロ研 #GAS_freeeAPI講座

kiriharaHiro 電子工作とIoT_ICT活用を勉強中 @KiriharaHiro

freeeAPI の取引データへのアクセスは公式リファレンスの Deals を参照します。 #ノンプロ研 #GAS_freeeAPI講座

kiriharaHiro 電子工作とIoT_ICT活用を勉強中 @KiriharaHiro

Transfers も取引ですが、こちらは振替になります。 #ノンプロ研 #GAS_freeeAPI講座

kiriharaHiro 電子工作とIoT_ICT活用を勉強中 @KiriharaHiro

Deals の方の取引は（収入/支出）の方です。 #ノンプロ研 #GAS_freeeAPI講座

Jun FUJIKI | be a good friend @bagoodfriendJP

そして実は…の裏技なのですが、通常のfreeeでも secure.freee.co.jp/docs_v2/invoic…「ここに請求書ID」/edit みたいに請求書IDをURLに入れて直接その請求書に飛べます。 #ノンプロ研 #GAS_freeeAPI講座

Jun FUJIKI | be a good friend @bagoodfriendJP

secure.freee.co.jp/deals#deal_id=「ここに取引ID」 これ以外にも絞り込み条件とかもURLはパラメーター的規則性があるので、その規則性を理解すると、いきなり見たい画面にジャンプできます。 #ノンプロ研 #GAS_freeeAPI講座

Jun FUJIKI | be a good friend @bagoodfriendJP

最初の写経は、まずは取引データのレスポンスを取得してみよう！という演習です。どわわーっと出てきて目がチカチカします。 #ノンプロ研 #GAS_freeeAPI講座

Jun FUJIKI | be a good friend @bagoodfriendJP

普段からfreeeを使い慣れている（事業所を切り替えたりしている）と事業所IDと聞くとfreeeの画面で確認できる、「事業所番号」のことと思いますよね。freeeAPIで使う事業所IDは実は別物で、freeeの画面では確認できない、freeeが裏で持っている事業所のIDなんです。 #ノンプロ研 #GAS_freeeAPI講座

kiriharaHiro 電子工作とIoT_ICT活用を勉強中 @KiriharaHiro

事業所コードは前回取得した7桁のコードでしたね。 freee画面右上の「開発用テスト事業所」の下にある 「事業所番号：123-456-7890」ではなかった！ #ノンプロ研 #GAS_freeeAPI講座

kiriharaHiro 電子工作とIoT_ICT活用を勉強中 @KiriharaHiro

取得レコードの件数 パラメータを複数指定するには、 Parm1 = value1&Parm2 = value2&Parm3 = value3 という風に書いていくんだ。 #ノンプロ研 #GAS_freeeAPI講座

Jun FUJIKI | be a good friend @bagoodfriendJP

次の演習は、取引データの取得数を3件に絞り込みます。limitのパラメータで絞り込みますが、指定しない場合は20件、指定最大値は100件です。100件以上の時は、ページをめくるみたいにオフセットというパラメータを利用します。 #ノンプロ研 #GAS_freeeAPI講座

kiriharaHiro 電子工作とIoT_ICT活用を勉強中 @KiriharaHiro

JSON整形ツール頭いいですね！ lab.syncer.jp/Tool/JSON-View… #ノンプロ研 #GAS_freeeAPI講座

Jun FUJIKI | be a good friend @bagoodfriendJP

freeeの取引データのう構造は複雑です。オブジェクトの中にdelasとmetaの2つのプロパティがあって、dealsの中に配列があって、その配列の要素が0,1,2というオブジェクトになっていて、さらにその中に…あーーー💥 #ノンプロ研 #GAS_freeeAPI講座

kiriharaHiro 電子工作とIoT_ICT活用を勉強中 @KiriharaHiro

取引データは1取引1データのオブジェクトになっている。 #ノンプロ研 #GAS_freeeAPI講座

Jun FUJIKI | be a good friend @bagoodfriendJP

受講生さんの眉間のシワが…🗻 #ノンプロ研 #GAS_freeeAPI講座

kiriharaHiro 電子工作とIoT_ICT活用を勉強中 @KiriharaHiro

getDeals_03 の結果！　 freeeAPIから応えが帰ってきました。 21:17:25情報発生日：2021-11-30 21:17:25情報金額：12960 さっきから答えてくれていたのにデータが多すぎて読み取れていなかったわけですね。 #ノンプロ研 #GAS_freeeAPI講座

kiriharaHiro 電子工作とIoT_ICT活用を勉強中 @KiriharaHiro

const response = UrlFetchApp.fetch(url, params).getContentText(); const obj = JSON.parse(response); //parseでJSONデータをオブジェクトに変換してる #ノンプロ研 #GAS_freeeAPI講座

kiriharaHiro 電子工作とIoT_ICT活用を勉強中 @KiriharaHiro

取引データは1取引1オブジェクトになっている。 が正しい表現かな。 #ノンプロ研 #GAS_freeeAPI講座