Halaman ini diterjemahkan oleh Cloud Translation API.

Method: recall.linkPersona

Permintaan HTTP
Isi permintaan
- Representasi JSON
Isi respons
- Representasi JSON
Cakupan otorisasi
RecallTokensCardinalityConstraint
ConflictingLinksResolutionPolicy
Status
Cobalah!

Mengaitkan akun utama PGS Player yang dienkode dalam ID sesi recall yang diberikan dengan akun dalam game

Permintaan HTTP

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

Isi permintaan

Isi permintaan berisi data dengan struktur berikut:

Representasi JSON

Representasi JSON
{ "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.
}

Kolom
`sessionId`	`string` Wajib. String buram yang dibuat server yang mengenkode semua informasi yang diperlukan untuk mengidentifikasi pemain PGS / pengguna dan aplikasi Google.
`persona`	`string` Wajib. ID stabil akun dalam game. Jangan gunakan kembali persona yang sama untuk game yang berbeda.
`token`	`string` Wajib. Nilai token yang akan dibuat. Buram untuk Play Game dan diasumsikan tidak stabil (dienkripsi dengan rotasi kunci).
`cardinalityConstraint`	`enum (RecallTokensCardinalityConstraint)` Wajib. Batasan kardinalitas yang harus diamati saat menautkan persona ke pemain dalam cakupan game.
`conflictingLinksResolutionPolicy`	`enum (ConflictingLinksResolutionPolicy)` Wajib. Kebijakan penyelesaian yang akan diterapkan jika penautan persona ke pemain akan mengakibatkan pelanggaran batasan kardinalitas yang ditentukan.
Kolom union `expiration`. Waktu habis masa berlaku token atau waktu aktif token opsional. `expiration` hanya dapat berupa salah satu dari hal berikut:
`expireTime`	`string (Timestamp format)` Hanya input. Waktu habis masa berlaku opsional. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: `"2014-10-02T15:01:23Z"` dan `"2014-10-02T15:01:23.045123456Z"`.
`ttl`	`string (Duration format)` Hanya input. Time to live (TTL) opsional. Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan '`s`'. Contoh: `"3.5s"`.

Isi respons

Hasil upaya penautan persona.

Jika berhasil, isi respons berisi data dengan struktur berikut:

Representasi JSON
{ "state": enum (`State`) }

Kolom

Kolom
`state`	`enum (State)` Hanya output. Status upaya penautan persona.

state

enum (State)

Hanya output. Status upaya penautan persona.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

RecallTokensCardinalityConstraint

Batasan kardinalitas yang harus diamati saat menautkan persona ke pemain dalam cakupan game.

Enum

Enum
`ONE_PERSONA_TO_ONE_PLAYER`	Kardinalitas 1:1 antara persona dalam game dan pemain Layanan game Play. Pada akhir operasi penautan, hanya satu entri untuk pemain dan persona yang boleh tetap berada dalam cakupan aplikasi. Apakah link baru dibuat atau tidak saat batasan ini ditentukan akan ditentukan oleh `ConflictingLinksResolutionPolicy` yang dipilih: Jika `KEEP_EXISTING_LINKS` ditentukan dan persona yang diberikan sudah ditautkan ke pemain lain, atau pemain sudah ditautkan ke persona lain, tidak ada link baru yang akan dibuat dan link yang sudah ada akan tetap seperti semula. Jika `CREATE_NEW_LINK` ditentukan dan persona yang diberikan sudah ditautkan ke pemain lain, atau pemain sudah ditautkan ke persona lain, penautan lama akan dihapus dan diganti dengan penautan baru yang dibuat.

ONE_PERSONA_TO_ONE_PLAYER

Kardinalitas 1:1 antara persona dalam game dan pemain Layanan game Play.

Pada akhir operasi penautan, hanya satu entri untuk pemain dan persona yang boleh tetap berada dalam cakupan aplikasi.

Apakah link baru dibuat atau tidak saat batasan ini ditentukan akan ditentukan oleh ConflictingLinksResolutionPolicy yang dipilih:

Jika KEEP_EXISTING_LINKS ditentukan dan persona yang diberikan sudah ditautkan ke pemain lain, atau pemain sudah ditautkan ke persona lain, tidak ada link baru yang akan dibuat dan link yang sudah ada akan tetap seperti semula.
Jika CREATE_NEW_LINK ditentukan dan persona yang diberikan sudah ditautkan ke pemain lain, atau pemain sudah ditautkan ke persona lain, penautan lama akan dihapus dan diganti dengan penautan baru yang dibuat.

ConflictingLinksResolutionPolicy

Kebijakan penyelesaian yang akan diterapkan jika penautan persona ke pemain akan mengakibatkan pelanggaran batasan kardinalitas yang ditentukan.

Enum

Enum
`KEEP_EXISTING_LINKS`	Jika link antara pemain dan persona sudah ada yang akan mengakibatkan pelanggaran `RecallTokensCardinalityConstraint` yang ditentukan jika link baru dibuat, pertahankan link yang sudah ada. Misalnya, jika Persona1-Pemain1 sudah ditautkan dalam cakupan aplikasi1 dan penautan baru Persona1-Pemain2 dicoba dibuat dalam cakupan aplikasi1, penautan lama akan tetap ada dan tidak ada penautan baru yang akan ditambahkan. Perhatikan bahwa jika link yang sudah ada melanggar kebijakan yang ditentukan (yang dapat terjadi jika tidak semua panggilan `recall.linkPersona` menggunakan `RecallTokensCardinalityConstraint` yang sama), kebijakan ini akan membiarkan pelanggaran ini tidak terselesaikan; untuk menyelesaikan konflik, kebijakan {@link `CREATE_NEW_LINK` harus digunakan untuk menulis ulang link yang menyelesaikan konflik.
`CREATE_NEW_LINK`	Jika ada penautan antara pemain dan persona yang sudah ada yang akan mengakibatkan pelanggaran `RecallTokensCardinalityConstraint` yang ditentukan jika penautan baru dibuat, ganti penautan yang sudah ada dengan penautan baru. Misalnya, jika Persona1-Pemain1 sudah ditautkan dalam cakupan aplikasi1 dan link baru Persona1-Pemain2 dicoba dibuat dalam cakupan aplikasi1, link lama akan dihapus dan link baru akan ditambahkan untuk menggantikannya.

KEEP_EXISTING_LINKS

Jika link antara pemain dan persona sudah ada yang akan mengakibatkan pelanggaran RecallTokensCardinalityConstraint yang ditentukan jika link baru dibuat, pertahankan link yang sudah ada.

Misalnya, jika Persona1-Pemain1 sudah ditautkan dalam cakupan aplikasi1 dan penautan baru Persona1-Pemain2 dicoba dibuat dalam cakupan aplikasi1, penautan lama akan tetap ada dan tidak ada penautan baru yang akan ditambahkan.

Perhatikan bahwa jika link yang sudah ada melanggar kebijakan yang ditentukan (yang dapat terjadi jika tidak semua panggilan recall.linkPersona menggunakan RecallTokensCardinalityConstraint yang sama), kebijakan ini akan membiarkan pelanggaran ini tidak terselesaikan; untuk menyelesaikan konflik, kebijakan {@link CREATE_NEW_LINK harus digunakan untuk menulis ulang link yang menyelesaikan konflik.

CREATE_NEW_LINK

Jika ada penautan antara pemain dan persona yang sudah ada yang akan mengakibatkan pelanggaran RecallTokensCardinalityConstraint yang ditentukan jika penautan baru dibuat, ganti penautan yang sudah ada dengan penautan baru.

Misalnya, jika Persona1-Pemain1 sudah ditautkan dalam cakupan aplikasi1 dan link baru Persona1-Pemain2 dicoba dibuat dalam cakupan aplikasi1, link lama akan dihapus dan link baru akan ditambahkan untuk menggantikannya.

Status

Status upaya penautan persona.

Enum
`LINK_CREATED`	Link yang ditentukan dalam permintaan telah dibuat.
`PERSONA_OR_PLAYER_ALREADY_LINKED`	Penautan yang ditentukan dalam permintaan tidak dibuat karena penautan yang sudah ada akan menyebabkan penautan baru melanggar `RecallTokensCardinalityConstraint` yang ditentukan jika dibuat.