Bu sayfa, Cloud Translation API ile çevrilmiştir.

Method: recall.linkPersona

HTTP isteği
İstek metni
- JSON gösterimi
Yanıt metni
- JSON gösterimi
Yetkilendirme kapsamları
RecallTokensCardinalityConstraint
ConflictingLinksResolutionPolicy
Durum
Deneyin.

Sağlanan geri çağırma oturumu kimliğinde kodlanan PGS Player ana hesabını bir oyun içi hesapla ilişkilendirmek

HTTP isteği

POST https://games.googleapis.com/games/v1/recall:linkPersona

İstek içeriği

İstek gövdesi, aşağıdaki yapıyla birlikte veriler içerir:

JSON gösterimi

JSON gösterimi
{ "sessionId": string, "persona": string, "token": string, "cardinalityConstraint": enum (`RecallTokensCardinalityConstraint`), "conflictingLinksResolutionPolicy": enum (`ConflictingLinksResolutionPolicy`), // Union field `expiration` can be only one of the following: "expireTime": string, "ttl": string // End of list of possible types for union field `expiration`. }

{
  "sessionId": string,
  "persona": string,
  "token": string,
  "cardinalityConstraint": enum (RecallTokensCardinalityConstraint),
  "conflictingLinksResolutionPolicy": enum (ConflictingLinksResolutionPolicy),

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
}

Alanlar
`sessionId`	`string` 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şturulan opak dize.
`persona`	`string` Zorunlu. Oyun içi hesabın kararlı tanımlayıcısı. Lütfen aynı karakteri farklı oyunlar için kullanmayın.
`token`	`string` Zorunlu. Oluşturulacak jetonun değeri. Play Games'e karşı mat ve kararlı olmadığı varsayılmıştır (anahtar rotasyonu ile şifrelenir).
`cardinalityConstraint`	`enum (RecallTokensCardinalityConstraint)` Zorunlu. Karakter ile oyun kapsamındaki bir oyuncu arasında bağlantı oluştururken dikkat edilmesi gereken kardinalite kısıtlaması.
`conflictingLinksResolutionPolicy`	`enum (ConflictingLinksResolutionPolicy)` Zorunlu. Bir karakterin bir oyuncuya bağlanması, belirtilen kardinalite kısıtlamasını ihlal etmesiyle sonuçlandığında uygulanacak çözüm politikası.
`expiration` alanı. İsteğe bağlı jeton geçerlilik süresi veya geçerlilik süresi. `expiration` şunlardan yalnızca biri olabilir:
`expireTime`	`string (Timestamp format)` Yalnızca giriş. İsteğe bağlı geçerlilik süresi. Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: `"2014-10-02T15:01:23Z"` ve `"2014-10-02T15:01:23.045123456Z"`.
`ttl`	`string (Duration format)` Yalnızca giriş. İsteğe bağlı geçerlilik süresi. En fazla dokuz kesir basamağı içeren ve "`s`" ile biten saniye cinsinden bir süre. Örnek: `"3.5s"`.

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 (`State`) }

Alanlar

Alanlar
`state`	`enum (State)` Yalnızca çıkış. Karakter bağlama girişiminin durumu.

state

enum (State)

Yalnızca çıkış. Karakter bağlama girişiminin durumu.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

https://www.googleapis.com/auth/androidpublisher

Daha fazla bilgi için OAuth 2.0'a Genel Bakış başlıklı makaleye bakın.

RecallTokensCardinalityConstraint

Karakter ile oyun kapsamındaki bir oyuncu arasında bağlantı oluştururken dikkat edilmesi gereken kardinalite kısıtlaması.

Sıralamalar

Sıralamalar
`ONE_PERSONA_TO_ONE_PLAYER`	Oyun içi karakterler ve Play Games Hizmetleri oyuncuları arasındaki bire bir kardinalite. Bağlantı oluşturma işlemi sona erdiğinde oynatıcı ve karakter için yalnızca bir giriş, uygulamanın kapsamında kalmalıdır. Bu kısıtlama belirtildiğinde yeni bir bağlantı oluşturulup oluşturulmayacağı seçilen `ConflictingLinksResolutionPolicy` tarafından belirlenir: `KEEP_EXISTING_LINKS` belirtilirse ve sağlanan karakter farklı bir oyuncuya bağlıysa veya oynatıcı farklı bir karaktere zaten bağlıysa yeni bağlantı oluşturulmaz ve mevcut bağlantılar olduğu gibi kalır. `CREATE_NEW_LINK` belirtilirse ve sağlanan karakter farklı bir oyuncuya bağlıysa ya da oynatıcı zaten başka bir karakterle bağlantılıysa yeni bağlantı oluşturulmak üzere eski bağlantılar kaldırılır.

ONE_PERSONA_TO_ONE_PLAYER

Oyun içi karakterler ve Play Games Hizmetleri oyuncuları arasındaki bire bir kardinalite.

Bağlantı oluşturma işlemi sona erdiğinde oynatıcı ve karakter için yalnızca bir giriş, uygulamanın kapsamında kalmalıdır.

Bu kısıtlama belirtildiğinde yeni bir bağlantı oluşturulup oluşturulmayacağı seçilen ConflictingLinksResolutionPolicy tarafından belirlenir:

KEEP_EXISTING_LINKS belirtilirse ve sağlanan karakter farklı bir oyuncuya bağlıysa veya oynatıcı farklı bir karaktere zaten bağlıysa yeni bağlantı oluşturulmaz ve mevcut bağlantılar olduğu gibi kalır.
CREATE_NEW_LINK belirtilirse ve sağlanan karakter farklı bir oyuncuya bağlıysa ya da oynatıcı zaten başka bir karakterle bağlantılıysa yeni bağlantı oluşturulmak üzere eski bağlantılar kaldırılır.

ConflictingLinksResolutionPolicy

Bir karakterin bir oyuncuya bağlanması, belirtilen kardinalite kısıtlamasını ihlal etmesiyle sonuçlandığında uygulanacak çözüm politikası.

Sıralamalar

Sıralamalar
`KEEP_EXISTING_LINKS`	Oynatıcı ile karakter arasında, yeni bağlantı oluşturulması durumunda belirtilen `RecallTokensCardinalityConstraint` ihlaline neden olacak bağlantılar varsa mevcut bağlantıları koruyun. Örneğin, Karakter1-Oyuncu1, uygulama1 kapsamında zaten bağlıysa ve uygulama1 kapsamında `MANY_PERSONAS_TO_ONE_PLAYER` kısıtlamasıyla birlikte yeni bir Persona1-Player2 bağlantısı oluşturulmaya çalışılırsa eski bağlantı kalır ve yeni bağlantı eklenmez. Mevcut bağlantılar belirtilen politikayı ihlal ediyorsa (bu, tüm `recall.linkPersona` çağrıları aynı `RecallTokensCardinalityConstraint` kullanmıyorsa gerçekleşebilir) bu politikanın söz konusu ihlalleri çözülmeden bırakacağını unutmayın. Anlaşmazlıkları çözmek üzere, çakışmaları çözümleyen bağlantıları yeniden yazmak için {@link `CREATE_NEW_LINK` politikasının kullanılması gerekir.
`CREATE_NEW_LINK`	Oynatıcı ve karakter arasında halihazırda mevcut bir bağlantı varsa ve yeni bağlantı oluşturulursa belirtilen `RecallTokensCardinalityConstraint` ihlaline neden olacaksa mevcut bağlantıları yeni bağlantıyla değiştirin. Örneğin, Karakter1-Oyuncu1 zaten uygulama1 kapsamında bağlıysa ve uygulama1 kapsamında `MANY_PERSONAS_TO_ONE_PLAYER` kısıtlamasıyla yeni bir Persona1-Player2 bağlantısı oluşturulmaya çalışılırsa eski bağlantı kaldırılır ve bunun yerine yeni bağlantı eklenir.

KEEP_EXISTING_LINKS

Oynatıcı ile karakter arasında, yeni bağlantı oluşturulması durumunda belirtilen RecallTokensCardinalityConstraint ihlaline neden olacak bağlantılar varsa mevcut bağlantıları koruyun.

Örneğin, Karakter1-Oyuncu1, uygulama1 kapsamında zaten bağlıysa ve uygulama1 kapsamında MANY_PERSONAS_TO_ONE_PLAYER kısıtlamasıyla birlikte yeni bir Persona1-Player2 bağlantısı oluşturulmaya çalışılırsa eski bağlantı kalır ve yeni bağlantı eklenmez.

Mevcut bağlantılar belirtilen politikayı ihlal ediyorsa (bu, tüm recall.linkPersona çağrıları aynı RecallTokensCardinalityConstraint kullanmıyorsa gerçekleşebilir) bu politikanın söz konusu ihlalleri çözülmeden bırakacağını unutmayın. Anlaşmazlıkları çözmek üzere, çakışmaları çözümleyen bağlantıları yeniden yazmak için {@link CREATE_NEW_LINK politikasının kullanılması gerekir.

CREATE_NEW_LINK

Oynatıcı ve karakter arasında halihazırda mevcut bir bağlantı varsa ve yeni bağlantı oluşturulursa belirtilen RecallTokensCardinalityConstraint ihlaline neden olacaksa mevcut bağlantıları yeni bağlantıyla değiştirin.

Örneğin, Karakter1-Oyuncu1 zaten uygulama1 kapsamında bağlıysa ve uygulama1 kapsamında MANY_PERSONAS_TO_ONE_PLAYER kısıtlamasıyla yeni bir Persona1-Player2 bağlantısı oluşturulmaya çalışılırsa eski bağlantı kaldırılır ve bunun yerine yeni bağlantı eklenir.

Eyalet

Karakter bağlama girişiminin durumu.

Sıralamalar
`LINK_CREATED`	İstekte belirtilen bağlantı oluşturuldu.
`PERSONA_OR_PLAYER_ALREADY_LINKED`	Mevcut bağlantılar yeni bağlantının oluşturulması halinde belirtilen `RecallTokensCardinalityConstraint` ihlalini ihlal etmesine neden olacağından istekte belirtilen bağlantı oluşturulmadı.