Google Play Games Services API

«سرویس بازی‌های Google Play» به توسعه‌دهندگان امکان می‌دهد بازی‌ها را با تابلو پیشتازان اجتماعی، جایزه‌ها، وضعیت بازی، ورود به سیستم با Google، و غیره بهبود بخشند.

سرویس: games.googleapis.com

برای فراخوانی این سرویس، توصیه می‌کنیم از کتابخانه‌های کارخواه ارائه‌شده توسط Google استفاده کنید. اگر برنامه شما برای فراخوانی این سرویس باید از کتابخانه‌های خودتان استفاده کند، هنگام درخواست‌های API از اطلاعات زیر استفاده کنید.

سند اکتشاف

سند اکتشاف مشخصه‌ای ماشین‌خوانا برای توصیف و مصرف میاناهای برنامه‌سازی کاربردی REST است. از آن برای ساختن کتابخانه‌های کارخواه، افزایه‌های IDE، و ابزارهای دیگری که با Google API تعامل دارند استفاده می‌شود. یک سرویس ممکن است چندین سند اکتشاف ارائه دهد. این سرویس سند اکتشاف زیر را ارائه می‌دهد:

نقطه پایان سرویس

نقطه پایان سرویس نشانی وب پایه‌ای است که نشانی شبکه سرویس میانای برنامه‌سازی کاربردی را مشخص می‌کند. یک سرویس ممکن است چندین نقطه پایانی سرویس داشته باشد. این سرویس نقطه پایانی سرویس زیر را دارد و همه شناسه منابع یکسان زیر مربوط به این نقطه پایانی سرویس هستند:

  • https://games.googleapis.com

منبع REST: accesstokens

روش‌ها
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
یک کد Play Grouping API برای کاربر «خدمات بازی‌های Play» که با اعتبارنامه پیوست‌شده شناسایی شده است تولید می‌کند.
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
یک کد Play Grouping API برای کاربر «خدمات بازی‌های Play» که با شناسه جلسه Recall ارائه‌شده در درخواست شناسایی شده است تولید می‌کند.

منبع REST:‏ achievementDefinitions

روش‌ها
list GET /games/v1/achievements
همه تعاریف موفقیت را برای برنامه‌تان فهرست می‌کند.

منبع REST: achievements

روش‌ها
increment POST /games/v1/achievements/{achievementId}/increment
مراحل جایزه را با شناسه ارائه‌شده برای بازیکن اصالت‌سنجی‌شده فعلی افزایش می‌دهد.
list GET /games/v1/players/{playerId}/achievements
پیشرفت همه جایزه‌های برنامه‌تان را برای بازیکن اصالت‌سنجی‌شده فعلی فهرست می‌کند.
reveal POST /games/v1/achievements/{achievementId}/reveal
وضعیت موفقیت با شناسه ارائه‌شده را برای بازیکن اصالت‌سنجی‌شده فعلی روی REVEALED تنظیم می‌کند.
setStepsAtLeast POST /games/v1/achievements/{achievementId}/setStepsAtLeast
مراحل را برای بازیکن اصالت‌سنجی‌شده فعلی برای باز کردن قفل جایزه تنظیم می‌کند.
unlock POST /games/v1/achievements/{achievementId}/unlock
این جایزه را برای بازیکن اصالت‌سنجی‌شده فعلی باز می‌کند.
updateMultiple POST /games/v1/achievements/updateMultiple
چند جایزه را برای بازیکن اصالت‌سنجی‌شده فعلی به‌روز می‌کند.

منبع REST: برنامه‌ها

روش‌ها
get GET /games/v1/applications/{applicationId}
فراداده برنامه را با شناسه ارائه‌شده بازیابی می‌کند.
getEndPoint POST /games/v1/applications/getEndPoint
نشانی وب را برای نوع نقطه پایانی درخواست‌شده برمی‌گرداند.
played POST /games/v1/applications/played
نشان می‌دهد که کاربر اصالت‌سنجی‌شده فعلی درحال بازی کردن برنامه شما است.
verify GET /games/v1/applications/{applicationId}/verify
درستی‌سنجی می‌کند که کد اصالت‌سنجی ارائه‌شده با این درخواست برای برنامه با شناسه مشخص‌شده است و شناسه بازیکنی را که این کد برای او صادر شده است برمی‌گرداند.

منبع REST: رویدادها

روش‌ها
listByPlayer GET /games/v1/events
فهرستی را برمی‌گرداند که پیشرفت فعلی رویدادها را در این برنامه برای کاربر اصالت‌سنجی‌شده فعلی نشان می‌دهد.
listDefinitions GET /games/v1/eventDefinitions
فهرستی از تعاریف رویداد در این برنامه را برمی‌گرداند.
record POST /games/v1/events
دسته‌ای از تغییرات را در تعداد دفعاتی که رویدادها برای کاربر اصالت‌سنجی‌شده کنونی این برنامه رخ داده است ثبت می‌کند.

منبع REST:‏ gameStats

روش‌ها
batchRecordEvents POST /games/v1/players/{playerId}/gameStats:batchRecordEvents
دسته‌ای از رویدادهای بازی بازیکن را برای بازیکنی خاص ثبت می‌کند.

منبع REST: تابلوهای پیشتازان

روش‌ها
get GET /games/v1/leaderboards/{leaderboardId}
فراداده تابلو پیشتازان را با شناسه ارائه‌شده بازیابی می‌کند.
list GET /games/v1/leaderboards
همه فراداده‌های جدول رده‌بندی را برای برنامه‌تان فهرست می‌کند.

منبع REST: metagame

روش‌ها
getMetagameConfig GET /games/v1/metagameConfig
داده‌های پیکربندی فرابازی را برای برنامه تماس‌گیرنده برمی‌گرداند.
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
فهرست کردن داده‌های بازی تجمیع‌شده براساس دسته برای بازیکن مربوط به playerId.

منبع REST: بازیکنان

روش‌ها
get GET /games/v1/players/{playerId}
منبع «بازیکن» را با شناسه ارائه‌شده بازیابی می‌کند.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
شناسه‌های بازیکن برنامه را برای بازیکن اصالت‌سنجی‌شده فعلی در همه بازی‌های درخواست‌شده توسط همان توسعه‌دهنده برنامه فراخواننده دریافت کنید.
getScopedPlayerIds GET /games/v1/players/me/scopedIds
شناسه‌های بازیکن محدودشده را برای کاربر اصالت‌سنجی‌شده فعلی بازیابی می‌کند.
list GET /games/v1/players/me/players/{collection}
مجموعه بازیکنان را برای کاربر اصالت‌سنجی‌شده فعلی دریافت کنید.

منبع REST: recall

روش‌ها
gamesPlayerTokens GET /games/v1/recall/gamesPlayerTokens/{sessionId}
بازیابی کدهای Recall از همه بازی‌های درخواست‌شده که با «بازیکن بازی‌های Play» کدگذاری‌شده در شناسه جلسه Recall ارائه‌شده مرتبط است.
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
آخرین کد Recall را از همه بازی‌های توسعه‌دهنده که با «بازیکن خدمات بازی‌های Play» کدگذاری‌شده در شناسه جلسه Recall ارائه‌شده مرتبط است بازیابی کنید.
linkPersona POST /games/v1/recall:linkPersona
مرتبط کردن شناسه بازیکن «سرویس‌های بازی Play» کدگذاری‌شده در شناسه جلسه فراخوانی ارائه‌شده با حساب درون‌بازی
resetPersona POST /games/v1/recall:resetPersona
همه کدهای Recall را که شخصیت داده‌شده را به هر بازیکنی (با یا بدون نمایه) پیوند می‌دهد حذف کنید.
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
همه کدهای Recall مرتبط با «بازیکن خدمات بازی‌های Play» را که در شناسه جلسه Recall ارائه‌شده کدگذاری شده است بازیابی کنید.
unlinkPersona POST /games/v1/recall:unlinkPersona
کد Recall را که «بازیکن خدمات بازی‌های Play» اصلی شناسایی‌شده توسط جلسه Recall و حساب درون‌بازی شناسایی‌شده توسط «شخصیت» یا مقدار کد را پیوند می‌دهد حذف کنید.

منبع REST: revisions

روش‌ها
check GET /games/v1/revisions/check
بررسی می‌کند که آیا کلاینت بازی‌ها قدیمی است یا نه.

منبع REST: scores

روش‌ها
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
امتیازهای بالا و رتبه‌های اختیاری را در تابلو پیشتازان برای بازیکن اصالت‌سنجی‌شده فعلی دریافت کنید.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
امتیازها را در جدول رده‌بندی از بالا فهرست می‌کند.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
امتیازهای موجود در جدول رده‌بندی را در اطراف (و شامل) امتیاز بازیکن فهرست می‌کند.
submit POST /games/v1/leaderboards/{leaderboardId}/scores
امتیازی را به تابلو پیشتازان مشخص‌شده ارسال می‌کند.
submitMultiple POST /games/v1/leaderboards/scores
چندین امتیاز را به تابلو پیشتازان ارسال می‌کند.

منبع REST: snapshots

روش‌ها
get GET /games/v1/snapshots/{snapshotId}
فراداده را برای شناسه عکس آنی داده‌شده بازیابی می‌کند.
list GET /games/v1/players/{playerId}/snapshots
فهرستی از عکس‌های آنی ایجادشده توسط برنامه شما را برای بازیکن مربوط به شناسه بازیکن بازیابی می‌کند.

منبع REST: stats

روش‌ها
get GET /games/v1/stats
آمار تعامل و هزینه را در این برنامه برای کاربر اصالت‌سنجی‌شده فعلی برمی‌گرداند.