はじめに

Backlogとは株式会社ヌーラボが提供するプロジェクト管理ツールです。

プロジェクト管理をする際に、複数のプロジェクトで俯瞰的に各タスクの状況を把握する場合があります。Backlog上からでは、プロジェクト横断的に各タスクの状況を見れる機能がないため、タスク管理をする上で難しさを感じることがあります。

Backlog APIでは、「課題一覧」というタスク状況のわかるデータが取得できます。
API経由で複数プロジェクトの「課題一覧」のデータを取得し、集計して可視化を行うことで、複数プロジェクトのタスク管理を同時並行で進めることができます。

今回の記事ではTROCCO®のHTTPコネクタを活用し、Backlog APIから取れるプロジェクトの「課題一覧」のデータを、BigQueryに転送する方法を紹介します。

事前準備

TROCCO®アカウントの作成をお願いします。
TROCCO®には無料で始められるフリープランがあります。

すでにBacklogアカウントがあり、プロジェクトが存在していることを前提とします。

Backlog APIとTROCCO®との接続にはOAuth2.0を用いて行います。
Backlog DeveloperサイトからBacklogアプリケーションの登録を行い、アプリケーションの情報をTROCCO®上に登録させる必要があります。

まず、TROCCO®のホーム画面の「接続情報一覧」から「接続情報の新規作成（サービスの選択）」を行い、「HTTP・HTTPS」を選択します。

「HTTP・HTTPS」選択後、「接続情報の作成・設定」画面に飛び、Backlog Developer上で必要な、TROCCO®のリダイレクトエンドポイントを確認します。

次にBacklog Developerサイトから、Backlogアプリケーションの登録を行います。
TROCCO®のリダイレクトエンドポイントを記載し、作成ボタンを押します。

作成ボタンを押すと、TROCCO®と接続するためのClinet Idと Client Secretが発行されます。

最後にTROCCO®上でBacklogアプリケーションの接続情報を登録します。

TROCCO®の「接続情報の作成・設定」から「作成したアプリ情報の入力へ」のページに飛び、Backlogアプリケーションで作成したClinet Idと Client Secretを登録します。

認可URL、アクセストークンURLに関してはBacklog API公式HPの「認証と認可」を参考にし、以下のように記載します。

- 認可URL
https://[スペースID].backlog.com/OAuth2AccessRequest.action

- アクセストークンURL
https://[スペースID].backlog.com/api/v2/oauth2/token

[スペースID]は、Backlog ヘルプセンター「スペースIDとは？」を参考に、BacklogのURL上から確認することができます。

最後に接続認証を行って、疎通が確認できれば設定完了です。

TROCCO®にログインし、転送設定の新規作成に進みます。
転送元 : HTTP・HTTPS
転送先 : BigQuery
を選択します。

はじめに、OAuth2.0の「利用する」にチェックをつけ、「HTTP・HTTPS接続情報」には事前準備で作成したTROCCO上の接続情報を選択します。

カスタム変数機能についても設定を行います。
今回はBacklogAPIのパラメータprojectId[] を指定する際に使用します。

次に、Backlog APIの設定に移ります。

今回は、Backlog APIの「課題一覧の取得」を使用します。
元となっているBacklog APIのURLは以下の通りです。

https://[スペースID].backlog.com/api/v2/issues?projectId[]=$projectid$

TROCCO®で設定する際は以下表の通りとなります。
表にない項目はデフォルトの値で問題ありません。

設定項目名	設定内容
URL	`https://[スペースID].backlog.com/api/v2/issues?`
HTTPメソッド	GET
文字エンコーディング	UTF-8
ファイル入力形式	JSONPath
JSONPath	$.*
パラメータ`projectId[]`	$projectid$
HTTPヘッダ`Content-Type`	application/json