- Permintaan HTTP
- Isi permintaan
- Isi respons
- 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 |
---|
{ "sessionId": string, "persona": string, "token": string, "cardinalityConstraint": enum ( |
Kolom | |
---|---|
sessionId |
Wajib. String tidak transparan yang dibuat oleh server yang mengenkode semua informasi yang diperlukan untuk mengidentifikasi pemutar PGS / pengguna Google dan aplikasi. |
persona |
Wajib. ID stabil akun dalam game. Hindari menggunakan kembali persona yang sama untuk game yang berbeda. |
token |
Wajib. Nilai token yang akan dibuat. Buram ke Play Game dan dianggap tidak stabil (dienkripsi dengan rotasi kunci). |
cardinalityConstraint |
Wajib. Batasan kardinalitas yang harus diamati saat menghubungkan persona dengan pemain dalam cakupan game. |
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 |
Hanya input. Waktu habis masa berlaku opsional. Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
ttl |
Hanya input. Time to live opsional. Durasi dalam detik dengan paling banyak sembilan digit pecahan, yang diakhiri dengan ' |
Isi respons
Hasil dari upaya penautan persona.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"state": enum ( |
Kolom | |
---|---|
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 | |
---|---|
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
Kebijakan resolusi yang diterapkan ketika penautan persona ke pemain akan mengakibatkan pelanggaran batasan kardinalitas yang ditentukan.
Enum | |
---|---|
KEEP_EXISTING_LINKS |
Jika link antara pemain dan persona sudah ada yang akan mengakibatkan pelanggaran terhadap Misalnya, jika Persona1-Player1 sudah ditautkan dalam cakupan application1 dan tautan baru Persona1-Player2 berusaha dibuat dalam cakupan application1 dengan batasan Perlu diketahui bahwa jika link yang sudah ada melanggar kebijakan yang ditentukan (yang dapat terjadi jika tidak semua panggilan |
CREATE_NEW_LINK |
Jika link yang ada antara pemutar dan persona sudah ada yang akan mengakibatkan pelanggaran terhadap Misalnya, jika Persona1-Player1 sudah ditautkan dalam cakupan application1 dan tautan baru Persona1-Player2 berusaha dibuat dalam cakupan application1 dengan batasan |
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. |