इस गाइड में, 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 की अन्य सुविधाओं के साथ स्मार्ट चिप का इस्तेमाल करना
टेबल: स्मार्ट चिप का इस्तेमाल, टेबल कॉलम टाइप के तौर पर किया जा सकता है. इससे प्रोजेक्ट के मालिकों (लोगों की जानकारी वाला चिप) या उससे जुड़े दस्तावेज़ों (फ़ाइल की जानकारी वाला चिप) को ट्रैक किया जा सकता है.
फ़िल्टर: स्मार्ट चिप की टेक्स्ट वैल्यू के आधार पर, रेंज को फ़िल्टर किया जा सकता है.