जब कोई उपयोगकर्ता 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 के तौर पर पार्स करना होगा.
उपयोगकर्ता और नए इवेंट
डिस्क ऐप्लिकेशन को सभी "create" इवेंट को संभावित साइन-इन के तौर पर देखना चाहिए. कुछ उपयोगकर्ताओं के पास एक से ज़्यादा खाते हो सकते हैं, इसलिए हो सकता है कि state
पैरामीटर में मौजूद यूज़र आईडी, मौजूदा सेशन से मेल न खाए. अगर state
पैरामीटर में मौजूद यूज़र आईडी मौजूदा सेशन से मेल नहीं खाता है, तो अपने ऐप्लिकेशन का मौजूदा सेशन खत्म करें और अनुरोध किए गए उपयोगकर्ता के तौर पर साइन इन करें.