GAS x freeeAPIライブラリのトリセツ「自動同期で取得した取引に自動でタグを付与しよう」その1 – 条件で指定した更新対象のfreee取引のみ取得する

function renewBaseDeals01() {

  /* GAS x freeeAPIライブラリの操作オブジェクトを取得する */
  const accessToken = getService().getAccessToken(); // アクセストークンを取得
  const company_id = Number(ScriptProperties.getProperty('COMPANY_ID')); // 事業所IDはプロパティストアに格納
  const deals_freeeAPI = freeeAPI.deals(accessToken, company_id); // freeeAPIライブラリのdeals操作オブジェクトを作成

  /* 前月初日からの取引に絞り込んで取得する */
  const today = new Date(); // 今日のDateオブジェクト
  const beginLastMonth = new Date(today.getFullYear(), today.getMonth() - 1, 1); // 前月初日のDateオブジェクト
  const start_issue_date = Utilities.formatDate(beginLastMonth, 'JST', 'yyyy-MM-dd'); // yyyy-MM-ddの文字列に変換
  deals_freeeAPI.queries.start_issue_date = start_issue_date; // APIリクエストのパラメータの発生日に前月初日を代入
  const allDeals = deals_freeeAPI.getAllDeals(); // 条件に合致する取引オブジェクトを全て取得する

  /* 決済口座：BASE（ECサイト）・取引先：未選択 に該当するオブジェクトを抽出する */
  const trgWalletableId = freeeAPI.walletables(accessToken, company_id).getIdByName('BASE（ECサイト）'); // 口座名から口座IDを取得
  const trgDeals = allDeals.filter(deal => deal.partner_id === null && Array.isArray(deal.payments) && deal.payments.some(payment => payment.from_walletable_id === trgWalletableId));

  console.log(trgDeals); // テストログ出力

}

/**
 * class CalDate
 * カレンダーの色々な日付を生成するクラス
 * 
 * プロパティ
 * date - Dateオブジェクト
 * 
 * メソッド
 * lastSaturday() - 基準日の前回の土曜日のDateオブジェクトを返すメソッド
 * nextSaturday() - 基準日の次回の土曜日のDateオブジェクトを返すメソッド
 * endThisMonth() - 基準日月末日のDateオブジェクトを返すメソッド
 * endNextMonth() - 基準日翌月末日のDateオブジェクトを返すメソッド
 * endLastMonth() - 基準日前月末日のDateオブジェクトを返すメソッド
 * beginThisMonth() - 基準日当月初日のDateオブジェクトを返すメソッド
 * beginNextMonth() - 基準日翌月初日のDateオブジェクトを返すメソッド
 * beginLastMonth() - 基準日前月初日のDateオブジェクトを返すメソッド
 * aYearAgo() - 基準日と前年同日のDateオブジェクトを返すメソッド
 * aWeekAgo() - 基準日の7日前のDateオブジェクトを返すメソッド
 * 
 */

/* = = = = = = = = = = = = = = = = = = = = = = = = = = = = */

class CalDate {

  /**
   * 基準日のDateオブジェクトを生成するコンストラクタ
   * @constructor
   * @params  {Date}  date  デフォルトは実行日（今日）
   */
  constructor(date = new Date()) {
    this.date = new Date(date);
  }

  /**
   * 基準日の前回の土曜日のDateオブジェクトを返すメソッド
   * @return  {Date}  lastSaturday
   */
  lastSaturday() {
    const indexSat = 6
    const indexToday = this.date.getDay();
    if (indexToday === indexSat) { return new Date(this.date.getFullYear(), this.date.getMonth(), this.date.getDate() - 7) };
    if (indexToday < indexSat) {
      const difference = indexSat - indexToday - 7;
      return new Date(this.date.getFullYear(), this.date.getMonth(), this.date.getDate() + difference);
    };
  }

  /**
   * 基準日の次回の土曜日のDateオブジェクトを返すメソッド
   * @return  {Date}  nextSaturday
   */
  nextSaturday() {
    const indexSat = 6
    const indexToday = this.date.getDay();
    if (indexToday === indexSat) { return new Date(this.date.getFullYear(), this.date.getMonth(), this.date.getDate() + 7) };
    if (indexToday < indexSat) {
      const difference = indexSat - indexToday;
      return new Date(this.date.getFullYear(), this.date.getMonth(), this.date.getDate() + difference);
    };
  }

  /**
   * 基準日月末日のDateオブジェクトを返すメソッド
   * @return  {Date}  endThisMonth
   */
  endThisMonth() {
    return new Date(this.date.getFullYear(), this.date.getMonth() + 1, 0);
  }

  /**
   * 基準日翌月末日のDateオブジェクトを返すメソッド
   * @return  {Date}  endNextMonth
   */
  endNextMonth() {
    return new Date(this.date.getFullYear(), this.date.getMonth() + 2, 0);
  }

  /**
   * 基準日前月末日のDateオブジェクトを返すメソッド
   * @return  {Date}  endLastMonth
   */
  endLastMonth() {
    return new Date(this.date.getFullYear(), this.date.getMonth(), 0);
  }

  /**
   * 基準日当月初日のDateオブジェクトを返すメソッド
   * @return  {Date}  beginThisMonth
   */
  beginThisMonth() {
    return new Date(this.date.getFullYear(), this.date.getMonth(), 1);
  }

  /**
   * 基準日翌月初日のDateオブジェクトを返すメソッド
   * @return  {Date}  beginNextMonth
   */
  beginNextMonth() {
    return new Date(this.date.getFullYear(), this.date.getMonth() + 1, 1);
  }

  /**
   * 基準日前月初日のDateオブジェクトを返すメソッド
   * @return  {Date}  beginLastMonth
   */
  beginLastMonth() {
    return new Date(this.date.getFullYear(), this.date.getMonth() - 1, 1);
  }

  /**
   * 基準日と前年同日のDateオブジェクトを返すメソッド
   * @return  {Date}  aYearAgo
   */
  aYearAgo() {
    return new Date(this.date.getFullYear() - 1, this.date.getMonth(), this.date.getDate());
  }

  /**
   * 基準日の7日前のDateオブジェクトを返すメソッド
   * @return  {Date}  aWeekAgo
   */
  aWeekAgo() {
    return new Date(this.date.getFullYear(), this.date.getMonth(), this.date.getDate() - 7);
  }
}