- HTTP isteği
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- EventsUpdates
- EventPeriodUpdate
- EventPeriodRange
- EventUpdateRequest
- EventBatchRecordFailure
- EventFailureCause
- EventRecordFailure
- EventUpdateFailureCause
- Deneyin.
Bu uygulamanın kimliği doğrulanmış o anki kullanıcısı için etkinliklerin gerçekleşme sayısında yapılan değişiklikleri toplu olarak kaydeder.
HTTP isteği
POST https://games.googleapis.com/games/v1/events
Sorgu parametreleri
Parametreler | |
---|---|
language |
Bu yöntemin döndürdüğü dizeler için kullanılması tercih edilen dil. |
İstek içeriği
İstek metni, EventsUpdates
öğesinin bir örneğini içerir.
Yanıt gövdesi
Etkinlik dönemi güncelleme kaynağı.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "kind": string, "batchFailures": [ { object ( |
Alanlar | |
---|---|
kind |
Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman sabit |
batchFailures[] |
Güncellemeler uygulanırken oluşan grup genelindeki hatalar. |
eventFailures[] |
Belirli bir etkinliğin güncellenmesi başarısız oldu. |
playerEvents[] |
Güncellenen etkinliklerin mevcut durumu |
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.
EventsUpdates
Etkinlik dönemi güncelleme kaynağı.
JSON gösterimi |
---|
{
"kind": string,
"requestId": string,
"currentTimeMillis": string,
"timePeriods": [
{
object ( |
Alanlar | |
---|---|
kind |
Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman sabit |
requestId |
Bu etkinlik kaydetme girişimini tanımlamak için kullanılan istek kimliği. |
currentTimeMillis |
1970 UTC'den (Unix Epoch) itibaren bu güncellemenin milisaniye cinsinden gönderildiği geçerli zaman. |
timePeriods[] |
Bu istekte yapılan dönem güncellemelerinin listesi. |
EventPeriodUpdate
Etkinlik dönemi güncelleme kaynağı.
JSON gösterimi |
---|
{ "timePeriod": { object ( |
Alanlar | |
---|---|
timePeriod |
Bu güncellemenin kapsadığı dönem. |
updates[] |
Bu dönem için yapılan güncellemeler. |
kind |
Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman sabit |
EventPeriodRange
Etkinlik dönemi zaman aralığıdır.
JSON gösterimi |
---|
{ "kind": string, "periodStartMillis": string, "periodEndMillis": string } |
Alanlar | |
---|---|
kind |
Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman sabit |
periodStartMillis |
1970 UTC'den (Unix Epoch) itibaren bu güncelleme döneminin başladığı zaman (milisaniye cinsinden). |
periodEndMillis |
Bu güncelleme döneminin sona erdiği saat (milisaniye cinsinden), 1970 UTC'den (Unix Epoch) itibaren. |
EventUpdateRequest
Etkinlik dönemi güncelleme kaynağı.
JSON gösterimi |
---|
{ "definitionId": string, "updateCount": string, "kind": string } |
Alanlar | |
---|---|
definitionId |
Bu güncellemede değiştirilen etkinliğin kimliği. |
updateCount |
Bu etkinliğin bu dönem içinde gerçekleşme sayısı. |
kind |
Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman sabit |
EventBatchRecordFailure
Toplu güncelleme hatası kaynağı.
JSON gösterimi |
---|
{ "range": { object ( |
Alanlar | |
---|---|
range |
Reddedilen zaman aralığı boş bırakın. |
failureCause |
Güncelleme hatasının nedeni. |
kind |
Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman sabit |
EventFailureCause
Etkinlik hatası nedeni için olası değerler.
Sıralamalar | |
---|---|
TOO_LARGE |
Tek bir grupta izin verilenden daha fazla etkinlik içeren bir toplu istek gönderildi. |
TIME_PERIOD_EXPIRED |
Kaydedilemeyecek kadar eski verilere sahip bir grup gönderildi. |
TIME_PERIOD_SHORT |
Çok kısa bir zaman aralığıyla bir grup gönderildi. |
TIME_PERIOD_LONG |
Zaman aralığı çok uzun olan bir grup gönderildi. |
ALREADY_UPDATED |
Daha önce görülen bir veri grubunun kaydedilmesine çalışıldı. |
RECORD_RATE_HIGH |
Verilerin, sunucunun güncellemeleri uygulayacağından daha hızlı şekilde kaydedilmeye çalışıldı. |
EventRecordFailure
Etkinlik güncelleme hatası kaynağı.
JSON gösterimi |
---|
{
"eventId": string,
"failureCause": enum ( |
Alanlar | |
---|---|
eventId |
Güncellenmeyen etkinliğin kimliği. |
failureCause |
Güncelleme hatasının nedeni. |
kind |
Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman sabit |
EventUpdateFailureCause
Etkinlik güncelleme hatasının nedenine ilişkin olası değerler.
Sıralamalar | |
---|---|
NOT_FOUND |
Tanımlanmamış bir etkinlik ayarlamak için girişimde bulunuldu. |
INVALID_UPDATE_VALUE |
Bir etkinliği pozitif olmayan bir değer oranında artırma girişiminde bulunuldu. |