GASライブラリ活用：HubSpotの期限切れタスクをGASで自動抽出・スプレッドシート管理する方法

1. 実装の目的とメリット

このオートメーションの目的は、期限切れのタスクを「可視化」し、チームのタスク漏れをゼロにすることです。

• 管理の集約化: HubSpotを開かなくても、使い慣れたスプレッドシートで期限切れ状況を一目で把握できます。
• 担当者別の状況把握: どの担当者にどれくらいの遅延タスクが溜まっているかを自動で整理します。
• 工数の削減: 定期的に手動でエクスポートして集計する手間を完全に排除します。

2. ユースケース

• タスクの棚卸しと可視化: 見落とされがちな期限切れタスクを一覧化し、チーム全体の遅延状況を把握できます。
• 担当者ごとの負荷チェック: 抽出したタスクを担当者（Owner）ごとに整理することで、誰にどれだけの滞留タスクがあるかを即座に確認し、リソース配分やフォローアップの判断材料とします。
• 定期的なレポート作成: GASのトリガー機能と組み合わせることで、最新のタスク遅延レポートを自動作成できます。

3. HubSpotの必要な権限（スコープ）

この機能を利用するためには、HubSpotの「プライベートアプリ」を作成し、アクセストークンを発行する必要があります。その際、以下のスコープ（権限）を許可してください。

• crm.objects.owners.read: 担当者（Owner）のIDを氏名に変換するために必要です。
• crm.objects.tasks.read: タスク情報を検索し、取得するために必要です。

4. ライブラリの使い方（実装ステップ）

ステップ1：ライブラリの追加

GASプロジェクトの画面左側にある「ライブラリ +」をクリックし、以下のようにスクリプトIDを入力して検索をクリックして追加します。

• スクリプトID: 1wA-U-zBpQ6DfHLPdstfMJ51a3koDJPl7kMAq0jSpfOFvOXFCuTEwraHc
• バージョン: 最新のバージョンを選択
• ID: 関数を実行するための任意の名前を入力

ステップ2：実行テストコードの記述

以下のコードをエディタに貼り付けます。コメントを参考に、ご自身の環境に合わせて各値を設定してください。

#実行テストコード:
// library id
// 1wA-U-zBpQ6DfHLPdstfMJ51a3koDJPl7kMAq0jSpfOFvOXFCuTEwraHc

// test code
function runHubSpotTaskExport() {
  
  // settings
  const HUBSPOT_ACCESS_TOKEN = "ここにHubSpotのアクセストークンを貼ってください"; // HubSpotのアクセストークン
  const SPREADSHEET_ID = "ここにスプレッドシートIDを貼ってください"; // 出力先スプレッドシートID
  const SHEET_NAME = "シート1"; // 出力したいシート名

  // library identify id "HubSpotLib" 
  HubSpotLib.exportOverdueTasksToSheet(
    HUBSPOT_ACCESS_TOKEN, 
    SPREADSHEET_ID, 
    SHEET_NAME
  );
}

ステップ3：出力データの確認

実行すると、スプレッドシートの最終行の下に以下の項目が自動で追記されます。

タスクID / 件名 / 期限日 / 超過日数 / 担当者名 / URL / 取得日時

‍