बुनियादी जानकारी: डेटा पोर्टेबिलिटी एपीआई का इस्तेमाल करके ऐप्लिकेशन डेवलप करना

Data Portability API से ऐसे ऐप्लिकेशन बनाए जा सकते हैं जो Google की सेवाओं से आपके ऐप्लिकेशन में, डेटा की एक कॉपी को ट्रांसफ़र करने के लिए, उपयोगकर्ता से अनुमति का अनुरोध करते हैं. इससे डेटा पोर्टेबिलिटी चालू होती है और सेवाएं स्विच करने में मदद मिलती है.

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

ज़रूरी शर्तें

आपके ऐप्लिकेशन को रिलीज़ करने से पहले, Google की ओर से इसे मंज़ूरी मिली होनी चाहिए.

आपको यह भी पुष्टि करनी चाहिए कि डेटा पोर्टेबिलिटी एपीआई आपके देश या इलाके के लोगों के लिए उपलब्ध है या नहीं. जिन देशों और इलाकों में यह सुविधा उपलब्ध है उनकी सूची देखने के लिए, "तीसरे पक्ष के साथ अपने डेटा की कॉपी शेयर करें" पेज पर, आम तौर पर पूछे जाने वाले सवाल देखें.

डेवलपर का वर्कफ़्लो

Data Portability API का इस्तेमाल करने वाला ऐप्लिकेशन बनाने के लिए, यह तरीका अपनाएं.

1. उपयोगकर्ता के लिए OAuth सहमति फ़्लो लागू करें. इस उदाहरण में, उपयोगकर्ता ने YouTube वीडियो डेटा का ऐक्सेस दिया है.

   1. उपयोगकर्ता YouTube वीडियो इंपोर्ट करें पर क्लिक करता है और अपने Google खाते में साइन इन करता है.

   2. ऐप्लिकेशन, उपयोगकर्ता को OAuth के लिए सहमति देने वाले यूआरएल पर फ़ॉरवर्ड करता है. ध्यान दें कि यह उदाहरण यूआरएल आसान है और इसमें कुछ पैरामीटर मौजूद नहीं हैं:

      https://accounts.google.com/o/oauth2/v2/auth?scope=https://www.googleapis.com/auth/dataportability.myactivity.youtube

   3. उपयोगकर्ता, OAuth के लिए सहमति वाली स्क्रीन पर, आगे बढ़ें पर क्लिक करता है और अपना डेटा शेयर करने के लिए सहमति देता है. साथ ही, वह खाते का ऐक्सेस देता है.

   4. उपयोगकर्ता को ऐप्लिकेशन पर रीडायरेक्ट किया जाता है.

   5. डेवलपर, उपयोगकर्ता के लिए OAuth टोकन लेता है.

2. आपका ऐप्लिकेशन, अटैच किए गए OAuth टोकन के साथ InitiatePortabilityArchive(resources = ["myactivity.youtube"]) को कॉल करता है, जिसमें यह OAuth स्कोप शामिल है:

   https://www.googleapis.com/auth/dataportability.myactivity.youtube

   इस कॉल से, डेटा संग्रह बनाने की प्रोसेस शुरू हो जाएगी. आपको उपयोगकर्ता की अनुमति मिलने के 24 घंटे के अंदर, पोर्टेबिलिटी के संग्रह की प्रोसेस शुरू करनी होगी.

3. आपका ऐप्लिकेशन अटैच किए गए OAuth टोकन के साथ GetPortabilityArchiveState(job_id) को कॉल करता है, जिसमें यह OAuth स्कोप शामिल है:

   https://www.googleapis.com/auth/dataportability.myactivity.youtube

   संग्रह के काम की स्थिति वापस पाने के लिए इस तरीके को कई बार कॉल किया जा सकता है. तरीका काम की स्थिति दिखाता है. अगर स्टेटस 'पूरा' हो गया है, तो संग्रह तैयार होता है और Cloud Storage के साइन किए गए यूआरएल दिए जाते हैं. ध्यान दें कि संग्रहित करने के अनुरोध को पूरा करने में लगने वाला समय, डेटा के साइज़ के हिसाब से अलग-अलग मिनट से लेकर कई घंटों तक हो सकता है.

4. हस्ताक्षर किए गए यूआरएल का इस्तेमाल करके, संग्रहित किए गए डेटा को डाउनलोड करें.

5. खत्म हो चुके संसाधनों को रीसेट करने और सभी OAuth सहमतियां हटाने के लिए, ResetAuthorization() को अटैच किए गए OAuth टोकन के साथ कॉल करें.

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

डेटा पोर्टेबिलिटी एपीआई ऐप्लिकेशन के साथ उपयोगकर्ता कैसे इंटरैक्ट करते हैं

इस डायग्राम में दिखाया गया है कि उपयोगकर्ता, Data Portability API से इंटिग्रेट किए गए ऐप्लिकेशन के साथ कैसे इंटरैक्ट करते हैं.

1. सबसे पहले, उपयोगकर्ता को अपना डेटा वापस पाने का विकल्प दिया जाता है.

2. इसके बाद, उपयोगकर्ता अपने Google खाते में साइन इन करता है.

3. इसके बाद, जब उपयोगकर्ता को अपना डेटा शेयर करने का निर्देश मिलता है, तो आगे बढ़ें पर क्लिक किया जाता है. निजता नीति को स्वीकार करने का प्रॉम्प्ट मिलने पर, ठीक है पर क्लिक किया जाता है.

4. इसके बाद, उपयोगकर्ता को OAuth के लिए सहमति देने वाली स्क्रीन दिखाई जाती है. इसका इस्तेमाल ऐप्लिकेशन को अपने डेटा को ऐक्सेस करने की अनुमति देने के लिए किया जाता है. यहां दिए गए विकल्प, आपके कॉन्फ़िगर किए गए OAuth दायरों से मेल खाते हैं.

5. ऐक्सेस की अनुमति देने के बाद, डेटा इंपोर्ट शुरू हो जाता है. डेटा के साइज़ के आधार पर, अनुरोध को पूरा होने में कुछ मिनट से लेकर कई घंटे लग सकते हैं.