Python स्क्रिप्ट का इस्तेमाल करके, Data Portability API को कॉल करना

इस क्विकस्टार्ट में, आपको अपने खाते के लिए OAuth टोकन मिलता है. साथ ही, Python स्क्रिप्ट का इस्तेमाल करके, Data Portable API एंडपॉइंट पर अनुरोध भेजे जाते हैं.

आपको क्या सीखने को मिलता है

इस क्विकस्टार्ट में, Python स्क्रिप्ट का इस्तेमाल करके ये काम किए जा सकते हैं:

• मान्य OAuth टोकन देकर, InitiatePortabilityArchive एंडपॉइंट पर पुष्टि किया गया अनुरोध भेजें. जवाब एक मान्य job_id है.
• GetPortabilityArchiveState एंडपॉइंट पर पुष्टि किया गया अनुरोध भेजें और डेटा डाउनलोड करें. जवाब में एक मान्य जॉब स्थिति होनी चाहिए और काम पूरा होने पर, एक हस्ताक्षर किया हुआ यूआरएल होना चाहिए.
• ResetAuthorization एंडपॉइंट पर पुष्टि किया गया अनुरोध भेजें. यह अनुरोध, उन सभी OAuth दायरों को निरस्त कर देता है जिन्हें उपयोगकर्ताओं ने अनुमति दी थी.

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

इस क्विकस्टार्ट को चलाने के लिए, आपको यह करना होगा:

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

इस क्विकस्टार्ट की सुविधा शुरू करने से पहले, आपको Python क्लाइंट लाइब्रेरी के लिए OAuth, Python, और OAuth पैकेज भी सेट अप करना होगा.

OAuth सेट अप करना

• इंस्टॉल किए गए ऐप्लिकेशन के लिए OAuth को कॉन्फ़िगर करने का तरीका अपनाएं. यह फ़्लो, वेब सर्वर ऐप्लिकेशन के OAuth फ़्लो की तरह ही है. अपना OAuth क्लाइंट आईडी कॉन्फ़िगर करते समय:
  • ऐप्लिकेशन का टाइप डेस्कटॉप ऐप्लिकेशन होना चाहिए.
  • क्लाइंट आईडी बनाने के बाद, क्लाइंट सीक्रेट को JSON फ़ॉर्मैट में डाउनलोड करें और फ़ाइल को नाम दें: client_secrets.json.
  • डेटा पोर्टेबिलिटी एपीआई के स्कोप कॉन्फ़िगर करते समय, ध्यान रखें कि यह क्विकस्टार्ट इन रिसॉर्स ग्रुप का इस्तेमाल करता है:
    • myactivity.search: https://www.googleapis.com/auth/dataportability.myactivity.search
    • myactivity.youtube: https://www.googleapis.com/auth/dataportability.myactivity.youtube

Python सेट अप करना

इस क्विकस्टार्ट में इस्तेमाल की जाने वाली स्क्रिप्ट चलाने के लिए, आपको अपनी लोकल मशीन पर Python सेट अप करना होगा. Python सेट अप करने के लिए:

• Pip पैकेज मैनेजमेंट टूल और Python 3.9 (या इसके बाद के वर्शन) को इंस्टॉल करें.
• Python के लिए Google API क्लाइंट लाइब्रेरी इंस्टॉल करें.

• इस कमांड को चलाकर, Python क्लाइंट लाइब्रेरी के लिए google_auth_oauthlib पैकेज इंस्टॉल करें. यह पैकेज google-auth के साथ oauthlib इंटिग्रेशन देता है, जो Python के लिए Google की पुष्टि करने की लाइब्रेरी है.

  pip install google-auth-oauthlib google-api-python-client --upgrade
  

स्क्रिप्ट चलाएं

यह स्क्रिप्ट, OAuth फ़्लो में localhost रीडायरेक्ट का इस्तेमाल करती है. इस विकल्प के लिए ज़रूरी है कि ऐप्लिकेशन, localhost पोर्ट को सुनें. इसके बाद, OAuth के ऑथराइज़ेशन फ़्लो को शुरू करने के लिए, सिस्टम ब्राउज़र खोलें.

स्क्रिप्ट खोलने के लिए इस लिंक पर क्लिक करें या लिंक पर राइट क्लिक करके स्क्रिप्ट की एक कॉपी डाउनलोड करें.

Data Portability API Python क्विकस्टार्ट स्क्रिप्ट

स्क्रिप्ट चलाने के लिए, यह आदेश डालें:

python3 data-portability-quickstart.py

स्क्रिप्ट से की गई कार्रवाइयों के बारे में टिप्पणियों में पूरी जानकारी दी जाती है.