Hubspotというアプリから情報を取得して、Google Spreadsheetへ記載したい

Question

前提・実現したいこと

対象：Google Spreadsheet/Hubspot
実現したいこと：Hubspotというアプリから「取引」に関する情報を取得して、Google Spreadsheetへ自動で記載したい

参照

コード設計部分：https://goo.gl/64hQZb
スコープ部分：https://legacydocs.hubspot.com/docs/methods/pipelines/pipelines_overview
OAUthについて：https://developers.google.com/datastudio/connector/oauth2?hl=ja

発生している問題・エラーメッセージ

機能としては以下に切り分けられており、エラーが発生しているのは8になります（9,10は未検証）

1.getOAuth2Access
2.reset
3.getService
4.authCallback
5.logRedirectUri
6.getStages
7.getDeals
8.weiteStages
9.refresh
10.logStages
ーーーーーーーーーーーーーーーーーーーーー
8.weiteStages
Exception: The number of columns in the data does not match the number of columns in the range.
The data has 0 but the range has 2.
writeStages @ コード.gs:247

わからないこと

エラーからは抽出したデータがない（列が0）と読み取りましたが、データはきちんとHubspot内には登録されているので、
適切に抽出出来ていないと考えております。
ただ getStages も getDeals も問題なく実行が出来ており、かつ私がコードの誤っている部分が不明であったため、
ご質問させて頂いております。

※追記※

console.log()にて確認したところ、weiteStagesにおいてstagesがundefinedとなっておりました。

stages = undefined
matrix = [ [ 'StageID', 'StageName' ], undefined ]

getStagesにおいては、stagesにきちんと値が格納されておりました

該当のソースコード

/**
 * # Description: This script let's you connect to Hubspot CRM and retrieve  #
 * #              its data to populate a Google Spreadsheet.                 #                                             #
 * # Detail of the turorial: https://goo.gl/64hQZb   
 * # OAuth2：1B7FSrk5Zi6L1rSxxTDgDEUsPzlukDsi4KGuTMorsTQHhGBzBkMun4iDF       　#
 */
/**
 * Fill in the following variables
 * 連携のための準備を行う
 */
var CLIENT_ID = 'クライアントID（本来であれば記入あり）'; 
var CLIENT_SECRET = 'クライアントシークレット（本来であれば記入あり）'; 
var SCOPE = 'contacts';
var AUTH_URL = 'https://app.hubspot.com/oauth/authorize';
var TOKEN_URL = 'https://api.hubapi.com/oauth/v1/token';
var API_URL = 'https://api.hubapi.com';

/**
 * Create the following sheets in your spreadsheet
 * "Stages"
 * "Deals"
 * 上記2つのシートを作っておく
 * ログソースとログステージにはピンと来ていない
 */
var sheetNameStages = "Stages";
var sheetNameDeals = "Deals";
var sheetNameLogSources = "Log: Sources";
var sheetNameLogStages = "Log: Stages";

/**
 * # --------------------------- AUTHENTICATION ---------------------------- #
 */

/**
 * Authorizes and makes a request to get the deals from Hubspot.
 * getServiceでサービスを利用する宣言を行い、そこで問題なくアクセスが出来るか確認している
 */
function  getOAuth2Access() {
  var service = getService();
  if (service.hasAccess()) {
    // ... do whatever ...
  } else {
    var authorizationUrl = service.getAuthorizationUrl();
    Logger.log('Open the following URL and re-run the script: %s',
        authorizationUrl);
  }
}
/**
 * Reset the authorization state, so that it can be re-tested.
 * 何度も行うコードのため、リセットするよう設定しておく
 */
function reset() {
  getService().reset();
}

/**
 * Configures the service.
 * 実際に利用するサービスを定義/確認する
 * エンドポイントURLとは、特定のリソースに対して与えられた固有の一意な URL
 * OAuth2 ライブラリを追加して設定する
 */
function getService() {
  return OAuth2.createService('hubspot')
      // Set the endpoint URLs.
      .setTokenUrl(TOKEN_URL)
      .setAuthorizationBaseUrl(AUTH_URL)

      // Set the client ID and secret.
      .setClientId(CLIENT_ID)
      .setClientSecret(CLIENT_SECRET)

      // Set the name of the callback function in the script referenced
      //APIの利用を完了させるために必要
      // above that should be invoked to complete the OAuth flow.
      .setCallbackFunction('authCallback')

      // Set the property store where authorized tokens should be persisted.
      //ちゃんと許可されたという証拠を保存する
      .setPropertyStore(PropertiesService.getUserProperties())
      .setScope(SCOPE);
}

/**
 * Handles the OAuth2 callback.
 * この関数は OAuth 2.0 フローを完了するために呼び出されます。
 * サードパーティの認証サービスからのコールバック応答は引数として提供されるため、この関数で処理する必要があります。
 */
function authCallback(request) {
  var service = getService();
  var authorized = service.handleCallback(request);
  if (authorized) {
    return HtmlService.createHtmlOutput('Success!');
  } else {
    return HtmlService.createHtmlOutput('Denied.');
  }
}
/**
 * Logs the redict URI to register.
 * URIとは、Uniform Resource Identifierの略で、URLの上位概念（URI:寿司、URL：ちらし寿司）
 * 保存されたリクエストをトリガーするために、リダイレクトできる URI を取得する
 * リダイレクト URI、すなわち応答 URL は、アプリが正しく承認され、認証コードまたはアクセス トークンが付与されると、承認サーバーがユーザーを送り出す場所です。 
 * ロギングとは、起こった出来事についての情報などを時間経過にそって記録する履歴のことです。
 * ソフトウエアを使用する際に特にエラーが発生した場合にこの履歴を確認することで、どこでどんな不具合が発生したか把握でき対応を絞り込むことができます。
 * Loggerで出力できる
 */
function logRedirectUri() {
  Logger.log(getService().getRedirectUri());
}

/**
 * # ------------------------------- GET DATA ------------------------------ #
 */

/**
 * Get the different stages in your Hubspot pipeline
 * API & Documentation URL: https://developers.hubspot.com/docs/methods/deal-pipelines/get-deal-pipeline
 * Bearer認証は, トークンを利用した認証・認可に使用されることを想定しており, OAuth 2.0の仕様の一部として定義されているが, その仕様内でHTTPでも使用しても良いと記述されている.
bearerは「担い手」や「使い」といった意味を持つ.
詳細は, 『RFC 6750 The OAuth 2.0 Authorization Framework: Bearer Token Usage』を参照.
HTTPのAuthorizationヘッダにスキームとして指定でき, Authorization: Bearer <token> のようにして指定する.
 */
function getStages() {
  // Prepare authentication to Hubspot
  var service = getService();
  var headers = {headers: {'Authorization': 'Bearer ' + service.getAccessToken()}};
  
/**
 * UrlFetchAppはurlを入れるだけでもアクセスは出来ますが、相手先のウェブサービスやサーバーの条件に応じて様々なオプションを追加してあげる必要性があります。
 * Web APIを利用するためには、「HTTPリクエストを送る」という操作をする必要があるわけですが、GASにはそのための機能が用意されています。
   それを提供するのがUrlFetchサービスのfetchメソッドになります。
 */
  // API request
  var pipelineId = "default"; // Enter your pipeline id here.
  var url = API_URL + "/crm-pipelines/v1/pipelines/deals";
  var response = UrlFetchApp.fetch(url, headers);
  var result = JSON.parse(response.getContentText());
  var stages = Array();
  
  // Looping through the different pipelines you might have in Hubspot
  result.results.forEach(function(item) {
    if (item.pipelineId == pipelineId) {
      var result_stages = item.stages;
      // Let's sort the stages by displayOrder
      result_stages.sort(function(a,b) {
        return a.displayOrder-b.displayOrder;
      });
  
      // Let's put all the used stages (id & label) in an array
      result_stages.forEach(function(stage) {
        stages.push([stage.stageId,stage.label]);  
      });
    }
  });
  
  return stages;
}

/**
 * Get the deals from your Hubspot pipeline
 * API & Documentation URL: https://developers.hubspot.com/docs/methods/deals/get-all-deals
 */
function getDeals() {
  // Prepare authentication to Hubspot
  var service = getService();
  var headers = {headers: {'Authorization': 'Bearer ' + service.getAccessToken()}};
  
  // Prepare pagination
  // Hubspot lets you take max 250 deals per request. 
  // We need to make multiple request until we get all the deals.
  var keep_going = true;
  var offset = 0;
  var deals = Array();

  while(keep_going)
  {
    // We'll take three properties from the deals: the source, the stage & the amount of the deal
    var url = API_URL + "/deals/v1/deal/paged?properties=dealstage&properties=source&properties=amount&limit=250&offset="+offset;
    var response = UrlFetchApp.fetch(url, headers);
    var result = JSON.parse(response.getContentText());
    
    // Are there any more results, should we stop the pagination ?
    keep_going = result.hasMore;
    offset = result.offset;
    
    // For each deal, we take the stageId, source & amount
    result.deals.forEach(function(deal) {
      var stageId = (deal.properties.hasOwnProperty("dealstage")) ? deal.properties.dealstage.value : "unknown";
      var source = (deal.properties.hasOwnProperty("source")) ? deal.properties.source.value : "unknown";
      var amount = (deal.properties.hasOwnProperty("amount")) ? deal.properties.amount.value : 0;
      deals.push([stageId,source,amount]);
    });
  }
  
  return deals;
}


/**
* # -------------------------- WRITE TO SPREADSHEET ----------------------- #
*/

/**
 * Print the different stages in your pipeline to the spreadsheet
 */
function writeStages(stages) {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheetByName(sheetNameStages);
  
  // Let's put some headers and add the stages to our table
  var matrix = Array(["StageID","StageName"]);
  matrix = matrix.concat(stages);
  
  // Writing the table to the spreadsheet
  //getRange(row, column, numRows, numColumns)
  var range = sheet.getRange(1,1,matrix.length,matrix[0].length);
  range.setValues(matrix);
}

/**
* # -------------------------------- ROUTINE ------------------------------ #
*/

/**
 * This function will update the spreadsheet. This function should be called
 * every hour or so with the Project Triggers.
 */
function refresh() {
  var service = getService();
  
  if (service.hasAccess()) {
    var stages = getStages();
    writeStages(stages);
  
    var deals = getDeals();
    writeDeals(deals);
    
  } else {
    var authorizationUrl = service.getAuthorizationUrl();
    Logger.log('Open the following URL and re-run the script: %s',
        authorizationUrl);
  }
}

/**
 * This function will log the amount of leads per stage over time
 * and print it into the sheet "Log: Stages"
 * It should be called once a day with a Project Trigger
 */
function logStages() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheetByName("Stages: Count");
  var getRange = sheet.getRange("B2:B12");
  var row = getRange.getValues();
  row.unshift(new Date);
  var matrix = [row];
  
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheetByName("Log: Stages");
  var lastRow = sheet.getLastRow();
  var lastCol = sheet.getLastColumn();
    
    // Writing at the end of the spreadsheet
  var setRange = sheet.getRange(lastRow+1,1,1,row.length);
  setRange.setValues(matrix);
}

Comments

[kikukiku]

writeStagesメソッド内のgetRangeの実行時にエラーになっていると思うので、
素直に、その直前で、matrixやstagesの内容を確認したら良いと思います。

[penmon]

早急にご回答頂きありがとうございます。
ご指摘頂いた部分をconsole.log()にて確認したところ、stagesがundefinedとなっておりました。
こちらgetStages関数ではきちんとstagesに値が入っていたため、なぜその間に値がわからなくなったのか検討がつきません。
可能でしたら、どのような可能性が考えられるのかご教授頂きたいです。

[kikukiku]

getStages関数で取得したstagesを、そのままwriteStages関数に渡しているようなので、
何か評価方法に間違いがあるように感じました。
例えば、getStages関数でstagesに値が入っていると確認したときには、
なんらかのエラーが発生していない状態であったとか。
なので、getStages関数と、writeStages関数の両方にログを入れて
同じタイミングで評価するようにしたら、原因の糸口が見つかるのではないかと思います。

[kikukiku]

refresh関数が頻繁に呼ばれたりしていないかなども、確認しておいた方が良いかも。

[penmon]

丁寧にありがとうございます。
先ほど再度確認をしたところ、下記部分にて別途エラーが発生しておりました。
またエラーを示す行（390）が存在しない行になるのですが、こちら何が類似事例はご存じでしょうか？

4.authCallback
エラー
TypeError: Cannot read property 'parameter' of undefined
Service_.handleCallback @ Service.gs:390

[kikukiku]

OAuth2.0に関しては経験がなく、解決まで導くことは難しいと判断し、
回答欄ではなく、ここにコメントさせて頂いています。
今までわかったことを、質問欄に記載し、他の回答者を待った方が良いかもしれません。

[kikukiku]

今できることとしては、authCallback関数内に発生していることなのか（たぶんそうではない）。
.setCallbackFunction('authCallback')実行時に発生していることなのか（たぶんそうではない）。
を確認することはできると思います（ログ入れればわかるはず）。
上記想定通りだとすると、.setCallbackFunction('authCallback')以前に問題があるということになると
思います。

[penmon]

経験がないにも関わらず、ご丁寧に対応頂きありがとうございました。
ご記載頂いた内容をもとに、自分でも試行錯誤いたします。