TurnBasedMatches: finish

Selesaikan pencocokan berbasis giliran. Setiap pemain harus melakukan panggilan ini satu kali, setelah semua hasil masuk. Hanya pemain yang gilirannya dapat melakukan panggilan pertama ke Finish, dan dapat meneruskan status kecocokan terakhir. Coba sekarang.

Permintaan

Permintaan HTTP

PUT https://www.googleapis.com/games/v1/turnbasedmatches/matchId/finish

Parameter

Nama parameter Nilai Deskripsi
Parameter jalur
matchId string ID kecocokan.
Parameter kueri opsional
language string Bahasa pilihan untuk digunakan dalam string yang ditampilkan oleh metode ini.

Otorisasi

Permintaan ini memerlukan otorisasi dengan cakupan berikut:

Cakupan
https://www.googleapis.com/auth/games

Untuk informasi selengkapnya, lihat halaman autentikasi dan otorisasi.

Isi permintaan

Dalam isi permintaan, berikan data dengan struktur berikut:

{
  "kind": "games#turnBasedMatchResults",
  "results": [
    {
      "kind": "games#participantResult",
      "participantId": string,
      "result": string,
      "placing": integer
    }
  ],
  "data": {
    "kind": "games#turnBasedMatchDataRequest",
    "data": bytes
  },
  "matchVersion": integer
}
Nama properti Nilai Deskripsi Catatan
kind string Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#turnBasedMatchResults.
results[] list Hasil pertandingan untuk peserta dalam pertandingan tersebut.
results[].kind string Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#participantResult.
results[].participantId string ID peserta.
results[].result string Hasil peserta untuk pertandingan ini.
Nilai yang memungkinkan adalah:
  • "MATCH_RESULT_WIN" - Peserta memenangkan pertandingan.
  • "MATCH_RESULT_LOSS" - Peserta kalah dalam pertandingan.
  • "MATCH_RESULT_TIE" - Peserta mengikat pertandingan.
  • "MATCH_RESULT_NONE" - Tidak ada pemenang untuk pertandingan ini (tidak ada yang menang atau kalah dalam game ini.)
  • "MATCH_RESULT_DISCONNECT" - Peserta terputus / keluar selama pertandingan.
  • "MATCH_RESULT_DISAGREED" - Klien yang berbeda melaporkan hasil yang berbeda untuk peserta ini.


Nilai yang dapat diterima adalah:
  • "MATCH_RESULT_DISAGREED"
  • "MATCH_RESULT_DISCONNECT"
  • "MATCH_RESULT_LOSS"
  • "MATCH_RESULT_NONE"
  • "MATCH_RESULT_TIE"
  • "MATCH_RESULT_WIN"
results[].placing integer Penempatan atau peringkat peserta dalam hasil pertandingan; angka dari satu hingga jumlah peserta dalam pertandingan. Beberapa peserta mungkin memiliki nilai penempatan yang sama untuk jenis tertentu.
data nested object Data kecocokan terakhir.
data.kind string Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#turnBasedMatchDataRequest.
data.data bytes Representasi byte data (dibatasi hingga 128 kB), sebagai string berenkode Base64 dengan opsi encoding URL_SAFE.
matchVersion integer Versi kecocokan yang sedang diperbarui.

Tanggapan

Jika berhasil, metode ini menampilkan resource TurnBasedMatch dalam isi respons.

Cobalah!

Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data live dan lihat responsnya.