Method: events.listDefinitions
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu uygulamadaki etkinlik tanımlarının listesini döndürür.
HTTP isteği
GET https://games.googleapis.com/games/v1/eventDefinitions
Sorgu parametreleri
Parametreler |
language |
string
Bu yöntemin döndürdüğü dizeler için kullanılması tercih edilen dil.
|
maxResults |
integer
Sayfalara ayırma için kullanılan, yanıtta döndürülecek maksimum etkinlik tanımı sayısı. Tüm yanıtlar için döndürülecek gerçek etkinlik tanımları sayısı, belirtilen maxResults değerinden az olabilir.
|
pageToken |
string
Önceki istek tarafından döndürülen jeton.
|
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
ListDefinitions yanıtı.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
{
"kind": string,
"nextPageToken": string,
"items": [
{
object (EventDefinition )
}
]
} |
Alanlar |
kind |
string
Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman sabit games#eventDefinitionListResponse dizesidir.
|
nextPageToken |
string
Sonraki sonuç sayfası için sayfalara ayırma jetonu.
|
items[] |
object (EventDefinition )
Etkinlik tanımları.
|
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.
EventDefinition
JSON gösterimi |
{
"id": string,
"visibility": enum (EventVisibility ),
"displayName": string,
"imageUrl": string,
"childEvents": [
{
object (EventChild )
}
],
"description": string,
"isDefaultImageUrl": boolean,
"kind": string
} |
Alanlar |
id |
string
Etkinliğin kimliği.
|
visibility |
enum (EventVisibility )
Bu tanımda izlenen etkinliğin görünürlüğü.
|
displayName |
string
Etkinlik için gösterilecek ad.
|
imageUrl |
string
Etkinliği temsil eden resmin temel URL'si.
|
childEvents[] |
object (EventChild )
Bu etkinliğin alt etkinliği olan etkinliklerin listesi.
|
description |
string
Bu etkinliğin temsil ettiği öğelerin açıklaması.
|
isDefaultImageUrl |
boolean
Döndürülen simge resminin varsayılan bir resim mi olduğunu yoksa oyun tarafından mı sağlandığını belirtir.
|
kind |
string
Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman sabit games#eventDefinition dizesidir.
|
EventVisibility
Bir etkinliğin görünürlüğü için olası değerler.
Sıralamalar |
REVEALED |
Bu etkinlik tüm kullanıcılar tarafından görülebilir olmalıdır. |
HIDDEN |
Bu etkinlik yalnızca bu etkinliği en az bir kez kaydeden kullanıcılara gösterilmelidir. |
EventChild
Etkinlik alt ilişkisi kaynağı.
JSON gösterimi |
{
"childId": string,
"kind": string
} |
Alanlar |
childId |
string
Alt etkinliğin kimliği.
|
kind |
string
Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman sabit games#eventChild dizesidir.
|
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-27 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-27 UTC."],[],[],null,["# Method: events.listDefinitions\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListEventDefinitionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [EventDefinition](#EventDefinition)\n - [JSON representation](#EventDefinition.SCHEMA_REPRESENTATION)\n- [EventVisibility](#EventVisibility)\n- [EventChild](#EventChild)\n - [JSON representation](#EventChild.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nReturns a list of the event definitions in this application.\n\n### HTTP request\n\n`GET https://games.googleapis.com/games/v1/eventDefinitions`\n\n### Query parameters\n\n| Parameters ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `language` | `string` The preferred language to use for strings returned by this method. |\n| `maxResults` | `integer` The maximum number of event definitions to return in the response, used for paging. For any response, the actual number of event definitions to return may be less than the specified `maxResults`. |\n| `pageToken` | `string` The token returned by the previous request. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA ListDefinitions response.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"nextPageToken\": string, \"items\": [ { object (/games/services/web/api/rest/v1/events/listDefinitions#EventDefinition) } ] } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#eventDefinitionListResponse`. |\n| `nextPageToken` | `string` The pagination token for the next page of results. |\n| `items[]` | `object (`[EventDefinition](/games/services/web/api/rest/v1/events/listDefinitions#EventDefinition)`)` The event definitions. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/games`\n- `\n https://www.googleapis.com/auth/games_lite`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2).\n\nEventDefinition\n---------------\n\nAn event definition resource.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"visibility\": enum (/games/services/web/api/rest/v1/events/listDefinitions#EventVisibility), \"displayName\": string, \"imageUrl\": string, \"childEvents\": [ { object (/games/services/web/api/rest/v1/events/listDefinitions#EventChild) } ], \"description\": string, \"isDefaultImageUrl\": boolean, \"kind\": string } ``` |\n\n| Fields ||\n|---------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string` The ID of the event. |\n| `visibility` | `enum (`[EventVisibility](/games/services/web/api/rest/v1/events/listDefinitions#EventVisibility)`)` The visibility of event being tracked in this definition. |\n| `displayName` | `string` The name to display for the event. |\n| `imageUrl` | `string` The base URL for the image that represents the event. |\n| `childEvents[]` | `object (`[EventChild](/games/services/web/api/rest/v1/events/listDefinitions#EventChild)`)` A list of events that are a child of this event. |\n| `description` | `string` Description of what this event represents. |\n| `isDefaultImageUrl` | `boolean` Indicates whether the icon image being returned is a default image, or is game-provided. |\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#eventDefinition`. |\n\nEventVisibility\n---------------\n\nPossible values for the visibility of an event.\n\n| Enums ||\n|------------|---------------------------------------------------------------------------------------|\n| `REVEALED` | This event should be visible to all users. |\n| `HIDDEN` | This event should only be shown to users that have recorded this event at least once. |\n\nEventChild\n----------\n\nAn event child relationship resource.\n\n| JSON representation |\n|-----------------------------------------------|\n| ``` { \"childId\": string, \"kind\": string } ``` |\n\n| Fields ||\n|-----------|--------------------------------------------------------------------------------------------------------------|\n| `childId` | `string` The ID of the child event. |\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#eventChild`. |"]]