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

Method: recall.linkPersona

HTTP isteği
İstek gövdesi
- JSON gösterimi
Yanıt metni
- JSON gösterimi
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

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 sabit tanımlayıcısı. Lütfen farklı oyunlarda aynı karakteri tekrar kullanmaktan kaçının.
`token`	`string` Zorunlu. Oluşturulacak jetonun değeri. Play Games'de opaktır ve kararsız olduğu varsayılır (anahtar rotasyonu ile şifrelenir).
`cardinalityConstraint`	`enum (RecallTokensCardinalityConstraint)` Zorunlu. Bir oyun kapsamındaki bir karakter ile oyuncu arasında bağlantı oluştururken gözlemlenecek kardinalite kısıtlaması.
`conflictingLinksResolutionPolicy`	`enum (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ı 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ı son kullanma tarihi. RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Ö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ğı olan ve "`s`" ile biten, saniye cinsinden 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ğlantı denemesinin durumu.

state

enum (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

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` tarafından belirlenir: `KEEP_EXISTING_LINKS` belirtilmişse ve sağlanan karakter zaten farklı bir oyuncuya bağlıysa veya oyuncu zaten farklı bir karaktere bağlıysa yeni bir bağlantı oluşturulmaz ve mevcut bağlantılar olduğu gibi kalır. `CREATE_NEW_LINK` belirtilmişse ve sağlanan karakter zaten farklı bir oyuncuyla bağlantılıysa ya da oyuncu zaten başka bir karaktere bağlıysa yeni bağlantının oluşturulması için eski bağlantılar kaldırılır.

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 tarafından belirlenir:

KEEP_EXISTING_LINKS belirtilmişse ve sağlanan karakter zaten farklı bir oyuncuya bağlıysa veya oyuncu zaten farklı bir karaktere bağlıysa yeni bir bağlantı oluşturulmaz ve mevcut bağlantılar olduğu gibi kalır.
CREATE_NEW_LINK belirtilmişse ve sağlanan karakter zaten farklı bir oyuncuyla bağlantılıysa ya da oyuncu zaten başka bir karaktere bağlıysa yeni bağlantının oluşturulması için eski bağlantılar kaldırılır.

ConflictingLinksResolutionPolicy

Bir karakterin bir oyuncuya bağlanması, belirtilen kardinalite kısıtlamasının ihlal edilmesine neden olacaksa uygulanacak çözüm politikası.

Sıralamalar

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 `RecallTokensCardinalityConstraint` politikasının ihlal edilmesine neden olacaksa mevcut bağlantıları değiştirmeyin. Ö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 `recall.linkPersona` çağrılarının aynı `RecallTokensCardinalityConstraint` kullanmadığı durumlarda gerçekleşebilir) bu politikanın, söz konusu ihlallerin çözümlenmemesini sağlayacağını unutmayın; uyuşmazlıkları çözmek için {@link `CREATE_NEW_LINK` politikasının, çakışmaları çözümleyen bağlantıları yeniden yazmak amacıyla kullanılması gerekir.
`CREATE_NEW_LINK`	Bir oyuncu ile karakter arasında zaten mevcut bir bağlantı varsa ve yeni bağlantı oluşturulduğunda belirtilen `RecallTokensCardinalityConstraint` ihlaline neden olacaksa mevcut bağlantıları yeni bağlantıyla değiştirin. Ö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.

KEEP_EXISTING_LINKS

Bir oyuncu ile karakter arasında halihazırda bağlantılar varsa ve yeni bağlantı oluşturulduğunda belirtilen RecallTokensCardinalityConstraint politikasının ihlal edilmesine neden olacaksa mevcut bağlantıları değiştirmeyin.

Ö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 recall.linkPersona çağrılarının aynı RecallTokensCardinalityConstraint kullanmadığı durumlarda gerçekleşebilir) bu politikanın, söz konusu ihlallerin çözümlenmemesini sağlayacağını unutmayın; uyuşmazlıkları çözmek için {@link CREATE_NEW_LINK politikasının, çakışmaları çözümleyen bağlantıları yeniden yazmak amacıyla kullanılması gerekir.

CREATE_NEW_LINK

Bir oyuncu ile karakter arasında zaten mevcut bir bağlantı varsa ve yeni bağlantı oluşturulduğunda belirtilen RecallTokensCardinalityConstraint ihlaline neden olacaksa mevcut bağlantıları yeni bağlantıyla değiştirin.

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ı.