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

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

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

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

ऐप्लिकेशन को रिलीज़ करने से पहले, Google से उसकी मंज़ूरी लेना ज़रूरी है.

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

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

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 सहमतियों को हटाने के लिए, अटैच किए गए OAuth टोकन के साथ ResetAuthorization() को कॉल करें.

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

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

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

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

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

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

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

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