דף זה תורגם על ידי 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` חובה. מחרוזת אטומה שנוצרה על ידי שרת, שמקודדת את כל המידע הנדרש לזיהוי המשתמש והיישום של Google Play Games / של Google.
`persona`	`string` חובה. המזהה היציב של החשבון במשחק. יש להימנע משימוש חוזר באותה פרסונה במשחקים שונים.
`token`	`string` חובה. ערך האסימון ליצירה. אטומים ל-Play Games ונחשבים לא יציבים (מוצפנים באמצעות רוטציית מפתחות).
`cardinalityConstraint`	`enum (RecallTokensCardinalityConstraint)` חובה. אילוץ של עוצמה (cardinality) שצריך לשים לב כשמקשרים פרסונה לשחקן במהלך משחק.
`conflictingLinksResolutionPolicy`	`enum (ConflictingLinksResolutionPolicy)` חובה. מדיניות פתרון שתחול כשקישור של פרסונה לשחקן יגרום להפרת האילוץ של העוצמה שצוינה.
שדה איחוד `expiration`. אופציונלי: זמן התפוגה או הזמן של האסימון הקיים. הערך של `expiration` יכול להיות רק אחת מהאפשרויות הבאות:
`expireTime`	`string (Timestamp format)` קלט בלבד. זמן תפוגה אופציונלי. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: `"2014-10-02T15:01:23Z"` ו-`"2014-10-02T15:01:23.045123456Z"`.
`ttl`	`string (Duration format)` קלט בלבד. ערך אופציונלי של אורך חיים (TTL). משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, המסתיים ב-'`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) שצריך לשים לב כשמקשרים פרסונה לשחקן במהלך משחק.

טיפוסים בני מנייה (enums)

טיפוסים בני מנייה (enums)
`ONE_PERSONA_TO_ONE_PLAYER`	עוצמה (cardinality) ביחס של 1:1 בין פרסונות במשחק לבין שחקנים ב-Play Games Services. בסוף פעולת הקישור, רק רשומה אחת של הנגן והפרסונה צריכות להישאר בהיקף האפליקציה. האם קישור חדש נוצר או לא כשהאילוץ הזה נקבע על ידי ערך `ConflictingLinksResolutionPolicy` שנבחר: אם ציינת `KEEP_EXISTING_LINKS` והפרסונה שסיפקת כבר מקושרת לשחקן אחר, או שהשחקן כבר מקושר לפרסונה אחרת, לא ייווצר קישור חדש והקישורים שכבר קיימים יישארו כפי שהם. אם ציינת את `CREATE_NEW_LINK` והפרסונה שסיפקת כבר מקושרת לשחקן אחר או שהשחקן כבר מקושר לפרסונה אחרת, הקישורים הישנים יוסרו לטובת הקישור החדש שייווצר.

ONE_PERSONA_TO_ONE_PLAYER

עוצמה (cardinality) ביחס של 1:1 בין פרסונות במשחק לבין שחקנים ב-Play Games Services.

בסוף פעולת הקישור, רק רשומה אחת של הנגן והפרסונה צריכות להישאר בהיקף האפליקציה.

האם קישור חדש נוצר או לא כשהאילוץ הזה נקבע על ידי ערך ConflictingLinksResolutionPolicy שנבחר:

אם ציינת KEEP_EXISTING_LINKS והפרסונה שסיפקת כבר מקושרת לשחקן אחר, או שהשחקן כבר מקושר לפרסונה אחרת, לא ייווצר קישור חדש והקישורים שכבר קיימים יישארו כפי שהם.
אם ציינת את CREATE_NEW_LINK והפרסונה שסיפקת כבר מקושרת לשחקן אחר או שהשחקן כבר מקושר לפרסונה אחרת, הקישורים הישנים יוסרו לטובת הקישור החדש שייווצר.

ConflictingLinksResolutionPolicy

מדיניות פתרון שתחול כשקישור של פרסונה לשחקן יגרום להפרת האילוץ של העוצמה שצוינה.

טיפוסים בני מנייה (enums)

טיפוסים בני מנייה (enums)
`KEEP_EXISTING_LINKS`	אם כבר קיימים קישורים בין שחקן לפרסונה, שיובילו להפרה של `RecallTokensCardinalityConstraint` שצוין אם נוצר הקישור החדש, משאירים את הקישורים שכבר קיימים. לדוגמה, אם Persona1-Player1 כבר מקושר במסגרת app1 ותנסה ליצור קישור חדש Persona1-Player2 בהיקף של Application1 עם אילוץ של `MANY_PERSONAS_TO_ONE_PLAYER`, הקישור הישן יישאר ולא יתווסף קישור חדש. לתשומת ליבך, אם הקישורים שכבר קיימים אכן מפרים את המדיניות שצוינה (דבר זה עלול לקרות אם לא כל הקריאות ל-`recall.linkPersona` ישתמשו באותו `RecallTokensCardinalityConstraint`), המדיניות הזו תשאיר הפרות אלה ללא פתרון. כדי לפתור התנגשויות, יש להשתמש במדיניות {@link`CREATE_NEW_LINK` כדי לשכתב קישורים לפתרון התנגשויות.
`CREATE_NEW_LINK`	אם כבר קיים קישור בין שחקן לפרסונה, שיוביל להפרה של `RecallTokensCardinalityConstraint` שצוין אם נוצר הקישור החדש, צריך להחליף את הקישורים שכבר קיימים בקישור החדש. לדוגמה, אם Persona1-Player1 כבר מקושר בהיקף של application1, ומתבצע ניסיון ליצור קישור חדש Persona1-Player2 בהיקף של application1 עם אילוץ `MANY_PERSONAS_TO_ONE_PLAYER`, הקישור הישן יוסר וקישור חדש יתווסף כדי להחליף אותו.

KEEP_EXISTING_LINKS

אם כבר קיימים קישורים בין שחקן לפרסונה, שיובילו להפרה של RecallTokensCardinalityConstraint שצוין אם נוצר הקישור החדש, משאירים את הקישורים שכבר קיימים.

לדוגמה, אם Persona1-Player1 כבר מקושר במסגרת app1 ותנסה ליצור קישור חדש Persona1-Player2 בהיקף של Application1 עם אילוץ של MANY_PERSONAS_TO_ONE_PLAYER, הקישור הישן יישאר ולא יתווסף קישור חדש.

לתשומת ליבך, אם הקישורים שכבר קיימים אכן מפרים את המדיניות שצוינה (דבר זה עלול לקרות אם לא כל הקריאות ל-recall.linkPersona ישתמשו באותו RecallTokensCardinalityConstraint), המדיניות הזו תשאיר הפרות אלה ללא פתרון. כדי לפתור התנגשויות, יש להשתמש במדיניות {@linkCREATE_NEW_LINK כדי לשכתב קישורים לפתרון התנגשויות.

CREATE_NEW_LINK

אם כבר קיים קישור בין שחקן לפרסונה, שיוביל להפרה של RecallTokensCardinalityConstraint שצוין אם נוצר הקישור החדש, צריך להחליף את הקישורים שכבר קיימים בקישור החדש.

לדוגמה, אם Persona1-Player1 כבר מקושר בהיקף של application1, ומתבצע ניסיון ליצור קישור חדש Persona1-Player2 בהיקף של application1 עם אילוץ MANY_PERSONAS_TO_ONE_PLAYER, הקישור הישן יוסר וקישור חדש יתווסף כדי להחליף אותו.

ארץ

המצב של ניסיון הקישור לפרסונה.

טיפוסים בני מנייה (enums)
`LINK_CREATED`	נוצר הקישור שצוין בבקשה.
`PERSONA_OR_PLAYER_ALREADY_LINKED`	הקישור שצוין בבקשה לא נוצר, כי אם כבר יש קישורים קיימים, הקישור החדש יפר את `RecallTokensCardinalityConstraint` שצוין.