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