メインコンテンツまでスキップ

API バージョン互換性

クイックバージョン確認​

どのバージョンを使っているかわからない場合は、以下で確認できます。 WordPress 管理画面 → プラグイン → QA Platform

または、/guide エンドポイントを呼び出して plugin_version を確認します。

互換性マトリクス​

プラグインバージョン互換性のある API バージョンステータス備考
3.0.0.0+2026-05-11, 2025-10-20✅ Current両バージョンとも同じプラグインで提供。?version= で選択
2.x.x.x-❌ UnsupportedAPI 利用不可

Version 2026-05-11​

最小プラグインバージョン: 3.0.0.0 リリース日: 2026-05-11 ステータス: Current Release

2025-10-20 からの変更点​

  • 破壊的変更: calc 内の join.with 側の material.column 参照が、from 側と同じく fetch + preserve のトリガーになりました。click_event を join 対象としたときに 0 を返していた COUNT(click_event.pv_id) のような集計が、正しいカウントを返すようになります。
  • 新エラー: E_CALC_COLUMN_UNRESOLVED — ビューのスコープに存在しないマテリアルや、マテリアルのスキーマに存在しない列を calc から参照するクエリが、サイレントに 0 行を返す代わりにバリデーション時に失敗します。
  • 新エラー詳細: E_INVALID_JOIN のレスポンスに details.side、details.received_value、details.expected_prefix、details.hint が乗るようになり、AI の修復ループが推測せずにどちら側を直すべきか分かるようになります。
  • 新しい機能フラグ: features_detail.calc_join_symmetric（since 2026-05-11）。

join 側 calc に依存していない既存のクライアントコードは、両バージョンに対して同じく動作します。新挙動が欲しい場合は ?version=2026-05-11 を明示してください。移行は不要です。

Version 2025-10-20​

最小プラグインバージョン: 3.0.0.0 リリース日: 2025-10-20 ステータス: Previous（引き続きサポート）

プラグイン要件​

機能最小プラグインバージョン備考
Core API3.0.0.0基本機能
tracking_id parameter3.0.0.0すべてのクエリで必須
/guide endpoint (full)3.0.0.0サーバー情報、サイト、マテリアル、ゴール
/query endpoint3.0.0.0QAL クエリ実行

マテリアルサポート​

マテリアル最小プラグインバージョン機能セット
allpv3.0.0.0フルカラムセット
gsc3.0.0.0フルカラムセット

プラグインバージョンの確認方法​

方法 1: WordPress 管理画面​

  1. プラグイン ページに移動
  2. QA Platform を見つける
  3. プラグイン名の下にバージョンが表示されます

方法 2: API 呼び出し​

curl -u "username:password" \
  "https://your-site.com/wp-json/qa-platform/guide?version=2026-05-11"

レスポンスには以下が含まれます。

{
  "version": "2026-05-11",
  "plugin_version": "3.0.0.0",
  ...
}

プラグインバージョン別の機能の利用可否​

Plugin 3.0.0.0​

このバージョンでの新機能:

  • ✅ REST API サポート（2025-10-20）
  • ✅ tracking_id によるマルチサイトトラッキング
  • ✅ 拡張された /guide エンドポイント
  • ✅ QAL クエリ言語
  • ✅ マテリアル: allpv, gsc

フィールドの変更:

  • 🔄 country → country_code（ISO 3166-1 alpha-2）
  • ❌ 削除済み: session_id, tracking_domain, path_prefix, utm_content, utm_term, version_id
  • ❌ 削除済み: すべての goal フィールド（is_goal_0 から is_goal_10、is_submit）

マイグレーションガイド​

API 導入以前のバージョン（< 3.0）から​

それ以前のプラグインバージョンからアップグレードする場合の手順です。

  1. プラグインを更新: 3.0.0.0+ にアップグレード
  2. tracking_id を取得: /guide エンドポイントを呼び出す
  3. 連携を更新: すべてのクエリに tracking_id を追加
  4. フィールドの変更: country を country_code に更新
  5. テスト: 新しい API でクエリが動作することを検証

破壊的変更:

  • API エンドポイントは 3.0.0.0 以前には存在しませんでした
  • カスタム連携があった場合は、完全な書き直しが必要です

将来のバージョン​

計画中の機能（将来のプラグインバージョン）​

現在検討中の機能です。

  • 高度なフィルタリング（QAL の filter）
  • マテリアルの結合（QAL の join）
  • 集計（QAL の calc）
  • 追加のマテリアル（clicks, ec, inner_search）
  • CSV / Parquet エクスポート形式

リリース日とバージョンは未定

サポートポリシー​

長期サポート​

  • 最低サポート期間: リリースから 24 ヶ月
  • API バージョン 2025-10-20: 少なくとも 2027-10-20 までサポート

プラグインバージョンのサポート​

  • 最新バージョン: フルサポート
  • 1 つ前のバージョン: セキュリティアップデートのみ
  • それ以前のバージョン: サポートなし

現在のサポートステータス:

  • 3.0.0.0: ✅ フルサポート

トラブルシューティング​

「Unknown tracking_id」エラー​

原因: プラグインバージョンが 3.0.0.0 未満
解決策: 3.0.0.0+ にアップグレード

「Endpoint not found」エラー​

原因: プラグインバージョンが 3.0.0.0 未満
解決策: 3.0.0.0+ にアップグレード

マテリアルやフィールドが見当たらない​

原因: プラグインバージョンが古すぎる
解決策: 上記の互換性マトリクスを確認してアップグレード

ヘルプを得る​

  • ドキュメント: Version 2025-10-20
  • プラグインの更新: WordPress プラグインリポジトリを確認
  • サポート: システム管理者にお問い合わせください

バージョン履歴​

プラグインバージョンAPI バージョンリリース日ステータス
3.0.0.02026-05-11, 2025-10-202026-05-11（最新の version bump）Current
3.0.0.02025-10-202025-10-20初期リリース

次のステップ​