स्मार्ट चिप

इस गाइड में, स्प्रेडशीट में स्मार्ट चिप जोड़ने और उन्हें मैनेज करने के लिए, 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: व्यक्ति का ईमेल पता.

इसका इस्तेमाल, रिच लिंक चिप बनाने के लिए करें. एपीआई, Google की अलग-अलग सेवाओं (जैसे, YouTube या Calendar) के लिंक को पढ़ सकता है. हालांकि, चिप के तौर पर सिर्फ़ 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 की अन्य सुविधाओं के साथ स्मार्ट चिप का इस्तेमाल करना

टेबल: स्मार्ट चिप का इस्तेमाल, टेबल कॉलम टाइप के तौर पर किया जा सकता है. इससे प्रोजेक्ट के मालिकों (लोगों की जानकारी देने वाला चिप) या उससे जुड़े दस्तावेज़ों (फ़ाइल चिप) को ट्रैक किया जा सकता है.

फ़िल्टर: रेंज को, उनमें मौजूद स्मार्ट चिप की टेक्स्ट वैल्यू के आधार पर फ़िल्टर किया जा सकता है.