Method: recall.linkPersona

একটি ইন-গেম অ্যাকাউন্টের সাথে প্রদত্ত রিকল সেশন আইডিতে এনকোড করা PGS প্লেয়ার প্রধানকে সংযুক্ত করুন

HTTP অনুরোধ

POST https://games.googleapis.com/games/v1/recall:linkPersona

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "sessionId": string,
  "persona": string,
  "token": string,
  "cardinalityConstraint": enum (RecallTokensCardinalityConstraint),
  "conflictingLinksResolutionPolicy": enum (ConflictingLinksResolutionPolicy),

  // Union field expiration can be only one of the following:
  "expireTime": string,
  "ttl": string
  // End of list of possible types for union field expiration.
}
ক্ষেত্র
sessionId

string

প্রয়োজন। অস্বচ্ছ সার্ভার-জেনারেটেড স্ট্রিং যা পিজিএস প্লেয়ার / গুগল ব্যবহারকারী এবং অ্যাপ্লিকেশন সনাক্ত করতে প্রয়োজনীয় সমস্ত তথ্য এনকোড করে।

persona

string

প্রয়োজন। ইন-গেম অ্যাকাউন্টের স্থিতিশীল শনাক্তকারী। অনুগ্রহ করে বিভিন্ন গেমের জন্য একই ব্যক্তিত্ব পুনরায় ব্যবহার করা থেকে বিরত থাকুন।

token

string

প্রয়োজন। টোকেনের মান তৈরি করতে হবে। প্লে গেমগুলিতে অস্বচ্ছ এবং অ-স্থিতিশীল বলে ধরে নেওয়া হয়েছে (কী ঘূর্ণন সহ এনক্রিপ্ট করা)।

cardinalityConstraint

enum ( RecallTokensCardinalityConstraint )

প্রয়োজন। একটি গেমের সুযোগে একজন খেলোয়াড়ের সাথে একজন ব্যক্তিত্বকে লিঙ্ক করার সময় লক্ষ্য করার জন্য কার্ডিনালিটি সীমাবদ্ধতা।

ইউনিয়ন ক্ষেত্রের expiration । ঐচ্ছিক টোকেন মেয়াদ শেষ হওয়ার সময় বা বেঁচে থাকার সময়। expiration নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
expireTime

string ( Timestamp format)

শুধুমাত্র ইনপুট। ঐচ্ছিক মেয়াদ শেষ হওয়ার সময়।

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

ttl

string ( Duration format)

শুধুমাত্র ইনপুট। ঐচ্ছিক টাইম-টু-লাইভ।

নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' s ' দিয়ে শেষ হয়৷ উদাহরণ: "3.5s" ।

প্রতিক্রিয়া শরীর

ব্যক্তিত্ব লিঙ্ক করার প্রচেষ্টার ফলাফল।

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব
{
  "state": enum (State)
}
ক্ষেত্র
state

enum ( State )

শুধুমাত্র আউটপুট। একটি ব্যক্তিত্ব লিঙ্ক করার প্রচেষ্টার অবস্থা।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/androidpublisher

আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।

RecallTokensCardinality Constraint

একটি গেমের সুযোগে একজন খেলোয়াড়ের সাথে একজন ব্যক্তিত্বকে লিঙ্ক করার সময় লক্ষ্য করার জন্য কার্ডিনালিটি সীমাবদ্ধতা।

এনামস
ONE_PERSONA_TO_ONE_PLAYER

1:1 ইন-গেম ব্যক্তিত্ব এবং প্লে গেম পরিষেবার খেলোয়াড়দের মধ্যে মূলত্ব।

লিঙ্কিং অপারেশনের শেষে প্লেয়ার এবং ব্যক্তিত্বের জন্য শুধুমাত্র একটি এন্ট্রি আবেদনের সুযোগে থাকা উচিত।

যখন এই সীমাবদ্ধতা নির্দিষ্ট করা হয় তখন একটি নতুন লিঙ্ক তৈরি করা হয় বা না হয় তা নির্বাচিত ConflictingLinksResolutionPolicy দ্বারা নির্ধারিত হয়:

  • যদি KEEP_EXISTING_LINKS নির্দিষ্ট করা থাকে এবং প্রদত্ত ব্যক্তিত্বটি ইতিমধ্যেই একটি ভিন্ন প্লেয়ারের সাথে লিঙ্ক করা থাকে, অথবা প্লেয়ারটি ইতিমধ্যেই একটি ভিন্ন ব্যক্তিত্বের সাথে লিঙ্ক করা থাকে, তাহলে কোনো নতুন লিঙ্ক তৈরি করা হবে না এবং ইতিমধ্যে বিদ্যমান লিঙ্ক(গুলি) যেমন আছে (আছে) তেমনি থাকবে৷

  • যদি CREATE_NEW_LINK নির্দিষ্ট করা থাকে এবং প্রদত্ত ব্যক্তিত্বটি ইতিমধ্যেই একটি ভিন্ন প্লেয়ারের সাথে লিঙ্ক করা থাকে, অথবা প্লেয়ারটি ইতিমধ্যেই অন্য ব্যক্তিত্বের সাথে লিঙ্ক করা থাকে, তাহলে নতুন লিঙ্ক তৈরি হওয়ার পক্ষে পুরানো লিঙ্ক(গুলি) সরানো হবে৷

বিরোধপূর্ণ লিঙ্কসসমাধান নীতি

রেজোলিউশন নীতি প্রযোজ্য যখন একজন খেলোয়াড়ের সাথে একটি ব্যক্তিত্ব লিঙ্ক করার ফলে নির্দিষ্ট কার্ডিনালিটি সীমাবদ্ধতা লঙ্ঘন হবে।

এনামস

অবস্থা

একটি ব্যক্তিত্ব লিঙ্ক করার প্রচেষ্টার অবস্থা।

এনামস
PERSONA_OR_PLAYER_ALREADY_LINKED অনুরোধে উল্লিখিত লিঙ্কটি তৈরি করা হয়নি কারণ ইতিমধ্যে বিদ্যমান লিঙ্কগুলি তৈরি করা হলে নতুন লিঙ্ক নির্দিষ্ট RecallTokensCardinalityConstraint লঙ্ঘন করবে।