GASを使ってAsana APIからタスクを取得する

前提条件

• Asanaに登録済み
• GASを実行する環境を構築済み

アクセストークンの取得

まずはAsana APIのアクセストークンを取得する必要があります。 下記URLの開発者コンソールにAsanaのアカウントを用いてログインしてください。

• 開発者コンソール

メニューの【個人アクセストークン】のセクションから【新規アクセストークン】を選択します。 ※赤で隠れている部分は既に作成してあるトークンなので、初回は表示されません。

トークン名を聞かれるので、任意の値を入力してください。 【API利用規約に同意します】にチェックを入れて【トークンを作成】を押してください。

正常にトークンが作成された場合、下記のようにトークンが表示されるのでコピーします。

以上でアクセストークンの発行が完了しました。

GASからリクエストを実行

プロジェクト下のタスクは/projects/{project id}/tasksのエンドポイントを使用します。

• 参考：Get tasks from a project

サンプルとして下記のような関数を作成しました。 【アクセストークン】には先ほど取得したアクセストークンを、 【プロジェクトID】にはAsanaのプロジェクトIDを入力します。 ※プロジェクトIDはアクセストークンを取得したアカウントが参照できるプロジェクトを指定する必要があります。

/**
 * Asanaからタスクを取得する
 */
function getAsanaTasks() {
  
  // リクエストオプションを作成
  var options = {
    // GETメソッド
    'method': 'get',
    // JSON形式
    'contentType': 'application/json',
    // ヘッダ
    'headers': { 
      // 認証情報
      'Authorization': 'Bearer ‘ +【アクセストークン】
    },
  }
    
  // Asana APIを実行しタスクを取得する
  // ?opt_fields=でタスク名、期限、最終更新日を指定して取得する
  var response = UrlFetchApp.fetch(`https://app.asana.com/api/1.0/projects/【プロジェクトID】/tasks?opt_fields=name,due_on,modified_at,completed`, options);
  // 取得結果をJSONパース
  var result = JSON.parse(response);


  // 取得結果を配列に格納
  var list = [];  
  if(result.data){
    for(var i = 0; i < result.data.length; i++){
      list.push(result.data[i]);
    }
  }

  return list;
}

取得結果はopt_fieldsにどのフィールドを指定するかによって異なります。 私の場合、期限が近くなったにも関わらずメンテされていないタスクを取得する必要があったため「タスク名、期限、最終更新日」のフィールドを取得するようにしています。 このあたりは目的に合わせて柔軟にカスタマイズするといいかと思います。

まとめ

今回はGASを用いてAsana APIを実行しプロジェクト配下のタスクを取得するサンプルを紹介しました。 単純にREST APIを叩くだけなので、ご自身の利用環境に適した言語を選択するといいと思います。

SNSでシェアする

タグ

• gas
• asana
• api
• task
• タスク管理