जब कोई उपयोगकर्ता Drive के यूज़र इंटरफ़ेस (यूआई) के "नया" बटन पर क्लिक करता है और Drive के यूज़र इंटरफ़ेस में कोई ऐप्लिकेशन चुनता है, तो Drive उसे उस ऐप्लिकेशन के नए यूआरएल पर रीडायरेक्ट करता है. यह यूआरएल, Drive के यूज़र इंटरफ़ेस के इंटिग्रेशन को कॉन्फ़िगर करना में बताया गया है.
इसके बाद, आपके ऐप्लिकेशन को state
पैरामीटर में, टेंप्लेट वैरिएबल का डिफ़ॉल्ट सेट मिलता है. नए यूआरएल के लिए, डिफ़ॉल्ट state
जानकारी यह है:
{
"action":"create",
"folderId":"FOLDER_ID",
"folderResourceKey":"FOLDER_RESOURCE_KEY",
"userId":"USER_ID"
}
इस आउटपुट में ये वैल्यू शामिल हैं:
create
: की जा रही कार्रवाई. जब कोई उपयोगकर्ता Drive के यूज़र इंटरफ़ेस के "नया" बटन पर क्लिक करता है, तो वैल्यूcreate
होती है.- FOLDER_ID: पैरंट फ़ोल्डर का आईडी.
- FOLDER_RESOURCE_KEY: पैरंट फ़ोल्डर की संसाधन कुंजी.
- USER_ID: प्रोफ़ाइल आईडी, जो उपयोगकर्ता की पहचान करता है.
आपके ऐप्लिकेशन को इस अनुरोध पर कार्रवाई करनी होगी. इसके लिए, यह तरीका अपनाएं:
- पुष्टि करें कि
action
फ़ील्ड की वैल्यूcreate
हो. - उपयोगकर्ता के लिए नया सेशन बनाने के लिए,
userId
वैल्यू का इस्तेमाल करें. साइन इन किए हुए उपयोगकर्ताओं के बारे में ज़्यादा जानकारी के लिए, उपयोगकर्ता और नए इवेंट देखें. - फ़ाइल रिसॉर्स बनाने के लिए,
files.create
का इस्तेमाल करें. अगर अनुरोध परfolderId
सेट किया गया था, तोparents
फ़ील्ड कोfolderId
वैल्यू पर सेट करें. - अगर अनुरोध पर
folderResourceKey
सेट किया गया था, तोX-Goog-Drive-Resource-Keys
अनुरोध हेडर सेट करें. रिसॉर्स पासकोड के बारे में ज़्यादा जानकारी के लिए, रिसॉर्स पासकोड का इस्तेमाल करके, लिंक की मदद से शेयर की गई फ़ाइलों को ऐक्सेस करना लेख पढ़ें.
state
पैरामीटर को यूआरएल से कोड में बदला गया है. इसलिए, आपके ऐप्लिकेशन को एस्केप वर्ण मैनेज करने होंगे और उसे JSON के तौर पर पार्स करना होगा.
उपयोगकर्ता और नए इवेंट
Drive ऐप्लिकेशन को सभी "बनाएं" इवेंट को संभावित साइन-इन के तौर पर लेना चाहिए. कुछ उपयोगकर्ताओं के पास एक से ज़्यादा खाते हो सकते हैं. इसलिए, हो सकता है कि state
पैरामीटर में मौजूद यूज़र आईडी, मौजूदा सेशन से मेल न खाए. अगर state
पैरामीटर में मौजूद User-ID, मौजूदा सेशन से मेल नहीं खाता है, तो अपने ऐप्लिकेशन के लिए मौजूदा सेशन को खत्म करें और अनुरोध किए गए उपयोगकर्ता के तौर पर साइन इन करें.