Method: events.listDefinitions

傳回此應用程式中的事件定義清單。

HTTP 要求

GET https://games.googleapis.com/games/v1/eventDefinitions

查詢參數

參數
language

string

此方法傳回字串的偏好語言。
maxResults

integer

回應中要傳回的事件定義數量上限，用於分頁。對任何回應而言，要傳回的事件定義實際數量可能少於指定的 maxResults。
pageToken

string

先前要求傳回的權杖。

要求主體

要求主體必須為空白。

回應主體

ListDefinitions 回應。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "kind": string,
  "nextPageToken": string,
  "items": [
    {
      object (EventDefinition)
    }
  ]
}
欄位
kind

string

專門用於識別這項資源的類型。值一律為固定字串 games#eventDefinitionListResponse。
nextPageToken

string

下一頁結果的分頁符記。
items[]

object (EventDefinition)

事件定義。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

詳情請參閱 OAuth 2.0 總覽。

EventDefinition

事件定義資源。

JSON 表示法 
{
  "id": string,
  "visibility": enum (EventVisibility),
  "displayName": string,
  "imageUrl": string,
  "childEvents": [
    {
      object (EventChild)
    }
  ],
  "description": string,
  "isDefaultImageUrl": boolean,
  "kind": string
}
欄位
id

string

事件 ID。
visibility

enum (EventVisibility)

此定義所追蹤事件的顯示設定。
displayName

string

顯示的事件名稱。
imageUrl

string

代表事件的圖片基準網址。
childEvents[]

object (EventChild)

此事件的子項事件清單。
description

string

此事件代表的說明。
isDefaultImageUrl

boolean

指出傳回的圖示圖片是預設圖片，還是由遊戲提供。
kind

string

專門用於識別這項資源的類型。值一律為固定字串 games#eventDefinition。

EventVisibility

事件的瀏覽權限可能值。

列舉
REVEALED 所有使用者都應能看到這個活動。
HIDDEN 此事件只應向曾記錄過此事件的使用者顯示。

EventChild

事件子項關係資源。

JSON 表示法 
{
  "childId": string,
  "kind": string
}
欄位
childId

string

子事件的 ID。
kind

string

專門用於識別這項資源的類型。值一律為固定字串 games#eventChild。