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 utama Pemain PGS 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 memuat 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 tidak transparan yang dibuat oleh server yang mengenkode semua informasi yang diperlukan untuk mengidentifikasi pemutar PGS / pengguna Google dan aplikasi.
`persona`	`string` Wajib. ID stabil akun dalam game. Hindari menggunakan kembali persona yang sama untuk game yang berbeda.
`token`	`string` Wajib. Nilai token yang akan dibuat. Buram ke Play Game dan dianggap tidak stabil (dienkripsi dengan rotasi kunci).
`cardinalityConstraint`	`enum (RecallTokensCardinalityConstraint)` Wajib. Batasan kardinalitas yang harus diamati saat menghubungkan persona dengan pemain dalam cakupan game.
`conflictingLinksResolutionPolicy`	`enum (ConflictingLinksResolutionPolicy)` Wajib. Kebijakan resolusi yang diterapkan ketika penautan persona ke pemain akan mengakibatkan pelanggaran batasan kardinalitas yang ditentukan.
Kolom union `expiration`. Waktu habis masa berlaku atau masa aktif token opsional. `expiration` hanya ada berupa salah satu diantara 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 opsional. Durasi dalam detik dengan paling banyak sembilan digit pecahan, yang diakhiri dengan '`s`'. Contoh: `"3.5s"`.

Isi respons

Hasil dari upaya penautan persona.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

Kolom

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

state

enum (State)

Hanya output. Upaya penautan persona.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.

RecallTokensCardinalityConstraint

Batasan kardinalitas yang harus diamati saat menghubungkan persona dengan 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 tersebut harus tetap berada dalam cakupan aplikasi. Apakah link baru akan dibuat atau tidak saat batasan ini ditentukan 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 sebagaimana adanya. Jika `CREATE_NEW_LINK` ditentukan dan persona yang diberikan sudah ditautkan ke pemain lain, atau pemain tersebut sudah ditautkan ke persona lain, link yang lebih lama akan dihapus dan diganti dengan link 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 tersebut harus tetap berada dalam cakupan aplikasi.

Apakah link baru akan dibuat atau tidak saat batasan ini ditentukan 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 sebagaimana adanya.
Jika CREATE_NEW_LINK ditentukan dan persona yang diberikan sudah ditautkan ke pemain lain, atau pemain tersebut sudah ditautkan ke persona lain, link yang lebih lama akan dihapus dan diganti dengan link baru yang dibuat.

ConflictingLinksResolutionPolicy

Kebijakan resolusi yang diterapkan ketika 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 terhadap `RecallTokensCardinalityConstraint` yang ditentukan jika link baru dibuat, pertahankan link yang sudah ada. Misalnya, jika Persona1-Player1 sudah ditautkan dalam cakupan application1 dan tautan baru Persona1-Player2 berusaha dibuat dalam cakupan application1 dengan batasan `MANY_PERSONAS_TO_ONE_PLAYER`, maka tautan lama akan tetap ada dan tidak ada tautan baru yang akan ditambahkan. Perlu diketahui 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 tidak akan menyelesaikan pelanggaran ini. Untuk mengatasi konflik, kebijakan {@link `CREATE_NEW_LINK` harus digunakan untuk menulis ulang link yang menyelesaikan konflik.
`CREATE_NEW_LINK`	Jika link yang ada antara pemutar dan persona sudah ada yang akan mengakibatkan pelanggaran terhadap `RecallTokensCardinalityConstraint` yang ditentukan jika link baru dibuat, ganti link yang sudah ada dengan link baru. Misalnya, jika Persona1-Player1 sudah ditautkan dalam cakupan application1 dan tautan baru Persona1-Player2 berusaha dibuat dalam cakupan application1 dengan batasan `MANY_PERSONAS_TO_ONE_PLAYER`, maka tautan lama akan dihapus dan tautan baru akan ditambahkan untuk menggantikannya.

KEEP_EXISTING_LINKS

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

Misalnya, jika Persona1-Player1 sudah ditautkan dalam cakupan application1 dan tautan baru Persona1-Player2 berusaha dibuat dalam cakupan application1 dengan batasan MANY_PERSONAS_TO_ONE_PLAYER, maka tautan lama akan tetap ada dan tidak ada tautan baru yang akan ditambahkan.

Perlu diketahui 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 tidak akan menyelesaikan pelanggaran ini. Untuk mengatasi konflik, kebijakan {@link CREATE_NEW_LINK harus digunakan untuk menulis ulang link yang menyelesaikan konflik.

CREATE_NEW_LINK

Jika link yang ada antara pemutar dan persona sudah ada yang akan mengakibatkan pelanggaran terhadap RecallTokensCardinalityConstraint yang ditentukan jika link baru dibuat, ganti link yang sudah ada dengan link baru.

Misalnya, jika Persona1-Player1 sudah ditautkan dalam cakupan application1 dan tautan baru Persona1-Player2 berusaha dibuat dalam cakupan application1 dengan batasan MANY_PERSONAS_TO_ONE_PLAYER, maka tautan lama akan dihapus dan tautan baru akan ditambahkan untuk menggantikannya.

Negara Bagian

Upaya penautan persona.

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