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