- בקשת HTTP
- גוף הבקשה
- גוף התשובה
- היקפי הרשאות
- RecallTokensCardinalityConstraint
- ConflictingLinksResolutionPolicy
- מדינה
- רוצים לנסות?
שיוך חשבון המשתמש של שחקן ה-PGS שקודד במזהה סשן הריקול שסופק לחשבון במשחק
בקשת HTTP
POST https://games.googleapis.com/games/v1/recall:linkPersona
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "sessionId": string, "persona": string, "token": string, "cardinalityConstraint": enum ( |
שדות | |
---|---|
sessionId |
חובה. מחרוזת אטומה שנוצרה על ידי שרת, שמקודדת את כל המידע הנדרש לזיהוי המשתמש והיישום של Google Play Games / של Google. |
persona |
חובה. המזהה היציב של החשבון במשחק. יש להימנע משימוש חוזר באותה פרסונה במשחקים שונים. |
token |
חובה. ערך האסימון ליצירה. אטומים ל-Play Games ונחשבים לא יציבים (מוצפנים באמצעות רוטציית מפתחות). |
cardinalityConstraint |
חובה. אילוץ של עוצמה (cardinality) שצריך לשים לב כשמקשרים פרסונה לשחקן במהלך משחק. |
conflictingLinksResolutionPolicy |
חובה. מדיניות פתרון שתחול כשקישור של פרסונה לשחקן יגרום להפרת האילוץ של העוצמה שצוינה. |
שדה איחוד expiration . אופציונלי: זמן התפוגה או הזמן של האסימון הקיים. הערך של expiration יכול להיות רק אחת מהאפשרויות הבאות: |
|
expireTime |
קלט בלבד. זמן תפוגה אופציונלי. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
ttl |
קלט בלבד. ערך אופציונלי של אורך חיים (TTL). משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, המסתיים ב-' |
גוף התגובה
תוצאה של ניסיון קישור פרסונה.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{
"state": enum ( |
שדות | |
---|---|
state |
פלט בלבד. המצב של ניסיון הקישור לפרסונה. |
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/androidpublisher
למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
RecallTokensCardinalityConstraint
אילוץ של עוצמה (cardinality) שצריך לשים לב כשמקשרים פרסונה לשחקן במהלך משחק.
טיפוסים בני מנייה (enums) | |
---|---|
ONE_PERSONA_TO_ONE_PLAYER |
עוצמה (cardinality) ביחס של 1:1 בין פרסונות במשחק לבין שחקנים ב-Play Games Services. בסוף פעולת הקישור, רק רשומה אחת של הנגן והפרסונה צריכות להישאר בהיקף האפליקציה. האם קישור חדש נוצר או לא כשהאילוץ הזה נקבע על ידי ערך
|
ConflictingLinksResolutionPolicy
מדיניות פתרון שתחול כשקישור של פרסונה לשחקן יגרום להפרת האילוץ של העוצמה שצוינה.
טיפוסים בני מנייה (enums) | |
---|---|
KEEP_EXISTING_LINKS |
אם כבר קיימים קישורים בין שחקן לפרסונה, שיובילו להפרה של לדוגמה, אם Persona1-Player1 כבר מקושר במסגרת app1 ותנסה ליצור קישור חדש Persona1-Player2 בהיקף של Application1 עם אילוץ של לתשומת ליבך, אם הקישורים שכבר קיימים אכן מפרים את המדיניות שצוינה (דבר זה עלול לקרות אם לא כל הקריאות ל- |
CREATE_NEW_LINK |
אם כבר קיים קישור בין שחקן לפרסונה, שיוביל להפרה של לדוגמה, אם Persona1-Player1 כבר מקושר בהיקף של application1, ומתבצע ניסיון ליצור קישור חדש Persona1-Player2 בהיקף של application1 עם אילוץ |
ארץ
המצב של ניסיון הקישור לפרסונה.
טיפוסים בני מנייה (enums) | |
---|---|
LINK_CREATED |
נוצר הקישור שצוין בבקשה. |
PERSONA_OR_PLAYER_ALREADY_LINKED |
הקישור שצוין בבקשה לא נוצר, כי אם כבר יש קישורים קיימים, הקישור החדש יפר את RecallTokensCardinalityConstraint שצוין. |