Google Play Games Services API

سرویس بازی‌های گوگل پلی به توسعه‌دهندگان اجازه می‌دهد تا بازی‌ها را با استفاده از جدول امتیازات اجتماعی، دستاوردها، وضعیت بازی، ورود به سیستم با گوگل و موارد دیگر بهبود بخشند.

سرویس: games.googleapis.com

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

سند کشف

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

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

یک نقطه پایانی سرویس ، یک URL پایه است که آدرس شبکه یک سرویس API را مشخص می‌کند. یک سرویس ممکن است چندین نقطه پایانی سرویس داشته باشد. این سرویس دارای نقطه پایانی سرویس زیر است و تمام URI های زیر نسبت به این نقطه پایانی سرویس هستند:

  • https://games.googleapis.com
منبع REST: accesstokens
روش‌ها
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
یک توکن API گروه‌بندی بازی برای کاربر PGS که با اعتبارنامه پیوست شده شناسایی شده است، تولید می‌کند.
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
یک توکن API گروه‌بندی بازی برای کاربر PGS که توسط شناسه جلسه فراخوانی ارائه شده در درخواست شناسایی شده است، تولید می‌کند.
منبع REST: تعاریف دستاورد
روش‌ها
list GET /games/v1/achievements
تمام تعاریف دستاوردها را برای درخواست شما فهرست می‌کند.
منبع REST: دستاوردها
روش‌ها
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
یک URL برای نوع نقطه پایانی درخواست شده برمی‌گرداند.
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: جدول امتیازات
روش‌ها
get GET /games/v1/leaderboards/{leaderboardId}
فراداده‌های جدول امتیازات را با شناسه داده شده بازیابی می‌کند.
list GET /games/v1/leaderboards
تمام فراداده‌های جدول امتیازات برنامه شما را فهرست می‌کند.
منبع REST: متاگیم
روش‌ها
getMetagameConfig GET /games/v1/metagameConfig
داده‌های پیکربندی متاگیم را برای برنامه‌ی فراخوانی‌شده برمی‌گرداند.
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
داده‌های پخش را که بر اساس دسته‌بندی برای بازیکن مربوط به playerId جمع‌آوری شده‌اند، فهرست کنید.
منبع REST: playerGameEvents
روش‌ها
batchRecordEvents POST /games/v1/players/{playerId}/gameEvents:batchRecordEvents
دسته‌ای از رویدادهای بازی بازیکن را برای یک بازیکن خاص ثبت می‌کند.
منبع REST: بازیکنان
روش‌ها
get GET /games/v1/players/{playerId}
منبع Player را با شناسه داده شده بازیابی می‌کند.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
شناسه‌های پخش‌کننده برنامه را برای پخش‌کننده‌ای که در حال حاضر احراز هویت شده است، در تمام بازی‌های درخواستی توسط همان توسعه‌دهنده‌ای که برنامه فراخوانی‌کننده را اجرا می‌کند، دریافت کنید.
getScopedPlayerIds GET /games/v1/players/me/scopedIds
شناسه‌های پخش‌کننده‌ی محدوده‌بندی‌شده را برای کاربر احراز هویت‌شده‌ی فعلی بازیابی می‌کند.
list GET /games/v1/players/me/players/{collection}
مجموعه بازیکنان را برای کاربر احراز هویت شده فعلی دریافت کنید.
منبع REST: فراخوانی
روش‌ها
gamesPlayerTokens GET /games/v1/recall/gamesPlayerTokens/{sessionId}
توکن‌های فراخوان (Recall) را از تمام بازی‌های درخواستی که با پخش‌کننده PGS کدگذاری شده در شناسه جلسه فراخوان ارائه شده مرتبط هستند، بازیابی کنید.
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
آخرین توکن Recall را از تمام بازی‌های توسعه‌دهندگان که با PGS Player کدگذاری شده در شناسه جلسه فراخوانی ارائه شده مرتبط است، بازیابی کنید.
linkPersona POST /games/v1/recall:linkPersona
کد اصلی PGS Player که در شناسه جلسه بازیابی ارائه شده کدگذاری شده است را با یک حساب درون بازی مرتبط کنید
resetPersona POST /games/v1/recall:resetPersona
تمام توکن‌های بازیابی که شخصیت داده شده را به هر بازیکنی (با یا بدون پروفایل) مرتبط می‌کنند، حذف کنید.
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
تمام توکن‌های فراخوانی مرتبط با PGS Player که در شناسه جلسه فراخوانی ارائه شده کدگذاری شده‌اند را بازیابی کنید.
unlinkPersona POST /games/v1/recall:unlinkPersona
یک توکن فراخوانی که به بازیکن اصلی PGS که توسط جلسه فراخوانی مشخص شده است و یک حساب درون بازی که توسط «شخصیت» یا توسط مقدار توکن مشخص شده است، متصل است را حذف کنید.
منبع REST: اصلاحات
روش‌ها
check GET /games/v1/revisions/check
بررسی می‌کند که آیا کلاینت بازی‌ها قدیمی است یا خیر.
منبع REST: نمرات
روش‌ها
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: اسنپ‌شات‌ها
روش‌ها
get GET /games/v1/snapshots/{snapshotId}
فراداده (metadata) مربوط به یک شناسه‌ی اسنپ‌شات (snapshot ID) داده شده را بازیابی می‌کند.
list GET /games/v1/players/{playerId}/snapshots
لیستی از اسنپ‌شات‌های ایجاد شده توسط برنامه شما برای بازیکن مربوط به شناسه بازیکن را بازیابی می‌کند.
منبع REST: آمار
روش‌ها
get GET /games/v1/stats
آمار تعامل و هزینه را در این برنامه برای کاربر احراز هویت شده فعلی برمی‌گرداند.