Method: scores.submit

امتیازی را به تابلوی امتیازات مشخص شده ارسال می کند.

درخواست 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 مراجعه کنید.