Method: scores.submit

שליחת ניקוד ל-Leaderboard שצוין.

בקשת HTTP

POST https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/scores

פרמטרים של נתיב

פרמטרים
leaderboardId

string

מזהה הלידרבורד.

פרמטרים של שאילתה

פרמטרים
language

string

השפה המועדפת לשימוש במחרוזות שמוחזרות בשיטה הזו.

score

string (int64 format)

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

scoreTag

string

מידע נוסף על הציון שלך. הערכים לא יכולים להכיל יותר מ-64 תווים בטוחים ל-URI, כפי שהוגדר בסעיף 2.3 של RFC 3986.

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התגובה

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול מופע של SubmitLeaderboardScoreResponse.

היקפי הרשאות

כדי להשתמש בתכונה הזו יש צורך באחד מההיקפים הבאים של OAuth:

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.