- एचटीटीपी अनुरोध
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- RecallTokensCardinalityConstraint
- ConflictingLinksResolutionPolicy
- राज्य
- इसे आज़माएं!
दिए गए रीकॉल सेशन आईडी में, कोड में बदले गए PGS प्लेयर के मुख्य खाते को गेम में मौजूद खाते से जोड़ें
एचटीटीपी अनुरोध
POST https://games.googleapis.com/games/v1/recall:linkPersona
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:
JSON के काेड में दिखाना |
---|
{ "sessionId": string, "persona": string, "token": string, "cardinalityConstraint": enum ( |
फ़ील्ड | |
---|---|
sessionId |
ज़रूरी है. ओपेक सर्वर से जनरेट की गई स्ट्रिंग, जो PGS प्लेयर / Google उपयोगकर्ता और ऐप्लिकेशन की पहचान करने के लिए सभी ज़रूरी जानकारी को कोड में बदलती है. |
persona |
ज़रूरी है. इन-गेम खाते का स्थायी आइडेंटिफ़ायर. कृपया अलग-अलग गेम के लिए, एक ही पर्सोना का फिर से इस्तेमाल न करें. |
token |
ज़रूरी है. बनाए जाने वाले टोकन की वैल्यू. Play Games से ओपेक न हो, बल्कि इसे नॉन-स्टेबल ('की रोटेशन' की मदद से एन्क्रिप्ट किया गया) माना जाता है. |
cardinalityConstraint |
ज़रूरी है. गेम के स्कोप वाले पर्सोना को खिलाड़ी से जोड़ते समय, एलिमेंट की संख्या का पता चलता है. |
conflictingLinksResolutionPolicy |
ज़रूरी है. जब किसी पर्सोना को किसी प्लेयर से लिंक करने की वजह से, एलिमेंट की तय संख्या से जुड़ी समस्या का उल्लंघन होता है, तो समाधान से जुड़ी नीति लागू होती है. |
यूनियन फ़ील्ड expiration . टोकन के खत्म होने की वैकल्पिक अवधि या उसे बनाए रखने की अवधि. expiration इनमें से सिर्फ़ एक हो सकता है: |
|
expireTime |
सिर्फ़ इनपुट. समयसीमा खत्म होने की वैकल्पिक अवधि. आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: |
ttl |
सिर्फ़ इनपुट. टाइम-टू-लाइव होना ज़रूरी नहीं है. सेकंड में कुल नौ दशमलव अंक, जो ' |
जवाब का मुख्य भाग
पर्सोना लिंक करने की कोशिश का नतीजा.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{
"state": enum ( |
फ़ील्ड | |
---|---|
state |
सिर्फ़ आउटपुट के लिए. पर्सोना लिंक करने की कोशिश की स्थिति. |
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/androidpublisher
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
RecallTokensCardinalityConstraint
गेम के स्कोप वाले पर्सोना को खिलाड़ी से जोड़ते समय, एलिमेंट की संख्या का पता चलता है.
Enums | |
---|---|
ONE_PERSONA_TO_ONE_PLAYER |
इन-गेम पर्सोना और Play की गेम सेवाओं के खिलाड़ियों के बीच, एलिमेंट की संख्या 1:1 है. लिंक करने की कार्रवाई के खत्म होने तक, ऐप्लिकेशन के स्कोप में प्लेयर और पर्सोना के लिए सिर्फ़ एक एंट्री रहनी चाहिए. इस कंस्ट्रेंट के बताए जाने पर, नया लिंक बनाया जाता है या नहीं, यह चुने गए
|
ConflictingLinksResolutionPolicy
जब किसी पर्सोना को किसी प्लेयर से लिंक करने की वजह से, एलिमेंट की तय संख्या से जुड़ी समस्या का उल्लंघन होता है, तो समाधान से जुड़ी नीति लागू होती है.
Enums | |
---|---|
KEEP_EXISTING_LINKS |
अगर प्लेयर और पर्सोना के बीच पहले से कोई लिंक मौजूद है, जिसकी वजह से नया लिंक बनाए जाने पर, तय किए गए उदाहरण के लिए, अगर Persona1-Player1 को पहले से ही ऐप्लिकेशन 1 के स्कोप में लिंक किया गया है और ऐप्लिकेशन 1 के स्कोप में एक नया लिंक Persona1-Player2 बनाने की कोशिश की जा रही है, तो पुराना लिंक ही रहेगा और कोई नया लिंक नहीं जोड़ा जाएगा. ध्यान दें कि अगर पहले से मौजूद लिंक किसी खास नीति का उल्लंघन करते हैं (ऐसा तब हो सकता है, जब सभी |
CREATE_NEW_LINK |
अगर प्लेयर और पर्सोना के बीच कोई मौजूदा लिंक पहले से मौजूद है, जिसकी वजह से नया लिंक बनाए जाने पर, बताए गए उदाहरण के लिए, अगर Persona1-Player1 को पहले से ही ऐप्लिकेशन1 के स्कोप में लिंक किया गया है और ऐप्लिकेशन 1 के स्कोप में एक नया लिंक Persona1-Player2 बनाने की कोशिश की जाती है, तो पुराने लिंक को हटा दिया जाएगा और इसकी जगह नया लिंक जोड़ दिया जाएगा. |
स्थिति
पर्सोना लिंक करने की कोशिश की स्थिति.
Enums | |
---|---|
LINK_CREATED |
अनुरोध में बताया गया लिंक बनाया गया. |
PERSONA_OR_PLAYER_ALREADY_LINKED |
अनुरोध में बताया गया लिंक नहीं बनाया गया. इसकी वजह यह है कि पहले से मौजूद लिंक की वजह से नया लिंक, तय RecallTokensCardinalityConstraint का उल्लंघन करेगा. |