जब कोई उपयोगकर्ता Drive के यूज़र इंटरफ़ेस (यूआई) का "नया" बटन पर क्लिक करता है और Drive के यूज़र इंटरफ़ेस (यूआई) में कोई ऐप्लिकेशन चुनता है, तो Drive उसे ऐप्लिकेशन के यूज़र इंटरफ़ेस (यूआई) में कॉन्फ़िगर करने से जुड़े ऐप्लिकेशन के नए यूआरएल पर रीडायरेक्ट कर देता है.
इसके बाद, आपके ऐप्लिकेशन को state
पैरामीटर में, टेंप्लेट वैरिएबल का डिफ़ॉल्ट सेट मिलता है. नए यूआरएल के लिए डिफ़ॉल्ट
state
जानकारी यह है:
{
"action":"create",
"folderId":"FOLDER_ID",
"folderResourceKey":"FOLDER_RESOURCE_KEY",
"userId":"USER_ID"
}
इस आउटपुट में ये वैल्यू शामिल होती हैं:
create
: की जा रही कार्रवाई. वैल्यू तबcreate
होती है, जब कोई उपयोगकर्ता Drive के यूज़र इंटरफ़ेस (यूआई) के "नया" बटन पर क्लिक करता है.- 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, मौजूदा सेशन से मेल नहीं खाता है, तो अपने ऐप्लिकेशन का मौजूदा सेशन खत्म करें और अनुरोध किए गए उपयोगकर्ता के तौर पर साइन इन करें.