Google Play Games Services API

গুগল প্লে গেমস সার্ভিস ডেভেলপারদের সোশ্যাল লিডারবোর্ড, অ্যাচিভমেন্ট, গেম স্টেট, গুগল দিয়ে সাইন-ইন এবং আরও অনেক কিছু দিয়ে গেম উন্নত করার সুযোগ দেয়।

পরিষেবা: games.googleapis.com

এই পরিষেবাটি কল করার জন্য, আমরা আপনাকে গুগল-প্রদত্ত ক্লায়েন্ট লাইব্রেরিগুলো ব্যবহার করার পরামর্শ দিই। যদি আপনার অ্যাপ্লিকেশনকে এই পরিষেবাটি কল করার জন্য নিজস্ব লাইব্রেরি ব্যবহার করার প্রয়োজন হয়, তাহলে এপিআই (API) অনুরোধ করার সময় নিম্নলিখিত তথ্যগুলো ব্যবহার করুন।

আবিষ্কার নথি

ডিসকভারি ডকুমেন্ট হলো REST API-এর বর্ণনা এবং ব্যবহারের জন্য একটি মেশিন-পঠনযোগ্য স্পেসিফিকেশন। এটি ক্লায়েন্ট লাইব্রেরি, IDE প্লাগইন এবং গুগল API-এর সাথে ইন্টারঅ্যাক্ট করে এমন অন্যান্য টুল তৈরি করতে ব্যবহৃত হয়। একটি সার্ভিস একাধিক ডিসকভারি ডকুমেন্ট প্রদান করতে পারে। এই সার্ভিসটি নিম্নলিখিত ডিসকভারি ডকুমেন্টটি প্রদান করে:

পরিষেবা শেষবিন্দু

সার্ভিস এন্ডপয়েন্ট হলো একটি বেস ইউআরএল যা কোনো এপিআই সার্ভিসের নেটওয়ার্ক অ্যাড্রেস নির্দিষ্ট করে। একটি সার্ভিসের একাধিক সার্ভিস এন্ডপয়েন্ট থাকতে পারে। এই সার্ভিসটির নিম্নলিখিত সার্ভিস এন্ডপয়েন্ট রয়েছে এবং নীচের সমস্ত ইউআরআই এই সার্ভিস এন্ডপয়েন্টের সাপেক্ষে নির্ধারিত:

  • https://games.googleapis.com

REST রিসোর্স: অ্যাক্সেস টোকেন

পদ্ধতি
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
সংযুক্ত ক্রেডেনশিয়াল দ্বারা চিহ্নিত PGS ব্যবহারকারীর জন্য একটি প্লে গ্রুপিং API টোকেন তৈরি করে।
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
অনুরোধে প্রদত্ত রিকল সেশন আইডি দ্বারা চিহ্নিত পিজিএস ব্যবহারকারীর জন্য একটি প্লে গ্রুপিং এপিআই টোকেন তৈরি করে।

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 রিসোর্স: প্লেয়ারগেমইভেন্টস

পদ্ধতি
batchRecordEvents POST /games/v1/players/{playerId}/gameEvents:batchRecordEvents
একজন নির্দিষ্ট খেলোয়াড়ের খেলার ঘটনাগুলোর একটি গুচ্ছ রেকর্ড করে।

বিশ্রামের উৎস: খেলোয়াড়রা

পদ্ধতি
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 রিসোর্স: রিকল

পদ্ধতি
gamesPlayerTokens GET /games/v1/recall/gamesPlayerTokens/{sessionId}
প্রদত্ত রিকল সেশন আইডিতে এনকোড করা পিজিএস প্লেয়ারের সাথে সংশ্লিষ্ট অনুরোধকৃত সমস্ত গেম থেকে রিকল টোকেনগুলো পুনরুদ্ধার করুন।
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
প্রদত্ত রিকল সেশন আইডিতে এনকোড করা পিজিএস প্লেয়ারের সাথে সংশ্লিষ্ট সমস্ত ডেভেলপার গেম থেকে সর্বশেষ রিকল টোকেনটি পুনরুদ্ধার করুন।
linkPersona POST /games/v1/recall:linkPersona
প্রদত্ত রিকল সেশন আইডিতে এনকোড করা পিজিএস প্লেয়ার প্রিন্সিপালটিকে একটি ইন-গেম অ্যাকাউন্টের সাথে সংযুক্ত করুন।
resetPersona POST /games/v1/recall:resetPersona
প্রদত্ত পার্সোনাটিকে যেকোনো প্লেয়ারের (প্রোফাইল থাকুক বা না থাকুক) সাথে সংযুক্তকারী সমস্ত রিকল টোকেন মুছে ফেলুন।
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
প্রদত্ত রিকল সেশন আইডিতে এনকোড করা, পিজিএস প্লেয়ারের সাথে সংশ্লিষ্ট সমস্ত রিকল টোকেন পুনরুদ্ধার করুন।
unlinkPersona POST /games/v1/recall:unlinkPersona
রিকল সেশন দ্বারা চিহ্নিত পিজিএস প্লেয়ার প্রিন্সিপাল এবং 'পার্সোনা' বা টোকেন ভ্যালু দ্বারা চিহ্নিত একটি ইন-গেম অ্যাকাউন্টের মধ্যে সংযোগকারী একটি রিকল টোকেন মুছে ফেলুন।

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
বর্তমানে প্রমাণীকৃত ব্যবহারকারীর জন্য এই অ্যাপ্লিকেশনে সম্পৃক্ততা এবং ব্যয়ের পরিসংখ্যান প্রদান করে।