本文へ移動
技術を、自社の仕事に。
判断と実行を助けるメディア

記事を検索

Google Tasks APIのhidden引数が削除 連携コードの確認点

目次 · 7項目

社内の申請システムやプロジェクト管理ツールから、Google Tasks(Google ToDo リスト)へタスクを書き出す連携を作っている場合、11月のクライアントライブラリの更新でビルドが止まることがあります。TypeScript でGoogleの公式クライアント(@googleapis/tasks・googleapis)を使い、タスクを作る tasks.insert に hidden を渡しているコードです。

Tasks APIの定義(Discovery 文書)では、tasks.insert の hidden 引数が10月下旬に加わり、11月上旬の版で消えました。公式クライアントは定義から自動生成されているため、11月12日に公開された新しいメジャー版では、この引数が型から外れています。本記事では、定義の推移と手元での確認結果、影響を受けるコードの直し方、あわせて変わった繰り返しのタスクの移動に関する記述を整理します。

定義はどう変わったか

Google は各APIの定義を Discovery 文書として公開しており、公式クライアントはその写しから生成されます。googleapis/google-api-nodejs-client のリリースごとの写しと、11月14日に取得した Tasks API の現在の定義を比べると、次のように推移しています。

定義の版(revision)確認した場所insert の hidden繰り返しのタスクの移動
20251102クライアント 185.0.0(10月8日)なし「リスト間で移動できない」と記載
20261025クライアント 189.0.0(10月29日)あり同上
20261101クライアント 190.0.0(11月12日)なし同上
20261110Tasks API の定義(11月14日取得)なし記載が消えた
20261117Tasks API の定義(11月20日取得)なし記載なし

189.0.0 の写しにあった hidden の説明は、「完了したあとリストから消去された(clear)状態として作るかどうか。完了済みのタスクだけを非表示で作れ、入れ子や位置の指定はできない」という趣旨でした。190.0.0 の変更履歴では、Tasks を含む12のAPIに「This release has breaking changes.」と記されています。

Googleの開発者向けリファレンス(developers.google.com の tasks.insert のページ)も、11月20日の時点で引数は tasklist・parent・previous だけで、hidden は載っていません。リファレンスに hidden が載っていた時期があったかどうかは、確かめられていません。Tasks API のリリースノートの最新の項目は2024年7月23日で、今回の追加と削除についての告知は見つかりませんでした。

なお、タスクの項目としての hidden(Task.hidden)は残っています。説明は「タスクの一覧が最後に消去されたときに完了していたタスクかどうか。読み取り専用」です。消えたのは、作成時に指定する引数のほうです。

公式クライアントの型で確かめた

2026年11月14日に、npm から @googleapis/tasks の 17.1.0(10月30日公開)と 18.0.0(11月12日公開)を取得し、同じコードを TypeScript 5.9.3 で型検査しました(tsc --noEmit --strict)。APIの呼び出しはしていません。

import { tasks_v1 } from '@googleapis/tasks';

const params: tasks_v1.Params$Resource$Tasks$Insert = {
  tasklist: '@default',
  hidden: true,
  requestBody: { title: '完了済みの記録', status: 'completed' },
};

結果は次のとおりです。

@googleapis/tasks 17.1.0: エラーなし
@googleapis/tasks 18.0.0:
check.ts(5,3): error TS2353: Object literal may only specify known properties,
and 'hidden' does not exist in type 'Params$Resource$Tasks$Insert'.

18.0.0 の型定義では、tasks.insert の引数は parent・previous・tasklist(と本文)だけです。17.1.0 のころに hidden を使い始めたコードは、更新すると型検査で止まります。

Google Tasks APIのhidden引数の推移。10月8日のクライアント185.0.0の定義にはなく、10月29日の189.0.0で加わり、11月12日の190.0.0で消えた。手元の型検査では@googleapis/tasks 17.1.0は通り、18.0.0はTS2353で止まった。11月20日の定義(revision 20261117)では、繰り返しのタスクはリスト間で移動できないという記述が消えているが、公式リファレンスには残っている

影響を受けるコードと直し方

影響を受けるのは、tasks.insert に hidden を渡しているコードです。検索するなら、tasks.insert( の呼び出しと hidden: が同じ箇所にあるかを見ます。Apps Script の高度なサービス(Tasks)で、タスクの作成時の省略可能な引数に hidden を渡している場合も、確認の対象に含めてください(高度なサービスでの挙動は確認していません)。

直し方は、目的によって分かれます。編集部の提案として整理します。

  1. 完了済みの記録として残したいだけなら、hidden を外す。 status: 'completed' で作れば完了済みのタスクになります。Tasks API の一覧(tasks.list)は、showCompleted の既定が True のため、完了済みのタスクも返します。返したくない場合は、取得する側で showCompleted: false を指定します。
  2. 画面から見えなくしたいなら、tasks.clear の影響を確かめてから使う。 clear は「指定したリストの完了済みのタスクをすべて消去する」メソッドで、消去されたタスクは hidden になります。リスト単位で動くため、利用者が自分で完了にしたタスクもまとめて対象になります。連携専用のリストを分けるなど、対象を限定できる場合に限ります。
  3. 型エラーを避けるためだけに古い版へ固定しない。 定義から消えた引数を送り続けた場合の挙動(無視されるのか、エラーになるのか)は確認できていません。クライアントを17.1.0に固定すると、引数を送れてしまう状態が続きます。

JavaScript(型検査なし)の場合は、更新してもビルドは止まりません。動作が変わっていないかは、検証用のアカウントで作成と一覧の取得を試して確かめてください。

繰り返しのタスクの移動に関する記述

11月14日に取得した定義(revision 20261110)と11月20日に取得した定義(revision 20261117)では、tasks.move の destinationTasklist(移動先のリスト)の説明から「Recurrent tasks cannot currently be moved between lists.(繰り返しのタスクは現在リスト間で移動できない)」の一文が消えています。11月12日公開の @googleapis/tasks 18.0.0 は revision 20261101 の定義から作られているため、型定義の説明にはまだこの一文があります。

一方、developers.google.com の tasks.move のリファレンスには、11月20日の時点でもこの一文が残っています。定義とリファレンスで記述が分かれているため、制約がなくなったとは判断できません。Tasks API のリリースノートにも、この点についての項目はありません。移動の処理で繰り返しのタスクを除外するような分岐を入れている場合は、外す前に検証用のアカウントで実際に移動を試してください。

一方、同じ tasks.move の parent の説明には「Assigned and repeating tasks cannot be set as parent tasks (have subtasks), or be moved under a parent task (become subtasks).」とあり、繰り返しのタスクを親にしたり、別のタスクの下に入れたりできない点は変わっていません。また、Tasks API のタスクの項目には繰り返しの設定を表すものがなく、APIから繰り返しのタスクを作ることはできません。

定義の変化を追う方法

公式クライアントの変更履歴では、190.0.0 の Tasks の項目は「update the API」の一行だけで、何が変わったかは定義を比べないと分かりません。業務の連携が依存しているAPIについては、次のような確認を定期的に入れておくと、今回のような変化に早く気づけます。

# 現在の定義の版と、tasks.insert の引数の一覧
curl -s 'https://tasks.googleapis.com/$discovery/rest?version=v1' \
  | jq '{revision, insert: (.resources.tasks.methods.insert.parameters | keys)}'

2026年11月14日に実行した結果は "revision": "20261110"、11月20日は "revision": "20261117" で、引数はどちらも parent・previous・tasklist でした。前回の出力と差分を取り、引数の増減や説明の変化があれば、該当する処理を検証します。あわせて、Renovate や Dependabot でクライアントのメジャー版の更新を自動で取り込む設定にしている場合は、Google のクライアントのメジャー版はAPIの定義の互換性のない変更を含むことがある前提で、型検査とテストを必ず通す運用にしておきます。

Google Workspace のAPIの定義の変化を扱った記事として、Calendar APIの勤務時間の一括設定や、Admin SDKでのゲストユーザーの作成もあります。Apps Script の開発環境の更新はclasp 3.4の記事で扱いました。

確認した範囲

2026年11月14日に、Tasks API の Discovery 文書(https://tasks.googleapis.com/$discovery/rest?version=v1 、revision 20261110)と、googleapis/google-api-nodejs-client の 185.0.0・189.0.0・190.0.0 の定義の写し(discovery/tasks-v1.json)と変更履歴を確認しました(資料調査)。あわせて npm の @googleapis/tasks 17.1.0・18.0.0 を取得し、同じ TypeScript のコードを型検査しました(TypeScript 5.9.3、Node.js 22.23.4)。Tasks API の呼び出し、hidden を送った場合の挙動、繰り返しのタスクの移動は確認していません。11月20日に、Discovery 文書(revision 20261117)、developers.google.com の Tasks API のリファレンス(tasks.insert・tasks.move・tasks.clear)とリリースノート、Google Workspace Updates のブログを確認しました。リファレンスに hidden が載っていた時期があったかどうかは確認できていません。

Google Workspace と社内のシステムをつなぐ処理の保守や、APIの変更の影響の洗い出しは、グリームハブの IT・Google Workspace の無料相談で承っています。お問い合わせからご相談ください。

参考資料

この記事を共有XFacebook
鈴木 翔

技術の可能性に魅了され、学生時代からプログラミングとデジタルアートの分野に深い関心を持つ

この記事のテーマを、自社の次の一歩へ

自社に合う、Workspaceの進め方を。

移行するデータ、共有ルール、管理体制を整理し、導入から日々の運用までの進め方を考えます。

  • 移行と初期設定
  • 共有・権限の整理
  • 管理体制
Workspaceの導入・運用を相談する

構想段階からご相談いただけます。この記事の情報を相談フォームに引き継ぎます。

最新記事をメールで受け取る