GASでマネーフォワードクラウド請求書の請求書一覧をスプレッドシートに書き出す方法

photo credit: romanlily 11/15/13 – spreadsheet season via photopin (license)

みなさん、こんにちは！
タカハシ(@ntakahashi0505)です。

GASによるマネーフォワードクラウド請求書APIの操作についてできる限りていねいに紹介をするシリーズをお送りしています。

前回の記事はこちら。

GASでマネーフォワード請求書の請求書一覧を取得するスクリプト

GASによるマネーフォワードクラウド請求書APIの操作についてできる限りていねいに紹介をするシリーズです。今回は、GASでマネーフォワード請求書の請求書一覧を取得するスクリプトについてお伝えしていきます。

マネーフォワードクラウド請求書から請求書一覧を取得するスクリプトを紹介しました。

ただ、請求書一覧のJSONデータをそのままログに書き出すだけでしたので、スプレッドシートに書き出していきたいと思います。

今回は、GASでマネーフォワードクラウド請求書の請求書一覧をスプレッドシートに書き出す方法です。

では、行ってみましょう！

前回のおさらい
請求書一覧をスプレッドシートに書き出すスクリプト
請求書データを表すJSONデータからデータを取り出す
データを二次元配列化してスプレッドシートに書き出す
まとめ
連載目次：【初心者向け】GASでマネーフォワード請求書API

前回のおさらい

前回紹介したスクリプトはこちらでした。

function getBillings() {

  const accessToken = getMFInvoiceService_().getAccessToken();

  const baseUrl = 'https://invoice.moneyforward.com/api/v2/billings';
  const params = {
    method: 'get',
    headers: {
      accept: 'application/json',
      Authorization: 'Bearer ' + accessToken
    }
  };
  
  const requestUrl = baseUrl;
  const response = UrlFetchApp.fetch(requestUrl, params); 
  console.log(response.getContentText());
}

マネーフォワードクラウド請求書にリクエストを行うもので、ログを確認すると以下のように請求書一覧のデータを確認できます（モザイクばかりですが…汗）。

今回は、これらのデータをスプレッドシートに書き出していきたいと思います。

ちなみに、OAuth2ライブラリの導入や、アプリケーションの作成、認証とアクセストークンの取得は終えているものとしています。

まだの方は、この記事あたりからシリーズを参考におさらいしてくださいね。

請求書一覧をスプレッドシートに書き出すスクリプト

早速ですが、前述のスクリプトを修正して請求書一覧をスプレッドシートに書き出すスクリプトを作成しました。

こちらです！

function getBillings() {

  const accessToken = getMFInvoiceService_().getAccessToken();

  const baseUrl = 'https://invoice.moneyforward.com/api/v2/billings';
  const params = {
    method: 'get',
    headers: {
      accept: 'application/json',
      Authorization: 'Bearer ' + accessToken
    }
  };
  
  const requestUrl = baseUrl;
  const response = UrlFetchApp.fetch(requestUrl, params); 
  
  const values = [];  
  const billings = JSON.parse(response.getContentText());
  const {data, meta} = billings;
  
  for (const billing of data) {
    const {id, attributes} = billing;
    const {office_name, partner_name, title, total_price, sales_date, due_date} = attributes;
    const record = [id, office_name, partner_name, title, total_price, sales_date, due_date];
    values.push(record);
  }
  
  SpreadsheetApp.getActiveSheet().getRange(1, 1, values.length, values[0].length).setValues(values);
}

15行目までは、前回のスクリプトと一緒ですね。

それ以降に処理を追加していますので、解説をしていきましょう。

請求書データを表すJSONデータからデータを取り出す

まず、請求書一覧データはJSON形式で受け取っていまして、こちらの記事でもお伝えしている通り、以下のような構造になっています。

{
  "data": [
    {
      "id": ID,
      "attributes": {
        "office_name": 事業所名,
        "partner_name": 取引先名,
        "title": 件名,
        "total_price": 税込価格,
        "sales_date": 売上計上日,
        "due_date": 支払日
      }
  },
  …
 "meta" : {
    "total_count": 件数,
    "total_pages": 全ページ数,
    "current_page": 現在のページ数,
    "per_page": 1ページあたりの件数
  }
}

dataの中に配列の要素として請求書が100件あり、その中にidとattributesが、そしてさらにそのattributesの配下にいろいろな情報が格納されています。

ここからほしいデータを取り出していきますから、よくこの構造を覚えておいてくださいね。