【Googleスプレッドシート】Trelloのカード一覧を取り込む!APIキーとボードIDの取得

Trelloで管理しているタスク一覧を、Googleスプレッドシートに取り込みたいと思ったことはありませんか。手作業でコピー&ペーストするのは手間がかかり、更新のたびに同じ作業を繰り返すのは非効率です。TrelloのAPIを使えば、カードの一覧を自動的にスプレッドシートに取り込めるため、常に最新の状態を保てます。この記事では、TrelloのAPIキーとボードIDの取得方法を詳しく解説します。これを理解すれば、スプレッドシートでTrelloのデータを自在に活用できるようになります。

Trello APIキーとボードIDの取得でできること

Trelloには、外部アプリケーションからデータを取得するためのAPIが用意されています。このAPIを使うと、特定のボードに含まれるカードの一覧や、リスト、メンバー、ラベルなどの情報をJSON形式で取得できます。取得したデータは、GoogleスプレッドシートのIMPORTDATA関数やGoogle Apps Scriptを使って、シート上に整形して表示できます。これにより、Trelloのタスク管理情報をスプレッドシートで一元的に管理し、グラフ化やフィルタリング、他のデータとの連携が容易になります。必要なのは、TrelloのAPIキーとトークン、そして対象のボードIDの3つです。これらを正しく取得する方法を順に説明します。

Trello APIキーとトークンを取得する手順

最初に、TrelloのAPIキーとトークンを取得します。APIキーはアプリケーションを識別するためのIDで、トークンはユーザー自身の認証情報です。以下の手順に沿って進めてください。

1. Trelloの開発者ページにアクセスする
   ブラウザで https://trello.com/app-key を開きます。Trelloにログインしていない場合は、ログイン画面が表示されますので、ログインしてください。ページが表示されると、「APIキー」という項目があります。そこに記載されている英数字の文字列があなたのAPIキーです。この文字列は外部に漏らさないように注意してください。
2. トークンを生成する
   同じページの「トークン」セクションにある「生成(Generate)」ボタンをクリックします。ボタンをクリックすると、Trelloの認証画面が表示されます。内容を確認し、「許可する」ボタンをクリックすると、新しいトークンが生成されます。トークンは一度しか表示されないため、必ずメモ帳などにコピーして安全な場所に保存してください。トークンはページをリロードすると表示されなくなります。
3. APIキーとトークンを確認する
   APIキーの下にある「APIキー」の文字列を再度コピーします。トークンは先ほど生成したものを使用します。これらは後ほどスプレッドシートの関数で使用するため、間違いのないように控えておきます。もしトークンを失くした場合は、再度同じ手順で新しいトークンを生成できます。

ボードIDを取得する方法

次に、データを取り込みたいTrelloボードのIDを取得します。ボードIDは、ボードのURLから確認する方法と、APIを使って一覧から取得する方法があります。ここでは、URLから確認する簡単な方法を紹介します。

1. 対象のボードを開く
   Trelloで、カード一覧を取り込みたいボードを開きます。ブラウザのアドレスバーに表示されているURLを確認します。たとえば、URLが「https://trello.com/b/XXXXXXXX/ボード名」のような形式になっています。この「XXXXXXXX」の部分がボードIDです。通常は8文字の英数字の文字列です。
2. ボードIDをメモする
   アドレスバーに表示されている英数字をコピーします。これがボードIDです。例えば「https://trello.com/b/ABC12345/私のボード」であれば、「ABC12345」がボードIDです。このIDは、後述のIMPORTDATA関数のURLの一部として使います。
3. APIを使ってボードIDを確認する(代替方法)
   もしボードIDがURLから判別しにくい場合は、APIを使って確認することもできます。ブラウザで次のURLを開いてください(APIキーとトークンは先ほど取得したものに置き換えます)。
   https://api.trello.com/1/members/me/boards?key=YOUR_API_KEY&token=YOUR_TOKEN
   このURLにアクセスすると、自分の全ボードの情報がJSON形式で表示されます。各ボードの「id」フィールドがボードIDです。ブラウザの検索機能を使って目的のボード名を探すと簡単です。

Googleスプレッドシートにカード一覧を取り込む

APIキー、トークン、ボードIDがそろったら、実際にスプレッドシートにデータを取り込みます。ここでは、IMPORTDATA関数を使った方法を説明します。この関数は、指定したURLからCSVやJSONなどのテキストデータを取得してシートに展開します。Trello APIはJSON形式でデータを返すため、IMPORTDATA関数でそのまま取り込むと、1つのセルにJSONテキストが入ります。その後、他の関数で必要な情報を抽出します。

1. APIリクエストURLを作成する
   次の形式でURLを作成します。
   https://api.trello.com/1/boards/ボードID/cards?key=APIキー&token=トークン
   「ボードID」「APIキー」「トークン」をそれぞれ実際の値に置き換えます。このURLを直接ブラウザで開くと、JSONデータが表示されることを確認できます。
2. スプレッドシートにIMPORTDATA関数を入力する
   Googleスプレッドシートを開き、任意のセルに次の数式を入力します。
   =IMPORTDATA("作成したURL全体")
   例:
   =IMPORTDATA("https://api.trello.com/1/boards/ABC12345/cards?key=yourApiKey&token=yourToken")
   数式を入力すると、JSON形式のテキストがそのセルに表示されます。ただし、1つのセルにすべてのデータが収まるため、そのままでは見づらいです。そこで、JSONから必要な項目だけを抽出する方法を次の手順で説明します。
3. JSONデータを解析する(Google Apps Scriptを使う)
   IMPORTDATAだけでは扱いにくいので、Google Apps Scriptを使用してJSONをパースし、シートに整形することをおすすめします。スクリプトエディタを開き、以下のコードを貼り付けて実行します。ただし、ここでは詳細なスクリプトコードの説明は省きます。必要に応じて、別記事で解説します。あるいは、QUERY関数やSPLIT関数を組み合わせて解析することも可能ですが、複雑になるため、Apps Scriptの使用が現実的です。

注意点とよくあるトラブル

APIキーやトークンが不正な場合

APIキーやトークンが間違っていると、エラーが返ってきます。エラーメッセージを確認して、キーやトークンの値が正しいか再確認しましょう。特にトークンは、生成後一度しか表示されないため、紛失した場合は再生成が必要です。

ボードIDが間違っている場合

ボードIDが正しくないと、存在しないボードに対するリクエストとなり、エラーが返ります。URLから取得する場合は、ボードのURL末尾の英数字が間違っていないか確認してください。APIから一覧を取得する方法では、正しいボードを選択しているか注意が必要です。

IMPORTDATA関数の制限

IMPORTDATA関数は、1回のリクエストで取得できるデータサイズに制限があります。カード数が多い場合や、カスタムフィールドなどデータ量が多いと、すべてのデータが取得できないことがあります。その場合は、APIのページネーション(limitパラメータなど)を利用して分割取得するか、Google Apps Scriptを使って処理することを検討してください。

APIの呼び出し回数制限

Trello APIには、一定期間内の呼び出し回数に制限があります。特に無料プランでは制限が厳しいため、短時間に何度もリクエストを送らないように注意しましょう。スプレッドシートのIMPORTDATA関数は、シートが再計算されるたびにリクエストを送るため、必要以上にリクエストが発生しないように、手動更新にするなどの工夫も検討するとよいです。

IMPORTDATA関数とGoogle Apps Scriptの比較

まとめ

この記事では、TrelloのAPIキーとボードIDを取得し、Googleスプレッドシートにカード一覧を取り込むための基礎を解説しました。APIキーとトークンはTrelloの開発者ページで、ボードIDはボードのURLから簡単に取得できます。IMPORTDATA関数を使ってデータを取り込むことも可能ですが、より実用的にはGoogle Apps Scriptを使ってJSONをパースし、シートに整形する方法がおすすめです。これにより、Trelloのタスク情報をスプレッドシートで一元管理し、可視化や他のデータとの連携を効率的に行えます。次は、実際にApps Scriptのコードを書いて、カード名・期限・メンバーなどをシートの各列に分割表示する手順に挑戦してみてください。