Method: players.list

Şu anda kimliği doğrulanmış kullanıcının oyuncu koleksiyonunu alın.

HTTP isteği

GET https://games.googleapis.com/games/v1/players/me/players/{collection}

Yol parametreleri

Parametreler
collection

enum (Collection)

Alınan oyuncu koleksiyonu

Sorgu parametreleri

Parametreler
language

string

Bu yöntem tarafından döndürülen dizelerde kullanılacak tercih edilen dil.

maxResults

integer

Sayfalara ayırma için kullanılan, yanıtta döndürülecek maksimum oynatıcı kaynağı sayısı. Herhangi bir yanıtta, döndürülen gerçek oyuncu kaynağı 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

Üçüncü taraf oynatıcı listesi 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 (Player)
    }
  ]
}
Alanlar
kind

string

Bu kaynağın türünü benzersiz bir şekilde tanımlar. Değer her zaman games#playerListResponse sabit dizesidir.

nextPageToken

string

Sonuçların bir sonraki sayfasına karşılık gelen jeton.

items[]

object (Player)

Oyuncular.

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.

Koleksiyon

Sıralamalar
CONNECTED

Bu oyunu da oynayan oyuncuların ters kronolojik sırayla bir listesini alın.

VISIBLE

Kullanıcının sosyal grafiğindeki ve bu oyunda görünen oyuncuların listesini alın.

FRIENDS_ALL Kullanıcının arkadaşları olan oyuncuların alfabetik sırayla listesini alın.