- คำขอ HTTP
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- RecallTokensCardinalityConstraint
- ConflictingLinksResolutionPolicy
- สถานะ
- ลองใช้งาน
เชื่อมโยงผู้ใช้หลักของผู้เล่น PGS ที่เข้ารหัสในรหัสเซสชันการเรียกคืนที่ระบุกับบัญชีในเกม
คำขอ HTTP
POST https://games.googleapis.com/games/v1/recall:linkPersona
เนื้อหาของคำขอ
เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้
การแสดง JSON |
---|
{ "sessionId": string, "persona": string, "token": string, "cardinalityConstraint": enum ( |
ช่อง | |
---|---|
sessionId |
ต้องระบุ สตริงแบบทึบแสงที่สร้างโดยเซิร์ฟเวอร์ซึ่งเข้ารหัสข้อมูลที่จำเป็นทั้งหมดในการระบุโปรแกรมเล่น PGS / ผู้ใช้และแอปพลิเคชันของ Google |
persona |
ต้องระบุ ตัวระบุที่เสถียรของบัญชีในเกม โปรดงดใช้ลักษณะตัวตนเดิมๆ ของหลายๆ เกม |
token |
ต้องระบุ ค่าของโทเค็นที่จะสร้าง ไม่ชัดเจน Play Games และถือว่าไม่เสถียร (เข้ารหัสด้วยการหมุนเวียนคีย์) |
cardinalityConstraint |
ต้องระบุ ข้อจำกัดของ Cardinality ที่จะสังเกตเมื่อลิงก์ลักษณะตัวตนกับผู้เล่นในขอบเขตของเกม |
conflictingLinksResolutionPolicy |
ต้องระบุ นโยบายการแก้ปัญหาที่จะใช้เมื่อการลิงก์ลักษณะตัวตนกับผู้เล่นจะส่งผลให้เกิดการละเมิดข้อจำกัดของ Cardinality ที่ระบุ |
ฟิลด์การรวม expiration เวลาหมดอายุของโทเค็นที่ไม่บังคับหรือ Time to Live expiration ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น |
|
expireTime |
อินพุตเท่านั้น เวลาหมดอายุที่ไม่บังคับ การประทับเวลาจะอยู่ในรูปแบบ RFC3339 UTC "Zulu" ที่มีความละเอียดระดับนาโนวินาทีและมีตัวเลขเศษส่วนได้สูงสุด 9 หลัก ตัวอย่าง: |
ttl |
อินพุตเท่านั้น Time to Live ที่ไม่บังคับ ระยะเวลาเป็นวินาทีโดยมีตัวเลขเศษส่วนไม่เกิน 9 หลัก ซึ่งลงท้ายด้วย " |
เนื้อหาการตอบกลับ
ผลลัพธ์ของการพยายามลิงก์ลักษณะตัวตน
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"state": enum ( |
ช่อง | |
---|---|
state |
เอาต์พุตเท่านั้น สถานะของความพยายามในการลิงก์ลักษณะตัวตน |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/androidpublisher
ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0
RecallTokensCardinalityConstraint
ข้อจำกัดของ Cardinality ที่จะสังเกตเมื่อลิงก์ลักษณะตัวตนกับผู้เล่นในขอบเขตของเกม
Enum | |
---|---|
ONE_PERSONA_TO_ONE_PLAYER |
Cardinality แบบ 1:1 ระหว่างลักษณะตัวตนในเกมกับผู้เล่นบริการเกมของ Play ในช่วงท้ายของการดำเนินการลิงก์ มีเพียงรายการเดียวเท่านั้นสำหรับโปรแกรมเล่นและลักษณะตัวตนควรจะยังคงอยู่ในขอบเขตของแอปพลิเคชัน มีการสร้างลิงก์ใหม่หรือไม่เมื่อระบุข้อจำกัดนี้ตาม
|
ConflictingLinksResolutionPolicy
นโยบายการแก้ปัญหาที่จะใช้เมื่อการลิงก์ลักษณะตัวตนกับผู้เล่นจะส่งผลให้เกิดการละเมิดข้อจำกัดของ Cardinality ที่ระบุ
Enum | |
---|---|
KEEP_EXISTING_LINKS |
หากมีลิงก์ระหว่างผู้เล่นและลักษณะตัวตนอยู่แล้ว ซึ่งจะส่งผลให้มีการละเมิด ตัวอย่างเช่น หากลิงก์ Persona1-Player1 อยู่ในขอบเขตของ application1 แล้ว และมีการพยายามสร้างลิงก์ใหม่ Persona1-Player2 ในขอบเขตของ application1 ที่มีข้อจํากัด โปรดทราบว่าหากลิงก์ที่มีอยู่แล้วละเมิดนโยบายที่ระบุ (ซึ่งอาจเกิดขึ้นหากการเรียกใช้ |
CREATE_NEW_LINK |
หากมีลิงก์ระหว่างโปรแกรมเล่นและลักษณะตัวตนอยู่แล้ว ซึ่งจะส่งผลให้เกิดการละเมิด ตัวอย่างเช่น หากลิงก์ Persona1-Player1 อยู่ในขอบเขตของ application1 แล้ว และมีการพยายามสร้างลิงก์ Persona1-Player2 ใหม่ในขอบเขตของ application1 ที่มีข้อจำกัด |
รัฐ
สถานะของความพยายามในการลิงก์ลักษณะตัวตน
Enum | |
---|---|
LINK_CREATED |
สร้างลิงก์ที่ระบุในคำขอแล้ว |
PERSONA_OR_PLAYER_ALREADY_LINKED |
ไม่ได้สร้างลิงก์ที่ระบุในคำขอ เนื่องจากลิงก์ที่มีอยู่แล้วจะทำให้ลิงก์ใหม่ละเมิด RecallTokensCardinalityConstraint ที่ระบุหากสร้างขึ้น |