Method: recall.linkPersona

• एचटीटीपी अनुरोध
• अनुरोध का मुख्य हिस्सा
  • JSON फ़ॉर्मैट में दिखाना
• जवाब का मुख्य हिस्सा
  • JSON फ़ॉर्मैट में दिखाना
• अनुमति के दायरे
• RecallTokensCardinalityConstraint
• ConflictingLinksResolutionPolicy
• राज्य
• इसे आज़माएं!

दिए गए रीकॉल सेशन आईडी में, कोड में बदले गए पीजीएस प्लेयर के मुख्य खाते को इन-गेम खाते से जोड़ें

एचटीटीपी अनुरोध

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

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना
{ "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 ज़रूरी है. सर्वर से जनरेट की गई ओपेक स्ट्रिंग, जो PGS प्लेयर / Google उपयोगकर्ता और ऐप्लिकेशन की पहचान करने के लिए, सभी ज़रूरी जानकारी को कोड में बदलती है.
persona	string ज़रूरी है. इन-गेम खाते का स्थायी आइडेंटिफ़ायर. कृपया अलग-अलग गेम के लिए एक ही पर्सोना का दोबारा इस्तेमाल न करें.
token	string ज़रूरी है. बनाए जाने वाले टोकन की वैल्यू. यह Play Games के लिए ओपेक है और इसे नॉन-स्टेबल माना जाता है. इसे पासकोड बदलने की मदद से एन्क्रिप्ट (सुरक्षित) किया जाता है.
cardinalityConstraint	enum (RecallTokensCardinalityConstraint) ज़रूरी है. किसी गेम के स्कोप में पर्सोना को खिलाड़ी से जोड़ते समय, एलिमेंट की संख्या का पता लगाने के लिए एलिमेंट की संख्या.
conflictingLinksResolutionPolicy	enum (ConflictingLinksResolutionPolicy) ज़रूरी है. रिज़ॉल्यूशन नीति तब लागू की जाती है, जब पर्सोना को किसी प्लेयर से जोड़ने पर तय एलिमेंट की संख्या का उल्लंघन होता हो.
यूनियन फ़ील्ड expiration. टोकन के खत्म होने की तारीख या समय देना ज़रूरी नहीं है. expiration इनमें से सिर्फ़ एक हो सकता है:
expireTime	string (Timestamp format) सिर्फ़ इनपुट. समयसीमा खत्म होने की वैकल्पिक तारीख. RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
ttl	string (Duration format) सिर्फ़ इनपुट. वैकल्पिक टाइम-टू-लाइव. सेकंड में अवधि, जिसमें नौ भिन्नात्मक अंक हो सकते हैं और जो 's' पर खत्म होती है. उदाहरण: "3.5s".

जवाब का मुख्य भाग

पर्सोना लिंक करने की कोशिश का नतीजा.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना
{ "state": enum (State) }

फ़ील्ड
state	enum (State) सिर्फ़ आउटपुट के लिए. पर्सोना लिंक करने की कोशिश की स्थिति.

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

RecallTokensCardinalityConstraint

किसी गेम के स्कोप में पर्सोना को खिलाड़ी से जोड़ते समय, एलिमेंट की संख्या का पता लगाने के लिए एलिमेंट की संख्या.

Enums

ONE_PERSONA_TO_ONE_PLAYER

इन-गेम पर्सोना और Play की गेम सेवाओं के खिलाड़ियों के बीच 1:1 की संख्या. लिंक करने की कार्रवाई खत्म होने तक, प्लेयर और पर्सोना के लिए सिर्फ़ एक एंट्री होनी चाहिए. इस कंस्ट्रेंट के तय होने पर नया लिंक बनाया जाएगा या नहीं, यह चुने गए ConflictingLinksResolutionPolicy से तय होता है: अगर KEEP_EXISTING_LINKS दिया गया है और दिया गया पर्सोना पहले से ही किसी दूसरे प्लेयर से जुड़ा है या प्लेयर पहले से ही किसी दूसरे पर्सोना से जुड़ा है, तो कोई नया लिंक नहीं बनाया जाएगा. साथ ही, पहले से मौजूद लिंक पहले जैसे ही रहेंगे. अगर CREATE_NEW_LINK बताया गया है और दिया गया पर्सोना पहले से ही किसी दूसरे प्लेयर से जुड़ा हुआ है या प्लेयर पहले से ही किसी दूसरे पर्सोना से जुड़ा है, तो नया लिंक बनाने की वजह से पुराने लिंक को हटा दिया जाएगा.

ConflictingLinksResolutionPolicy

रिज़ॉल्यूशन नीति तब लागू की जाती है, जब पर्सोना को किसी प्लेयर से जोड़ने पर तय एलिमेंट की संख्या का उल्लंघन होता हो.

Enums
KEEP_EXISTING_LINKS	अगर किसी प्लेयर और पर्सोना के बीच के लिंक पहले से मौजूद हैं, जिनकी वजह से नया लिंक बनाए जाने पर तय किए गए RecallTokensCardinalityConstraint का उल्लंघन हो सकता है, तो पहले से मौजूद लिंक रखें. उदाहरण के लिए, अगर ऐप्लिकेशन 1 के स्कोप में Persona1-Player1 को पहले से ही लिंक किया गया है और ऐप्लिकेशन1 के दायरे में, MANY_PERSONAS_TO_ONE_PLAYER कंस्ट्रेंट के साथ एक नया लिंक Persona1-Player2 बनाने की कोशिश की जा रही है, पुराना लिंक ही रहेगा और कोई नया लिंक नहीं जोड़ा जाएगा. ध्यान दें कि अगर पहले से मौजूद लिंक किसी खास नीति का उल्लंघन करते हैं (ऐसा तब हो सकता है, जब सभी recall.linkPersona कॉल एक ही RecallTokensCardinalityConstraint का इस्तेमाल न करते हों), इस नीति से इन उल्लंघनों को नहीं सुलझाया जाएगा. विवादों को सुलझाने के लिए, {@link CREATE_NEW_LINK नीति का इस्तेमाल, लिंक में किए गए विरोधों को फिर से लिखने के लिए किया जाना चाहिए.
CREATE_NEW_LINK	अगर किसी प्लेयर और पर्सोना के बीच पहले से कोई लिंक मौजूद है, जिसकी वजह से नया लिंक बनाए जाने के बावजूद, तय किए गए RecallTokensCardinalityConstraint का उल्लंघन हो सकता है, तो पहले से मौजूद लिंक को नए लिंक से बदलें. उदाहरण के लिए, अगर ऐप्लिकेशन 1 के दायरे में Persona1-Player1 पहले से ही लिंक है और ऐप्लिकेशन1 के दायरे में MANY_PERSONAS_TO_ONE_PLAYER कंस्ट्रेंट के साथ एक नया लिंक Persona1-Player2 बनाने की कोशिश की जाती है, तो पुराना लिंक हटा दिया जाएगा और उसकी जगह नया लिंक जोड़ दिया जाएगा.

स्थिति

पर्सोना लिंक करने की कोशिश की स्थिति.

Enums
LINK_CREATED	अनुरोध में दिया गया लिंक बना दिया गया है.
PERSONA_OR_PLAYER_ALREADY_LINKED	अनुरोध में दिया गया लिंक नहीं बनाया गया, क्योंकि पहले से मौजूद लिंक की वजह से नया लिंक, तय किए गए RecallTokensCardinalityConstraint का उल्लंघन करेगा.