Claude Code

2026.10.27

【開発ガイド】Claude CodeからGTM APIを叩いてタグ設定を一括自動化する方法

結論：Claude CodeとGTM APIを組み合わせれば、タグ設定の99％は自動化できる
GTM API自動化の全体像
- GTM API自動化とは何か
- なぜClaude Codeを使うのか
事前準備：GTM APIを叩くためのセットアップ
Claude CodeからGTM APIを叩くための基本実装
タグ設定の一括自動化パターン
Claude Codeを活用した開発フロー
- 開発フロー全体
- Claude Codeに任せると効率が上がるポイント
エラー・制約への対処とベストプラクティス
- よくあるエラーと対処法
- 本番運用でのベストプラクティス
実務での具体的な活用シナリオ
よくある質問（FAQ）
まとめ：GTM設定を「AI + API」でコード化しよう

結論：Claude CodeとGTM APIを組み合わせれば、タグ設定の99％は自動化できる

本記事の結論はシンプルです。Googleタグマネージャー（GTM）のタグ・トリガー・変数の設定は、Claude Code から Google Tag Manager API（以下、GTM API）を叩くことでテンプレ化 & 一括自動化できます。これにより、次のようなメリットが得られます。

新規プロパティ・新規コンテナへの初期設定を数分で完了できる
人手による設定ミス（抜け・二重登録・命名ゆれ）をほぼゼロにできる
複数サイト・複数環境（本番 / ステージング）をコードで一元管理できる

この記事では、Claude Code から GTM API を実行してタグ設定を自動化する手順と、実務で使える設計パターンを、開発者向けに解説します。

GTM API自動化の全体像

GTM API自動化とは何か

GTM API 自動化とは、Google が提供する公式 API を利用して、GTM コンテナ内の下記要素をプログラムから操作することです。

タグ（Tags）
トリガー（Triggers）
変数（Variables）
バージョン（Container Versions）
ワークスペース（Workspaces）

これを手作業ではなく、Claude Code 上のスクリプトから API 経由で一括生成・更新することで、「タグ設定をインフラコードの一部」として管理できるようになります。

なぜClaude Codeを使うのか

一般的には、GTM API のクライアントとしてローカル環境の Node.js や、GCP 上の Cloud Functions などを利用することが多いです。しかし、Claude Code を使うと次のような利点があります。

ブラウザ上でコードを対話的に生成・修正・実行できる
既存のGTMエクスポート（JSON）を読み込ませ、Claude に変換ロジックを自動生成させられる
自然言語で「このサイト用のイベント計測タグを一括で作って」と指示できる

実質的に、「AIにタグ実装を丸投げし、GTM API が実行役になる」構成を組めるのが、Claude Code を使う最大のポイントです。

事前準備：GTM APIを叩くためのセットアップ

ステップ一覧

まず、GTM API を利用するための最低限の準備を整理します。

1. Google Cloud プロジェクトを作成する
2. GTM API を有効化する
3. 認証情報（OAuth 2.0 / サービスアカウント）を作成する
4. 必要なスコープと権限を確認する
5. API クライアントライブラリ（Node.js など）を準備する

GTM APIとは何か（定義）

GTM API とは、Googleタグマネージャーのコンテナ設定をプログラムから読み書きするための REST API 群です。エンドポイント例は以下の通りです。

accounts：アカウント一覧取得
containers：コンテナ（Web / App など）一覧取得
workspaces：ワークスペース管理
tags：タグの作成・更新・削除
triggers：トリガーの作成・更新・削除

GTM 管理画面で行っているクリック操作を、HTTP リクエストで再現できるイメージです。

代表的なエンドポイント一覧（例）

用途	HTTPメソッド	エンドポイント例
アカウント一覧取得	GET	`https://www.googleapis.com/tagmanager/v2/accounts`
コンテナ一覧取得	GET	`https://www.googleapis.com/tagmanager/v2/accounts/{accountId}/containers`
タグ作成	POST	`https://www.googleapis.com/tagmanager/v2/accounts/{accountId}/containers/{containerId}/workspaces/{workspaceId}/tags`
トリガー作成	POST	`.../triggers`
変数作成	POST	`.../variables`

Claude CodeからGTM APIを叩くための基本実装

開発環境の考え方

Claude Code 上では、一般的に以下のような構成を取ります。

Node.js + TypeScript または JavaScript を採用
googleapis ライブラリを利用して認証〜API呼び出しを実装
.env で認証情報やアカウントIDを管理
タグ・トリガー・変数の定義を JSON / YAML で外部ファイル化

認証処理の基本（例：サービスアカウント）

もっとも扱いやすいのはサービスアカウントによる認証です。以下は、Node.js で GTM API クライアントを初期化する例です。

import { google } from 'googleapis';

async function createGtmClient() {
  const auth = new google.auth.GoogleAuth({
    keyFile: process.env.GOOGLE_APPLICATION_CREDENTIALS,
    scopes: ['https://www.googleapis.com/auth/tagmanager.edit.containers'],
  });

  const authClient = await auth.getClient();
  const tagmanager = google.tagmanager({ version: 'v2', auth: authClient });
  return tagmanager;
}

サービスアカウントには、対象の GTM アカウントに対して ユーザーとして招待し、権限（編集権限以上）を付与しておく必要があります。

アカウント・コンテナ・ワークスペースIDの取得

GTM API は、accounts > containers > workspaces の階層構造になっています。まずは ID を取得するコードを書きます。

async function getWorkspacePath(tagmanager: any, accountName: string, containerName: string) {
  const accountsRes = await tagmanager.accounts.list();
  const account = accountsRes.data.account?.find(a => a.name?.includes(accountName));
  if (!account) throw new Error('Account not found');

  const containersRes = await tagmanager.accounts.containers.list({ parent: account.path! });
  const container = containersRes.data.container?.find(c => c.name === containerName);
  if (!container) throw new Error('Container not found');

  const workspacesRes = await tagmanager.accounts.containers.workspaces.list({ parent: container.path! });
  const workspace = workspacesRes.data.workspace?.[0]; // デフォルトを利用
  if (!workspace) throw new Error('Workspace not found');

  return workspace.path; // 以降のAPI呼び出しのparentとして利用
}

このように、Claude に「GTM API の階層構造をなめてワークスペースパスを返す関数を書いて」と指示すれば、上記のようなコードを自動生成させることができます。

タグ設定の一括自動化パターン

タグ自動生成ロジックの基本方針

タグ設定の自動化では、以下の 2 レイヤーを分離しておくと保守しやすくなります。

定義レイヤー：「何を実装したいか」を JSON / YAML で宣言的に記述
適用レイヤー： 定義をパースして GTM API に変換し実行するスクリプト

Claude Code は特に「定義レイヤーのスキーマ設計」と「スキーマ → API ペイロード変換関数」の生成に相性が良く、自然言語で方針を伝えながらスキーマを洗練させていく使い方が有効です。

設定定義の例（YAML）

tags:
  - name: GA4 - Page View
    type: ga4_config
    measurementId: G-XXXXXXX
    trigger: All Pages

  - name: GA4 - Purchase Event
    type: ga4_event
    eventName: purchase
    params:
      - name: value
        type: dataLayer
        key: ecommerce.value
    trigger: Purchase Completion

triggers:
  - name: All Pages
    type: page_view

  - name: Purchase Completion
    type: page_path
    operator: equals
    value: /thank-you

上記のような定義ファイルを複数環境（本番 / ステージング）で使い回すことで、サイト横断の共通タグセットを一元管理できます。

定義ファイルからタグを生成するスクリプト例

async function applyTagsFromConfig(tagmanager: any, workspacePath: string, config: Config) {
  // 1. トリガーを先に作成
  for (const triggerDef of config.triggers) {
    await tagmanager.accounts.containers.workspaces.triggers.create({
      parent: workspacePath,
      requestBody: buildTriggerPayload(triggerDef),
    });
  }

  // 2. タグを作成
  for (const tagDef of config.tags) {
    await tagmanager.accounts.containers.workspaces.tags.create({
      parent: workspacePath,
      requestBody: buildTagPayload(tagDef),
    });
  }
}

buildTriggerPayload や buildTagPayload の中身は、Claude に 「GTM API v2 のスキーマに沿ってこのYAMLをペイロードに変換して」と指示することで大部分を自動生成できます。

Claude Codeを活用した開発フロー

開発フロー全体

Claude Code を活用した GTM 自動化の典型的なフローは以下の通りです。

既存GTMコンテナをエクスポート（JSON）し、Claude に読み込ませる
「この構成を再現できる設定スキーマを設計して」と指示する
Claude が提案したスキーマを微調整し、最終版を決める
スキーマを入力として GTM API ペイロードを生成するコードを作成してもらう
Claude Code のターミナルから実際にスクリプトを実行し、テストコンテナに反映
動作確認後、本番コンテナに適用する

Claude Codeに任せると効率が上がるポイント

GTM APIの型定義やレスポンス構造の推論
繰り返し出てくるボイラープレートコードの生成
タグ・トリガーの命名規則に沿った自動リネーム
複数コンテナ間の差分比較レポートの生成

特に、既存GTMの構成を「コード化」するフェーズは人手だと煩雑になりやすいため、Claude に「このJSONを読み込んで、構成のサマリと改善提案を出して」と振るのがおすすめです。

エラー・制約への対処とベストプラクティス

よくあるエラーと対処法

症状	原因	対処
401 / 403 エラー	認証情報の権限不足 / スコープ不足	サービスアカウントをGTMに招待し、`tagmanager.edit.containers` 以上の権限を付与
404 エラー	IDやパスの指定ミス	accounts > containers > workspaces の path をログに出して確認
400 エラー	ペイロードの必須項目不足 / 型不整合	公式ドキュメントとレスポンスサンプルを突き合わせ、Claude に修正を依頼