इस गाइड में बताया गया है कि अपनी स्प्रेडशीट में स्मार्ट चिप जोड़ने और उन्हें मैनेज करने के लिए, Google Sheets API का इस्तेमाल कैसे और क्यों करना चाहिए.
स्मार्ट चिप क्या है?
स्मार्ट चिप की मदद से, Google Workspace के अन्य ऐप्लिकेशन से सीधे Sheets में रिच और इंटरैक्टिव डेटा लाया जा सकता है. स्मार्ट चिप की मदद से, उपयोगकर्ताओं को जानकारी और कार्रवाइयों का तुरंत ऐक्सेस मिलता है. साथ ही, यह सेल लिंक को डाइनैमिक ऑब्जेक्ट में बदल देता है. ज़्यादा जानने के लिए, Google Sheets में स्मार्ट चिप डालना लेख पढ़ें.
स्मार्ट चिप जोड़ना
चिप को चिप रन के तौर पर दिखाया जाता है. ये CellData का हिस्सा होते हैं. इसलिए, UpdateCellsRequest या AppendCellsRequest डालकर, मौजूदा spreadsheets.batchUpdate तरीके का इस्तेमाल करके चिप डाला जा सकता है.
अनुरोध में chipRuns फ़ील्ड शामिल होना चाहिए. चिप रन से, चिप की प्रॉपर्टी और सेल के टेक्स्ट में उसकी जगह के बारे में पता चलता है.
chipRuns लिखते समय, आपको एक userEnteredValue भी देना होगा. इसमें हर उस चिप के लिए प्लेसहोल्डर वर्ण (@) शामिल होने चाहिए जिसे आपको जोड़ना है. chipRuns कलेक्शन में मौजूद हर रन, प्लेसहोल्डर में से किसी एक से जुड़ा होगा. डेटा को लिखने के दौरान, बिना चिप वाले रन को छोड़ा जा सकता है.
यहां दिए गए उदाहरण में, A1 सेल में फ़ाइल चिप, लोगों का चिप, और सादा टेक्स्ट लिखने का तरीका बताया गया है. * {JSON}
{
"updateCells": {
"rows": [
{
"values": [
{
"userEnteredValue": {
"stringValue": "@ is the owner of @."
},
"chipRuns": [
{
"chip": {
"personProperties": {
"email": "johndoe@gmail.com",
"displayFormat": "DEFAULT"
}
}
},
{
"startIndex": 18,
"chip": {
"richLinkProperties": {
"uri": "https://docs.google.com/document/d/YOUR_DOCUMENT_ID/edit"
}
}
}
]
}
]
}
],
"fields": "userEnteredValue,chipRuns",
"range": {
"startRowIndex": 0,
"startColumnIndex": 0
}
}
}
चिप प्रॉपर्टी कॉन्फ़िगर करना
चिप ऑब्जेक्ट में इनमें से कोई एक प्रॉपर्टी टाइप हो सकता है:
personProperties
किसी व्यक्ति का चिप बनाने के लिए, इसका इस्तेमाल करें.
email: (ज़रूरी है) उस व्यक्ति का ईमेल पता जिसे लिंक करना है.displayFormat: (ज़रूरी नहीं) व्यक्ति के नाम के लिए पसंदीदा डिसप्ले फ़ॉर्मैट. इनमें से कोई एक स्थिति हो सकती है:DEFAULT: स्टैंडर्ड "नाम सरनेम" फ़ॉर्मैट.LAST_NAME_COMMA_FIRST_NAME: "उपनाम, नाम" फ़ॉर्मैट.EMAIL: व्यक्ति का ईमेल पता.
richLinkProperties
रिच लिंक चिप बनाने के लिए इसका इस्तेमाल करें. एपीआई, YouTube या Calendar जैसी Google की अलग-अलग सेवाओं के लिंक पढ़ सकता है. हालांकि, सिर्फ़ Google Drive फ़ाइलों के लिंक को चिप के तौर पर लिखा जा सकता है.
uri: (ज़रूरी है) रिसोर्स का यूआरआई. लिखने के लिए, यह Google Drive फ़ाइल का लिंक होना चाहिए. यूआरआई 2,000 बाइट से ज़्यादा नहीं होने चाहिए.
स्मार्ट चिप को पढ़ना
स्मार्ट चिप का डेटा पढ़ने के लिए, spreadsheets.get तरीके का इस्तेमाल करें और फ़ील्ड पैरामीटर में sheets.data.rowData.values(chipRuns) शामिल करें.
रिस्पॉन्स में मौजूद chipRuns कलेक्शन में, सेल के टेक्स्ट के सभी सबसेक्शन के ऑब्जेक्ट शामिल होंगे.
- चिप किए गए रन: इन सेक्शन में, पॉप्युलेट किया गया
chipऑब्जेक्ट होगा, जिसमेंpersonPropertiesयाrichLinkPropertiesशामिल होगा. - बिना चिप वाले रन: सादे टेक्स्ट सेक्शन में भी एक रन ऑब्जेक्ट होगा, लेकिन उसका
chipफ़ील्ड खाली होगा.
किसी चिप का डिसप्ले टेक्स्ट पाने के लिए, formattedValue को फ़ील्ड के तौर पर जोड़ें.
स्मार्ट चिप अपडेट करना
स्मार्ट चिप को अपडेट करने या बदलने के लिए, आपको सेल के कॉन्टेंट को ओवरराइट करना होगा. चिप जोड़ने के लिए इस्तेमाल किए गए UpdateCellsRequest या AppendCellsRequest का ही इस्तेमाल करें. साथ ही, नई userEnteredValue और chipRun वैल्यू दें. इससे सेल में मौजूद मौजूदा चिप बदल जाएगा.
Sheets की अन्य सुविधाओं के साथ स्मार्ट चिप का इस्तेमाल करना
टेबल: स्मार्ट चिप का इस्तेमाल, टेबल कॉलम के टाइप के तौर पर किया जा सकता है. इससे प्रोजेक्ट के मालिकों (लोगों के बारे में जानकारी देने वाले चिप) या उससे जुड़े दस्तावेज़ों (फ़ाइल के बारे में जानकारी देने वाले चिप) को ट्रैक किया जा सकता है.
फ़िल्टर: रेंज में मौजूद स्मार्ट चिप की टेक्स्ट वैल्यू के आधार पर, रेंज को फ़िल्टर किया जा सकता है.