Google Play Game Services

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

خدمات: games.googleapis.com

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

سند کشف

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

نقطه پایان خدمات

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

  • https://games.googleapis.com

منبع REST: accesstokens

مواد و روش ها
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
یک نشانه API Grouping Play برای کاربر PGS که با اعتبار پیوست شده شناسایی شده است ایجاد می کند.
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
یک نشانه API گروه بندی Play برای کاربر 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: بازیکنان

مواد و روش ها
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}
نشانه‌های فراخوان را از همه بازی‌های درخواستی که با PGS Player کدگذاری شده در شناسه جلسه فراخوان ارائه شده مرتبط هستند، بازیابی کنید.
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
آخرین نشانه فراخوان را از همه بازی های توسعه دهنده که با PGS Player کدگذاری شده در شناسه جلسه فراخوان ارائه شده مرتبط است، بازیابی کنید.
linkPersona POST /games/v1/recall:linkPersona
اصل بازیکن PGS رمزگذاری شده در شناسه جلسه فراخوان ارائه شده را با یک حساب درون بازی مرتبط کنید
resetPersona POST /games/v1/recall:resetPersona
تمام نشانه های فراخوانی را که شخصیت داده شده را به هر بازیکنی (با یا بدون نمایه) مرتبط می کند، حذف کنید.
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
همه نشانه‌های فراخوان مرتبط با پخش‌کننده PGS را که در شناسه جلسه فراخوان ارائه شده کدگذاری شده‌اند، بازیابی کنید.
unlinkPersona POST /games/v1/recall:unlinkPersona
یک نشانه فراخوانی را حذف کنید که اصل بازیکن PGS شناسایی شده توسط جلسه فراخوان و یک حساب درون بازی که توسط "persona" یا با مقدار توکن شناسایی شده است را به هم مرتبط کنید.

منبع 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}
فراداده یک شناسه عکس فوری معین را بازیابی می کند.
list GET /games/v1/players/{playerId}/snapshots
فهرستی از عکس های فوری ایجاد شده توسط برنامه شما برای پخش کننده مربوط به شناسه پخش کننده را بازیابی می کند.

منبع REST: آمار

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