- HTTP isteği
- İstek gövdesi
- Yanıt metni
- Yetkilendirme kapsamları
- RecallTokensCardinalityConstraint
- ConflictingLinksResolutionPolicy
- Durum
- Deneyin.
Sağlanan geri çağırma oturumu kimliğinde kodlanmış PGS oyuncusu ana hesabını bir oyun içi hesapla ilişkilendirme
HTTP isteği
POST https://games.googleapis.com/games/v1/recall:linkPersona
İstek içeriği
İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:
JSON gösterimi |
---|
{ "sessionId": string, "persona": string, "token": string, "cardinalityConstraint": enum ( |
Alanlar | |
---|---|
sessionId |
Zorunlu. PGS oynatıcısını / Google kullanıcısını ve uygulamasını tanımlamak için gerekli tüm bilgileri kodlayan, sunucu tarafından oluşturulmuş opak dize. |
persona |
Zorunlu. Oyun içi hesabın sabit tanımlayıcısı. Lütfen farklı oyunlarda aynı karakteri tekrar kullanmaktan kaçının. |
token |
Zorunlu. Oluşturulacak jetonun değeri. Play Games için opaktır ve kararsız olduğu varsayılır (anahtar rotasyonu ile şifrelenir). |
cardinalityConstraint |
Zorunlu. Bir oyun kapsamındaki bir karakter ile oyuncu arasında bağlantı oluştururken gözlemlenecek kardinalite kısıtlaması. |
conflictingLinksResolutionPolicy |
Zorunlu. Bir karakterin bir oyuncuya bağlanması, belirtilen kardinalite kısıtlamasının ihlal edilmesine neden olacaksa uygulanacak çözüm politikası. |
Birleştirme alanı expiration . İsteğe bağlı jetonun geçerlilik süresi veya geçerlilik süresi. expiration şunlardan yalnızca biri olabilir: |
|
expireTime |
Yalnızca giriş. İsteğe bağlı son kullanma tarihi. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: |
ttl |
Yalnızca giriş. İsteğe bağlı geçerlilik süresi. En fazla dokuz kesir basamağı olan ve " |
Yanıt gövdesi
Karakter bağlama girişiminin sonucu.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"state": enum ( |
Alanlar | |
---|---|
state |
Yalnızca çıkış. Karakter bağlantı denemesinin durumu. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamını gerektirir:
https://www.googleapis.com/auth/androidpublisher
Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.
RecallTokensCardinalityConstraint
Bir oyun kapsamındaki bir karakter ile oyuncu arasında bağlantı oluştururken gözlemlenecek kardinalite kısıtlaması.
Sıralamalar | |
---|---|
ONE_PERSONA_TO_ONE_PLAYER |
Oyun içi karakterler ve Play Games Hizmetleri oyuncuları arasındaki 1:1 kardinalite. Bağlantı oluşturma işleminin sonunda, oynatıcı ve karakter için yalnızca bir giriş uygulama kapsamında kalmalıdır. Bu kısıtlama belirtildiğinde yeni bir bağlantının oluşturulup oluşturulmayacağı, seçilen
|
ConflictingLinksResolutionPolicy
Bir karakterin bir oyuncuya bağlanması, belirtilen kardinalite kısıtlamasının ihlal edilmesine neden olacaksa uygulanacak çözüm politikası.
Sıralamalar | |
---|---|
KEEP_EXISTING_LINKS |
Bir oyuncu ile karakter arasında halihazırda bağlantılar varsa ve yeni bağlantı oluşturulduğunda belirtilen Örneğin, Persona1-Player1, uygulama1 kapsamında zaten bağlıysa ve uygulama1 kapsamında yeni bir Persona1-Player2 bağlantısı oluşturulmaya çalışılırsa, eski bağlantı kalır ve yeni bir bağlantı eklenmez. Mevcut bağlantılar belirtilen politikayı ihlal ediyorsa (bu durum, tüm |
CREATE_NEW_LINK |
Bir oyuncu ile karakter arasında zaten mevcut bir bağlantı varsa ve yeni bağlantı oluşturulduğunda belirtilen Örneğin, Persona1-Player1, uygulama1 kapsamında zaten bağlıysa ve uygulama1 kapsamında yeni bir Persona1-Player2 bağlantısı oluşturulmaya çalışılırsa, eski bağlantı kaldırılır ve yerine yeni bağlantı eklenir. |
Eyalet
Karakter bağlantı denemesinin durumu.
Sıralamalar | |
---|---|
LINK_CREATED |
İstekte belirtilen bağlantı oluşturuldu. |
PERSONA_OR_PLAYER_ALREADY_LINKED |
Mevcut bağlantılar oluşturulursa belirtilen RecallTokensCardinalityConstraint politikasını ihlal eden yeni bağlantıyla sonuçlanacağından istekte belirtilen bağlantı oluşturulmadı. |