選手

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

フィールド定義

識別と公開フィールド

フィールド	説明
`id`	オブジェクトの一意の識別子（整数、読み取り専用）
`guid`	グローバル一意識別子（読み取り専用）
`slug`	タイプ内で一意の URL に適した英数字識別子
`link`	オブジェクトの URL（読み取り専用）
`date`	サイトのタイムゾーンでの公開タイムスタンプ（ISO 8601）
`date_gmt`	GMT での公開日時（ISO 8601）
`modified`	サイトのタイムゾーンでの最終更新日時（読み取り専用）
`modified_gmt`	GMT での最終更新日時（読み取り専用）
`status`	公開状態；`publish`・`future`・`draft`・`pending`・`private` のいずれか

コンテンツとメタデータフィールド

フィールド	説明
`title`	選手の名前
`content`	選手の経歴または説明
`excerpt`	選手の簡単な概要
`featured_media`	選手の写真（アイキャッチ画像）の ID
`author`	作成者のユーザーアカウントの ID

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

フィールド	説明
`password`	コンテンツと抜粋へのアクセスを保護するパスワード
`comment_status`	コメントが開いているかどうか；`open` または `closed`
`ping_status`	オブジェクトにピンを送れるかどうか；`open` または `closed`
`menu_order`	同じタイプの他のオブジェクトに対するこのオブジェクトの順序

タクソノミーフィールド

フィールド	説明
`leagues`	リーグタクソノミーでオブジェクトに割り当てられたタームの配列（タームIDの配列）
`seasons`	シーズンタクソノミーでオブジェクトに割り当てられたタームの配列（タームIDの配列）
`positions`	ポジションタクソノミーでオブジェクトに割り当てられたタームの配列（タームIDの配列）

選手固有のフィールド

フィールド	説明
`number`	選手の背番号（整数）
`nationalities`	選手の国籍を示す 3 文字の国コード（文字列の配列）
`teams`	選手が所属するすべてのチームの ID（配列 — 現在および過去）
`current_teams`	選手が現在所属するチームの ID（配列）
`past_teams`	選手が過去に所属したチームの ID（配列）
`metrics`	選手のパフォーマンス測定値（身長・体重などの固定値）
`statistics`	リーグとシーズンに基づくパフォーマンスデータ（計算値）

ほとんどのフィールドは複数のコンテキスト（view・edit・embed）をサポートし、異なる API アクセスシナリオでの表示と変更権限を制御します。

既知の制限事項

REST API 経由で作成した選手は選手リストに自動的に表示されない場合があります。これはサポートフォーラムに記載されている既知の問題です。API で選手を作成した後、WordPress 管理画面で選手が正しいチームに割り当てられているか確認し、その選手リストがそのチームの選手を含む設定になっているか確認してください。

リクエスト例

すべての選手を一覧表示

GET /wp-json/sportspress/v2/players

単一の選手を取得

GET /wp-json/sportspress/v2/players/55

選手を作成

POST /wp-json/sportspress/v2/players
Content-Type: application/json{
  "title": "田中 太郎",
  "status": "publish",
  "number": 10,
  "nationalities": ["jpn"],
  "current_teams": [10],
  "leagues": [5],
  "seasons": [3],
  "positions": [7]
}

選手のメトリクスを更新

PUT /wp-json/sportspress/v2/players/55
Content-Type: application/json{
  "metrics": {
    "height": "180",
    "weight": "75"
  }
}

注意：REST API 経由での選手メトリクスの更新には SportsPress Pro 2.7.3 以降が必要です。

リーグとシーズンで選手をフィルタリング

GET /wp-json/sportspress/v2/players?leagues=5&seasons=3

選手リストエンドポイントのフィルタリングは SportsPress Pro 2.5.5 で追加されました。