Method: recall.linkPersona

• คำขอ HTTP
• เนื้อหาคำขอ
  • การแสดง JSON
• เนื้อหาการตอบกลับ
  • การแสดง JSON
• ขอบเขตการให้สิทธิ์
• RecallTokensCardinalityConstraint
• ConflictingLinksResolutionPolicy
• สถานะ
• ลองใช้งาน

เชื่อมโยงผู้ใช้หลักของโปรแกรมเล่น 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 ที่ต้องสังเกตเมื่อลิงก์ลักษณะตัวตนกับผู้เล่นที่อยู่ในขอบเขตของเกม
conflictingLinksResolutionPolicy	enum (ConflictingLinksResolutionPolicy) ต้องระบุ นโยบายการแก้ปัญหาที่จะมีผลเมื่อการลิงก์ลักษณะตัวตนกับผู้เล่นจะส่งผลให้เกิดการละเมิดข้อจํากัดของ 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
KEEP_EXISTING_LINKS	หากมีลิงก์ระหว่างโปรแกรมเล่นและลักษณะตัวตนอยู่แล้ว ซึ่งจะส่งผลให้เกิดการละเมิด RecallTokensCardinalityConstraint ที่ระบุหากมีการสร้างลิงก์ใหม่ ให้เก็บลิงก์ที่มีอยู่แล้วไว้ ตัวอย่างเช่น หากลิงก์ Persona1-Player1 ไว้ในขอบเขตของ application1 แล้ว และมีการสร้างลิงก์ Persona1-Player2 ใหม่ในขอบเขตของ application1 ลิงก์เดิมจะยังคงอยู่และจะไม่มีการเพิ่มลิงก์ใหม่ โปรดทราบว่าหากลิงก์ที่มีอยู่แล้วละเมิดนโยบายที่ระบุ (ซึ่งอาจเกิดขึ้นได้หากการเรียก recall.linkPersona ทุกสายใช้ RecallTokensCardinalityConstraint เหมือนกัน) นโยบายนี้จะไม่แก้ไขการละเมิดเหล่านี้ ในการแก้ไขข้อขัดแย้ง นโยบาย {@link CREATE_NEW_LINK จำเป็นต้องใช้นโยบาย {@link CREATE_NEW_LINK เพื่อแก้ไขข้อขัดแย้ง"
CREATE_NEW_LINK	หากมีลิงก์ที่มีอยู่ระหว่างโปรแกรมเล่นและลักษณะตัวตนอยู่แล้ว ซึ่งจะส่งผลให้เกิดการละเมิด RecallTokensCardinalityConstraint ที่ระบุหากมีการสร้างลิงก์ใหม่ ให้แทนที่ลิงก์ที่มีอยู่แล้วด้วยลิงก์ใหม่ ตัวอย่างเช่น หากลิงก์ Persona1-Player1 อยู่ในขอบเขตของ application1 แล้ว และมีการสร้างลิงก์ Persona1-Player2 ใหม่ในขอบเขตของ application1 ระบบจะนำลิงก์เก่าออกและเพิ่มลิงก์ใหม่จะแทนที่ลิงก์ดังกล่าว

รัฐ

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

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