หน้านี้ได้รับการแปลโดย Cloud Translation API

Method: recall.linkPersona

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

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

คำขอ HTTP

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

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

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

การแสดง JSON

การแสดง 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,
  "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)` เอาต์พุตเท่านั้น สถานะของความพยายามในการลิงก์ลักษณะตัวตน

state

enum (State)

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

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

https://www.googleapis.com/auth/androidpublisher

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0

RecallTokensCardinalityConstraint

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

Enum

Enum
`ONE_PERSONA_TO_ONE_PLAYER`	Cardinality แบบ 1:1 ระหว่างลักษณะตัวตนในเกมกับผู้เล่นในบริการเกมของ Play ในช่วงท้ายของการดำเนินการลิงก์ จะมีเพียงรายการเดียวสำหรับโปรแกรมเล่นและลักษณะตัวตนควรอยู่ในขอบเขตของแอปพลิเคชัน `ConflictingLinksResolutionPolicy` ที่เลือกไว้จะเป็นตัวกำหนดว่าจะสร้างลิงก์ใหม่หรือไม่เมื่อระบุข้อจำกัดนี้ หากระบุ `KEEP_EXISTING_LINKS` และลักษณะตัวตนที่ระบุลิงก์กับผู้เล่นอื่นแล้ว หรือผู้เล่นดังกล่าวลิงก์กับตัวละครอื่นอยู่แล้ว ระบบจะไม่สร้างลิงก์ใหม่ และลิงก์ที่มีอยู่แล้วจะยังคงเดิมตามเดิม หากระบุ `CREATE_NEW_LINK` และลักษณะตัวตนที่ระบุลิงก์กับผู้เล่นอื่นแล้ว หรือผู้เล่นดังกล่าวลิงก์กับลักษณะตัวตนอื่นแล้ว ระบบจะนำลิงก์เก่าออกเพื่อเปลี่ยนไปใช้ลิงก์ใหม่ที่สร้าง

ONE_PERSONA_TO_ONE_PLAYER

Cardinality แบบ 1:1 ระหว่างลักษณะตัวตนในเกมกับผู้เล่นในบริการเกมของ Play

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

ConflictingLinksResolutionPolicy ที่เลือกไว้จะเป็นตัวกำหนดว่าจะสร้างลิงก์ใหม่หรือไม่เมื่อระบุข้อจำกัดนี้

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

ConflictingLinksResolutionPolicy

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

Enum

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 ระบบจะนำลิงก์เก่าออกและเพิ่มลิงก์ใหม่จะแทนที่ลิงก์ดังกล่าว

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` ที่ระบุ หากสร้างไว้