Events: listByPlayer

現在認証されているユーザーについて、このアプリケーションのイベントの現在の進捗状況を示すリストを返します。 実習をご覧ください。

リクエスト

HTTP リクエスト

GET https://www.googleapis.com/games/v1/events

パラメータ

パラメータ名 値 説明
省略可能なクエリ パラメータ
language string このメソッドから返される文字列に使用する言語。
maxResults integer レスポンスで返されるイベントの最大数。ページ設定に使用されます。どのようなレスポンスでも、返されるイベントの実際の数は、指定した maxResults より少ない場合があります。 有効な値は 1～100（指定した値を含む）です。
pageToken string 前のリクエストによって返されたトークン。

承認

このリクエストには、次のスコープによる認証が必要です。

範囲
https://www.googleapis.com/auth/games

詳細については、認証と承認のページをご覧ください。

リクエスト本文

このメソッドをリクエストの本文に含めないでください。

レスポンス

成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。

{
  "kind": "games#playerEventListResponse",
  "nextPageToken": string,
  "items": [
    {
      "kind": "games#playerEvent",
      "definitionId": string,
      "playerId": string,
      "numEvents": long,
      "formattedNumEvents": string
    }
  ]
}
プロパティ名 値 説明 備考
kind string このリソースの種類を一意に識別します。値は常に固定文字列の games#playerEventListResponse です。
nextPageToken string 結果の次のページのページネーション トークン。
items[] list プレーヤー イベント。
items[].kind string このリソースの種類を一意に識別します。値は常に固定文字列の games#playerEvent です。
items[].definitionId string イベント定義の ID。
items[].playerId string プレーヤーの ID。
items[].numEvents long このイベントが発生した現在の回数。
items[].formattedNumEvents string イベントが発生した現在の回数（文字列）。この文字列の形式は、Google Play ゲーム デベロッパー コンソールでのイベントの設定によって異なります。

実習

以下の API Explorer を使用して、ライブデータでこのメソッドを呼び出し、レスポンスを確認します。