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 penarikan kembali 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 buram yang dihasilkan server yang mengenkode semua informasi yang diperlukan untuk mengidentifikasi pemutar PGS / pengguna dan aplikasi Google.
`persona`	`string` Wajib. ID stabil akun dalam game. Harap tidak menggunakan kembali persona yang sama untuk game yang berbeda.
`token`	`string` Wajib. Nilai token yang akan dibuat. Tidak transparan terhadap Play Game dan diasumsikan 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 akan diterapkan saat menghubungkan persona ke pemain akan mengakibatkan pelanggaran batasan kardinalitas yang ditentukan.
Kolom union `expiration`. Waktu habis masa berlaku token opsional atau waktu aktif. `expiration` hanya dapat berupa salah satu dari berikut:
`expireTime`	`string (Timestamp format)` Input saja. Waktu habis masa berlaku opsional. Stempel waktu dalam 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)` Input saja. Time to live opsional. Durasi dalam detik dengan maksimal 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. 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 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 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 sama. Jika `CREATE_NEW_LINK` ditentukan dan persona yang diberikan sudah ditautkan ke pemain lain, atau pemain sudah ditautkan ke persona lain, link lama akan dihapus karena link baru 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 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 sama.
Jika CREATE_NEW_LINK ditentukan dan persona yang diberikan sudah ditautkan ke pemain lain, atau pemain sudah ditautkan ke persona lain, link lama akan dihapus karena link baru dibuat.

ConflictingLinksResolutionPolicy

Kebijakan resolusi yang akan diterapkan saat menghubungkan 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 saat link baru dibuat, pertahankan link yang sudah ada. Misalnya, jika Persona1-Player1 sudah ditautkan dalam lingkup application1 dan tautan baru Persona1-Player2 berusaha dibuat dalam lingkup application1, maka tautan lama akan tetap ada dan tidak ada tautan 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 tautan guna menyelesaikan konflik.
`CREATE_NEW_LINK`	Jika sudah ada link antara pemain dan persona, yang akan mengakibatkan pelanggaran `RecallTokensCardinalityConstraint` yang ditentukan saat link baru dibuat, ganti link yang sudah ada dengan link baru. Misalnya, jika Persona1-Player1 sudah ditautkan dalam lingkup application1 dan tautan baru Persona1-Player2 berusaha dibuat dalam lingkup application1, 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 RecallTokensCardinalityConstraint yang ditentukan saat link baru dibuat, pertahankan link yang sudah ada.

Misalnya, jika Persona1-Player1 sudah ditautkan dalam lingkup application1 dan tautan baru Persona1-Player2 berusaha dibuat dalam lingkup application1, maka tautan lama akan tetap ada dan tidak ada tautan 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 tautan guna menyelesaikan konflik.

CREATE_NEW_LINK

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

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

Negara Bagian

Status 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 mengakibatkan link baru melanggar `RecallTokensCardinalityConstraint` yang ditentukan jika dibuat.