Method: recall.linkPersona

เชื่อมโยงผู้ใช้หลักของโปรแกรมเล่น PGS ที่เข้ารหัสในรหัสเซสชันการเรียกคืนที่ระบุกับบัญชีในเกม

คำขอ HTTP

POST https://games.googleapis.com/games/v1/recall:linkPersona

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง 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

ต้องระบุ สตริงที่เซิร์ฟเวอร์แบบทึบที่สร้างขึ้นซึ่งเข้ารหัสข้อมูลที่จำเป็นทั้งหมดเพื่อระบุโปรแกรมเล่น PGS / ผู้ใช้และแอปพลิเคชันของ Google

persona

string

ต้องระบุ ตัวระบุแบบคงที่ของบัญชีในเกม โปรดอย่าใช้ลักษณะตัวตนเดิมซ้ำสำหรับแต่ละเกม

token

string

ต้องระบุ ค่าของโทเค็นที่จะสร้าง ไม่ชัดเจนสำหรับ Play Games และถือว่าไม่เสถียร (เข้ารหัสด้วยการหมุนเวียนคีย์)

cardinalityConstraint

enum (RecallTokensCardinalityConstraint)

ต้องระบุ ข้อจำกัด Cardinality ที่ต้องสังเกตเมื่อลิงก์ลักษณะตัวตนกับผู้เล่นที่อยู่ในขอบเขตของเกม

ช่องการรวม expiration (ไม่บังคับ) เวลาหมดอายุของโทเค็นหรือ Time to Live expiration ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้
expireTime

string (Timestamp format)

อินพุตเท่านั้น เวลาหมดอายุที่ไม่บังคับ

การประทับเวลาเป็น RFC3339 UTC "Zulu" โดยมีความละเอียดระดับนาโนวินาทีและมีเลขเศษส่วนสูงสุด 9 หลัก ตัวอย่าง: "2014-10-02T15:01:23Z" และ "2014-10-02T15:01:23.045123456Z"

ttl

string (Duration format)

อินพุตเท่านั้น Time to Live ที่ไม่บังคับ

ระยะเวลาเป็นวินาทีโดยมีเลขเศษส่วนไม่เกิน 9 หลัก ลงท้ายด้วย "s" ตัวอย่างเช่น "3.5s"

เนื้อหาการตอบกลับ

ผลลัพธ์ของการพยายามลิงก์ลักษณะตัวตน

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

การแสดง JSON
{
  "state": enum (State)
}
ช่อง
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 ที่เลือกไว้จะเป็นตัวกำหนดว่าจะสร้างลิงก์ใหม่หรือไม่เมื่อระบุข้อจำกัดนี้

  • หากระบุ KEEP_EXISTING_LINKS และลักษณะตัวตนที่ระบุลิงก์กับผู้เล่นอื่นแล้ว หรือผู้เล่นดังกล่าวลิงก์กับตัวละครอื่นอยู่แล้ว ระบบจะไม่สร้างลิงก์ใหม่ และลิงก์ที่มีอยู่แล้วจะยังคงเดิมตามเดิม

  • หากระบุ CREATE_NEW_LINK และลักษณะตัวตนที่ระบุลิงก์กับผู้เล่นอื่นแล้ว หรือผู้เล่นดังกล่าวลิงก์กับลักษณะตัวตนอื่นแล้ว ระบบจะนำลิงก์เก่าออกเพื่อเปลี่ยนไปใช้ลิงก์ใหม่ที่สร้าง

ConflictingLinksResolutionPolicy

นโยบายการแก้ปัญหาที่จะมีผลเมื่อการลิงก์ลักษณะตัวตนกับผู้เล่นจะส่งผลให้เกิดการละเมิดข้อจํากัดของ Cardinality ที่ระบุไว้

Enum

รัฐ

สถานะของความพยายามในการลิงก์ลักษณะตัวตน

Enum
PERSONA_OR_PLAYER_ALREADY_LINKED ไม่ได้สร้างลิงก์ที่ระบุไว้ในคำขอ เนื่องจากลิงก์ที่มีอยู่แล้วจะส่งผลให้ลิงก์ใหม่ละเมิด RecallTokensCardinalityConstraint ที่ระบุ หากสร้างไว้