試合

エンドポイント： /wp-json/sportspress/v2/events

フィールド定義

日時フィールド

フィールド	説明
`date`	サイトのタイムゾーンでの公開日時（ISO 8601 形式）
`date_gmt`	GMT での公開日時（ISO 8601 形式）
`modified`	サイトのタイムゾーンでの最終更新日時（読み取り専用）
`modified_gmt`	GMT での最終更新日時（読み取り専用）

識別フィールド

フィールド	説明
`id`	オブジェクトの一意の識別子（整数、読み取り専用）
`guid`	グローバル一意識別子（読み取り専用）
`slug`	タイプ内で一意の英数字識別子
`link`	オブジェクトの URL（読み取り専用）

コンテンツフィールド

フィールド	説明
`title`	試合オブジェクトのタイトル
`content`	試合オブジェクトのコンテンツ
`excerpt`	試合オブジェクトの抜粋
`featured_media`	オブジェクトのアイキャッチ画像の ID

ステータスとアクセスフィールド

フィールド	説明
`status`	オブジェクトのステータス名；`publish`・`future`・`draft`・`pending`・`private` のいずれか
`password`	コンテンツと抜粋へのアクセスを保護するパスワード
`comment_status`	コメントが開いているかどうか；`open` または `closed`
`ping_status`	オブジェクトにピンを送れるかどうか；`open` または `closed`

著者と順序フィールド

フィールド	説明
`author`	オブジェクトの著者の ID
`menu_order`	同じタイプの他のオブジェクトに対するこのオブジェクトの順序

タクソノミーとリレーションシップフィールド

フィールド	説明
`leagues`	リーグタクソノミーでオブジェクトに割り当てられたタームの配列（タームIDの配列）
`seasons`	シーズンタクソノミーでオブジェクトに割り当てられたタームの配列（タームIDの配列）
`venues`	会場タクソノミーでオブジェクトに割り当てられたタームの配列（タームIDの配列）
`teams`	試合に参加するチームの ID（配列）
`players`	試合に参加する選手の ID（配列）
`staff`	試合に参加するスタッフの ID（配列）

試合固有のフィールド

フィールド	説明
`main_results`	試合のメイン結果（配列、チームごとに 1 つの値）
`outcome`	チームごとの試合結果（配列）
`winner`	勝利チームの ID
`minutes`	試合のフルタイムの分数（整数）
`results`	試合の全結果テーブル、チームごと（配列）
`performance`	試合の全パフォーマンス（ボックススコア）テーブル、チームごと（配列）

すべてのフィールドはコンテキストの可用性（view・edit・embed）を指定します。読み取り専用のフィールドは POST または PUT リクエストで設定できません。

リクエスト例

すべての試合を一覧表示

GET /wp-json/sportspress/v2/events

単一の試合を取得

GET /wp-json/sportspress/v2/events/123

試合を作成

POST /wp-json/sportspress/v2/events
Content-Type: application/json{
  "title": "チームA vs チームB",
  "status": "publish",
  "date": "2026-05-01T15:00:00",
  "teams": [10, 11],
  "leagues": [5],
  "seasons": [3]
}

試合結果を更新

PUT /wp-json/sportspress/v2/events/123
Content-Type: application/json{
  "results": {
    "10": { "goals": 2 },
    "11": { "goals": 1 }
  },
  "performance": {
    "10": {
      "42": { "goals": 1, "assists": 0 }
    }
  }
}

注意：REST API 経由での結果と選手パフォーマンスの更新には SportsPress Pro 2.7.8 以降が必要です（それ以前のバージョンでは API 経由での結果とボックススコアが更新されないバグがありました）。