2019.06.20こんにちは!ITライターのもり(@moripro3)です!クラウド会計ソフトfreeeのAPIを使って経理業務を自動化する初心者向けシリーズ「はじめてのfreeeAPI」をお届けしています。前回の記事では、最初の一歩としてfreeeAPIとは何か?GAS×freeeAPIで何ができるのか?をお伝えしました。【はじめてのfreeeAPI】GAS×freeeAPIで経理業務を自動化する最初の一歩!GoogleAppsScriptでクラウド会計ソフトfreeeのAPIを操作するシリーズ。APIで何ができるのか?を紹介しています。freeeAPIを活用することで手作業の自動化・外部アプリケーションとの連携が可能になります。tonari-it.com2019.06.06早くfreeeAPIを使ってみたいとワクワクしている皆さま、少々お待ちくださいませ。これを使うためには、GASとfreeeを繋ぐための設定が必要なのです。そこで今回の記事では「GASとfreeeを連携する手順」を一からやさしく紹介していきます。下記図の赤枠部分、スプレッドシート(GAS)とfreeeをつなぐ「橋」を構築するイメージです。所用時間は20~30分ほどですので、実際に操作してみながらお付き合いください。ラクにする」と考えて頑張っていきましょう!もり途中でうまくいかない部分があったら、私もり(@moripro3)宛に、お気軽にDMください!可能な範囲で対応いたします。※もちろん当記事のコメント欄でも承ってます(この記事はfreee株式会社さまとのコラボ企画です。APIとは、GASなどのプログラミング言語でfreeeを操作する仕組みです。「外部のプログラム」から直接「freeeの機能」を操作する出入口のようなイメージで、CSVファイルを経由しなくても、直接スプレッドシートのデータをやりとりできます。API】GASを用いてGoogleスプレッドシートと連携するまた、Gmail・カレンダーなどのGoogleサービスや、Chatworkなどの外部アプリケーションとの連携ができることもお伝えしました。GASとfreeeを連携するそれではスプレッドシート(GAS)とfreeeを連携していきましょう。大きく下記の2ステップで進めていきます。GASとfreeeを連携させるための「freeeマイアプリ(*)」を作成するfreeeアカウントと「freeeマイアプリ」を連携認証する(*)freeeマイアプリとは、freeeアプリストアに公開されているアプリではなく、freeeアプリストアで自分で作成するオリジナルアプリのことです。通常は、私たち人間がfreeeの画面を操作して、freeeのデータにアクセスしています。「人間が画面を操作する」代わりに、「GASがfreeeAPIを操作する」ことで、freeeのデータにアクセスします。GASがfreeeAPIを操作する(連携する)ために必要なのが「freeeマイアプリ」です。それでは事前準備から進めましょう。(事前準備)スプレッドシートの用意まず、freeeと連携させるためのスプレッドシートを用意します。経理業務などでデータを蓄積しているスプレッドシートがあれば、それを使っても大丈夫です。スクリプト単体でもよいですが、実務では「スプレッドシートのデータをfreeeとやりとりする」ことを想定するため、ここではコンテナバインドスクリプトを用意します。※当シリーズは、GASを少し触ったことがある初心者を対象としております。スクリプトエディタの操作が初めての方は、こちらの記事を併せてご覧ください。Scriptのプログラミングの一通りの流れと書き方について学ぶシリーズです。今回は、その最初の一歩としてスプレッドシートからスクリプトエディタを開く手順をお伝えします。tonari-it.com2018.03.11スプレッドシートからスクリプトエディタを開きます。スクリプトエディタを開いたら、「ファイル→プロジェクトのプロパティ」で「スクリプトID」を確認します。スクリプトIDとは、GoogleAppsの各スクリプトに一意に定められているIDです。メールアドレスのように、世界中で重複することなくスクリプトごとに割り振られています。冒頭で、freeeマイアプリは「GASとfreeeを連携させるためのアプリ」と紹介しました。xxxxxxのスクリプトと連携してね」と登録する必要があります。この登録作業は後ほど行いますので、スクリプトIDを確認したら、メモ帳などにコピー貼り付けしておきましょう。コードは書かないので、エディタは空のままでよいです。スクリプトエディタは後続の作業で使うので、そのまま開いておきましょう。最初のステップ、「GASとfreeeを連携するためのアプリ」を作成します。アプリストアへのアクセスと事業所選択お持ちのfreeeアカウント、もしくは、ソーシャル連携でfreeeにログインします。(普段のログイン方法です)freeeにログイン済みの状態で、freeeアプリストアの開発者ページにアクセスします。1つのfreeeアカウントで複数の事業所を管理している方は、ログイン中の事業所を確認します。事業所を切り替える場合は、赤枠部分をクリックします。切り替える事業所を選択します。「アプリ管理」をクリックします。「開発アプリ一覧」右上の「+新規追加」をクリックします(お使いの環境によっては、この画面が出ないこともあります)「新しいアプリの作成」画面にて、下記1~4の順番で基本情報を登録します。1アプリ名を入力2概要を入力3利用規約を読んで同意4作成をクリックアプリ名と概要の文言は後から変更できるので、あまり悩まず登録しましょう。コールバックURLの登録つづいて、freeeアプリに「コールバックURL」を登録します。コールバックとは、コール(呼び出す)バック(戻る)です。コールバックURLとは、「freeeへログイン認証できたら、ここに返ってきてね」というURLです。GASでfreeeにログインしたら、その応答は自分(GAS)に返してほしいので、URLにGASのスクリプトを指定します。そこで、さきほど確認したスクリプトIDが必要になるのです。freeeアプリの「コールバックURL」の項目に初期値がセットされているので、値を上書きします。コールバックURLの形式がこちらです。スクリプトIDの部分に、事前準備で確認したスクリプトIDをあてはめましょう。https://script.google.com/macros/d/スクリプトID/usercallback1コールバックURLを入力2下書き保存をクリック【ステップ2】freeeアカウントとfreeeマイアプリの連携ここまでで、freeeマイアプリの作成が終わり、連携する準備が整いました。次のステップ「freeeアカウントとfreeeマイアプリの連携」です。OAuth認証の仕組みGASとfreeeアプリを連携させるために、OAuth(オーオース)という認証の仕組みを使います。OAuthとは、「認可されたアプリしかAPIを操作できないよう、APIを守る仕組み」です。他人が作成したfreeeアプリによって、自分の事業所データが操作されたら困りますよね。この認証の仕組みを使用することで、悪意あるアプリによって勝手に操作されないよう守ってくれるのです。OAuthの仕組みは非常に難しいので、詳しく理解できなくても問題ありません。説明)をご覧になってみてください。Scriptというライブラリを使用します。ライブラリとは、難しい処理を簡単に実現できる仕組みです。詳しくはこちらの記事をご参照ください。ScriptのシリーズとしてチャットワークのBotの作り方についてお伝えしています。今回はライブラリとは何か、またその追加の仕方についてお伝えしていきます。tonari-it.com2018.05.08OAuth2ライブラリの登録それではライブラリの登録をしていきましょう。スクリプトエディタで「リソース→ライブラリ」を選択します。Scriptライブラリのプロジェクトキーを入力し、追加をクリックします。認証用のGASコードここから、スクリプトエディタにコードを書いていきます。デフォルトで存在するmyFunction関数は不要なので削除しておきましょう。GASとfreeeアプリを連携する作業は、画面上の操作ではなく、GASによって行います。その認証用コードがこちらです。HtmlService.createHtmlOutput('認証に成功しました。タブを閉じてください。HtmlService.createHtmlOutput('認証に失敗しました。HtmlService.createHtmlOutput('認証に成功しました。タブを閉じてください。HtmlService.createHtmlOutput('認証に失敗しました。IDとClientSecretを設定します。IDとClientSecretは、下記の操作でコピーできます。IDとClientSecretは、GASでfreeeに接続するためのIDとパスワードです。第三者に知られないよう気をつけましょう。認証の実行スクリプトに3つの関数が存在します。この中の関数「Auth」を実行します。下記1~3の手順でAuth関数を選択しましょう。ここで登場する「承認が必要です」のメッセージは、freeeの認証に関するものではありません。GASユーザの皆さまお馴染みの件です。通常どおり、許可しましょう。関数の実行が完了すると、認証用のURLが発行されます。はじまるURLが「認証URL」です。赤枠部全体をコピーしましょう。Chrome等のブラウザを開き、URL入力欄に認証URLを貼り付けてアクセスします。「アプリ連携の開始」という画面が登場します。通常は、私たち人間が「freeeアカウント」を使用してfreeeにログインし、画面を操作してデータを登録したり、出力します。ここでは、「freeeアプリが、あなたの代わりにfreeeアカウントを使ってログインし、freeeのデータを操作しますが、よろしいですか?」と聞かれているのです。OKなので「許可する」をクリックします。新しいタブが登場し、「認証に成功しました」のメッセージが登場したら完了です!以上の作業で、freeeマイアプリでGASとfreeeをつなぐ一連の流れが完成しました。API」の第2回目では、GASとfreeeを連携させる手順を紹介しました。今回は「freeeマイアプリ」がポイントでしたね。「freeeマイアプリとは、GASとfreeeをつなぐためのアプリである」くらいのふんわりとした理解で大丈夫です。GASとfreeeを連携させるための「freeeマイアプリ」を作成するGASと「freeeマイアプリ」を連携認証させるさぁ、これでGASでfreeeAPIを操作するための準備が整いました。次回は、いよいよGASでfreeeのデータを取得してみますよ!【はじめてのfreeeAPI】GASでリクエストを送りfreeeの事業所一覧を取得するGoogleAppsScriptでクラウド会計ソフトfreeeのAPIを操作するシリーズ。GETリクエストでfreeeの事業所一覧を取得するコードと、freeeAPIリファレンスの読み方を紹介しています。tonari-it.com2019.06.26連載目次:【GAS初心者向け】はじめてのfreeeAPIGoogleAppsScriptを使用して「クラウド会計ソフトfreee」のAPIを操作する初心者向けシリーズ。APIで何ができるのか?連携方法は?を紹介しています。APIを操作してデータの取得・更新をしてみましょう。VBAを専門とするITライターです。退屈なことはプログラミングで片づけよう!自らの事務職経験を活かし、事務作業をとことんラクにできるITネタを発信していきます。「コミュニティ+講座」形式で継続性&教え合える環境も提供。!ノンプログラマーがプログラミングスキルを身に着ける支援ををするコミュニティ。セミナー・もくもく会・Facebookグループのサポートで「自らで学び続ける力をつける」支援、「教え合うことで学びの価値を上げる」場の提供をしています。Appsスプレッドシートのマクロ記録時の絶対参照と相対参照の違いとはGoogleスプレッドシートに搭載されたマクロ記録の機能について初心者向けに解説をしています。今回はスプレッドシートでのマクロ記録時の絶対参照と相対参照の違いについて書き出されたコードを見ていきます。Scriptでスプレッドシートのデータは二次元配列として操作できますが、列方向に検索したいときなどはUnderscoreのzipメソッドで行と列を入れ替えると革命的に便利です。Script【GAS×freeeAPI】スプレッドシートのデータからチャットワーク通知用の本文を作成する「当日入金予定の取引一覧を自動でチャットワークに送信する」シリーズの第6回目。スプレッドシートの値を取得して文字列結合し、チャットワークに通知する本文を作成します。Scriptで名言Botの作り方を解説しております。今回は、GASでPropertiesサービスを使ってスクリプトプロパティからデータを取り出す方法です。多くの企業が導入しているクラウド型チャットサービスであるチャットワーク。SQLのデータベースにアクセスする方法をシリーズでお伝えしています。SQLインスタンスに接続する方法です。「コミュニティ+講座」形式で継続性&教え合える環境も提供。詳細・お申込はこちら隣ITを応援する当ブログを「応援したい!」「役に立ったよ!」というお気持ちを、コチラからお支払いただくことができます。日々更新の活力倍増いたします。※PayPalアカウントが必要です。※金額は変更可能です。Platform23HTML・CSS32iPhone・アプリ29Monaca・スマホアプリ開発7PC全般・Windows86PowerPoint・VBA28Python87RPA1VBScript15Vue.js・JavaScript13WEBサービス・クラウド68WordPress・ブログ88Word・VBA42コミュニティ・イベント108セミナーのお知らせ11チャットワーク72データ分析・アクセス解析40仕事・生産性・働き方73動画配信8商業出版21起業・フリーランス72電子書籍・Kindle3運営会社プランノーツは"IT×働き方改革"をお手伝いする会社です。「コミュニティ+講座」形式で継続性&教え合える環境も提供。詳細・お申込はこちら隣ITを応援する当ブログを「応援したい!」「役に立ったよ!」というお気持ちを、コチラからお支払いただくことができます。日々更新の活力倍増いたします。※PayPalアカウントが必要です。※金額は変更可能です。Platform23HTML・CSS32iPhone・アプリ29Monaca・スマホアプリ開発7PC全般・Windows86PowerPoint・VBA28Python87RPA1VBScript15Vue.js・JavaScript13WEBサービス・クラウド68WordPress・ブログ88Word・VBA42コミュニティ・イベント108セミナーのお知らせ11チャットワーク72データ分析・アクセス解析40仕事・生産性・働き方73動画配信8商業出版21起業・フリーランス72電子書籍・Kindle3運営会社プランノーツは"IT×働き方改革"をお手伝いする会社です。RowSourceプロパティとAddItemメソッド2020.01.21GASでGoogleスライドのSlideオブジェクトの概要とその取得方法2020.01.162020.01.24Facebookページいつも隣にitのお仕事タイトルとURLをコピーしました。