- Permintaan HTTP
- Isi Permintaan
- Isi respons
- 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 |
---|
{ "sessionId": string, "persona": string, "token": string, "cardinalityConstraint": enum ( |
Kolom | |
---|---|
sessionId |
Wajib. String buram yang dihasilkan server yang mengenkode semua informasi yang diperlukan untuk mengidentifikasi pemutar PGS / pengguna dan aplikasi Google. |
persona |
Wajib. ID stabil akun dalam game. Harap tidak menggunakan kembali persona yang sama untuk game yang berbeda. |
token |
Wajib. Nilai token yang akan dibuat. Tidak transparan terhadap Play Game dan diasumsikan 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 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 |
Input saja. Waktu habis masa berlaku opsional. Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
ttl |
Input saja. Time to live opsional. Durasi dalam detik dengan maksimal 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. 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 | |
---|---|
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
Kebijakan resolusi yang akan diterapkan saat menghubungkan 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 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 |
CREATE_NEW_LINK |
Jika sudah ada link antara pemain dan persona, yang akan mengakibatkan pelanggaran Misalnya, jika Persona1-Player1 sudah ditautkan dalam lingkup application1 dan tautan baru Persona1-Player2 coba 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. |