बेसिक फ़ॉर्मैटिंग

Google Sheets API से, स्प्रेडशीट में सेल और रेंज की फ़ॉर्मैटिंग को अपडेट किया जा सकता है. इस पेज पर दिए गए उदाहरणों में बताया गया है कि Sheets API की मदद से, फ़ॉर्मैट करने की कुछ सामान्य कार्रवाइयां कैसे की जा सकती हैं. शर्त के साथ फ़ॉर्मैटिंग की सुविधा देने वाले रेसिपी पेज पर, आपको शर्त के साथ फ़ॉर्मैटिंग के ज़्यादा उदाहरण मिल सकते हैं.

स्प्रेडशीट को अपडेट करते समय, कुछ तरह के अनुरोधों पर जवाब दिख सकते हैं. इन्हें कलेक्शन में दिखाया जाता है. हर रिस्पॉन्स में वही इंडेक्स होता है जो अनुरोध से जुड़ा होता है. कुछ अनुरोधों के जवाब नहीं दिए जाते और उनके लिए जवाब खाली होता है. इन उदाहरणों के रिस्पॉन्स का स्ट्रक्चर, spreadsheets.batchUpdate में देखा जा सकता है.

ये उदाहरण, न्यूट्रल भाषा में एचटीटीपी अनुरोधों के रूप में दिखाए जाते हैं. Google API क्लाइंट लाइब्रेरी का इस्तेमाल करके, बैच अपडेट को अलग-अलग भाषाओं में लागू करने का तरीका जानने के लिए, स्प्रेडशीट अपडेट करें देखें.

इन उदाहरणों में, SPREADSHEET_ID और SHEET_ID प्लेसहोल्डर से पता चलता है कि आपको आईडी कहां देने हैं. स्प्रेडशीट आईडी को स्प्रेडशीट के यूआरएल में देखा जा सकता है. spreadsheets.get तरीके का इस्तेमाल करके, शीट का आईडी पाया जा सकता है. रेंज को A1 नोटेशन का इस्तेमाल करके बताया जाता है. उदाहरण के लिए, Sheet1!A1:D5 रेंज है.

ऊपर दिए गए वीडियो में, स्प्रेडशीट सेल को फ़ॉर्मैट करने के तरीकों के बारे में बताया गया है. जैसे: फ़्रीज़ की गई पंक्तियां बनाना, सेल को बोल्ड करना, मुद्रा फ़ॉर्मैट लागू करना, सेल की पुष्टि करना, और सेल की वैल्यू को प्रतिबंधित करना.

सेल के बॉर्डर में बदलाव करें

यहां दिया गया spreadsheets.batchUpdate कोड सैंपल दिखाता है कि UpdateBordersRequest A1:F10 रेंज की हर सेल को डैश वाले, नीले रंग के, ऊपर और नीचे बॉर्डर में इस्तेमाल करने का तरीका क्या है. innerHorizontal फ़ील्ड, रेंज के अंदर हॉरिज़ॉन्टल बॉर्डर बनाता है. इस फ़ील्ड को खाली छोड़ने पर, बॉर्डर सिर्फ़ रेंज के ऊपर और नीचे वाले हिस्से में जोड़े जाएंगे.

तीन गुणा तीन टेबल, जिसके हर सेल में ऊपर और नीचे की ओर डैश वाला, नीले रंग का बॉर्डर और सबसे नीचे का बॉर्डर है.
पहली इमेज. शीट में हर सेल को डैश वाले, नीले रंग के टॉप और निचले बॉर्डर के साथ फ़ॉर्मैट करें.

अनुरोध का प्रोटोकॉल नीचे दिखाया गया है.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "updateBorders": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 6
        },
        "top": {
          "style": "DASHED",
          "width": 1,
          "color": {
            "blue": 1.0
          },
        },
        "bottom": {
          "style": "DASHED",
          "width": 1,
          "color": {
            "blue": 1.0
          },
        },
        "innerHorizontal": {
          "style": "DASHED",
          "width": 1,
          "color": {
            "blue": 1.0
          },
        },
      }
    }
  ]
}

हेडर लाइन को फ़ॉर्मैट करना

यहां दिया गया spreadsheets.batchUpdate कोड सैंपल में बताया गया है कि शीट में हेडर लाइन को फ़ॉर्मैट करने के लिए, RepeatCellRequest का इस्तेमाल कैसे किया जाता है. पहला अनुरोध, टेक्स्ट का रंग, बैकग्राउंड का रंग, टेक्स्ट के फ़ॉन्ट का साइज़, और टेक्स्ट की वजह अपडेट करता है. साथ ही, टेक्स्ट को बोल्ड करता है. range फ़ील्ड में कॉलम इंडेक्स न छोड़ने पर, पूरी लाइन फ़ॉर्मैट हो जाती है. दूसरा अनुरोध शीट की प्रॉपर्टी में बदलाव करता है, ताकि हेडर लाइन फ़्रीज़ हो जाए.

तीन गुणा तीन टेबल के साथ, शीट में हेडर वाली पंक्ति फ़ॉर्मैट की गई है.
दूसरी इमेज. शीट में हेडर लाइन को फ़ॉर्मैट करें.

अनुरोध का प्रोटोकॉल नीचे दिखाया गया है.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "repeatCell": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 1
        },
        "cell": {
          "userEnteredFormat": {
            "backgroundColor": {
              "red": 0.0,
              "green": 0.0,
              "blue": 0.0
            },
            "horizontalAlignment" : "CENTER",
            "textFormat": {
              "foregroundColor": {
                "red": 1.0,
                "green": 1.0,
                "blue": 1.0
              },
              "fontSize": 12,
              "bold": true
            }
          }
        },
        "fields": "userEnteredFormat(backgroundColor,textFormat,horizontalAlignment)"
      }
    },
    {
      "updateSheetProperties": {
        "properties": {
          "sheetId": SHEET_ID,
          "gridProperties": {
            "frozenRowCount": 1
          }
        },
        "fields": "gridProperties.frozenRowCount"
      }
    }
  ]
}

सेल मर्ज करें

यहां दिया गया spreadsheets.batchUpdate कोड सैंपल, सेल को मर्ज करने के लिए MergeCellsRequest को इस्तेमाल करने का तरीका बताता है. पहला अनुरोध, A1:B2 रेंज को एक सेल में मर्ज कर देता है. दूसरा अनुरोध, पंक्तियों को अलग करते हुए कॉलम को A3:B6 में मर्ज कर देता है.

3x3 टेबल, जिसमें शीट में मर्ज की गई सेल हैं.
तीसरी इमेज. शीट में कई सेल को मिलाकर एक सेल बनाना.

अनुरोध का प्रोटोकॉल नीचे दिखाया गया है.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "mergeCells": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 2,
          "startColumnIndex": 0,
          "endColumnIndex": 2
        },
        "mergeType": "MERGE_ALL"
      }
    },
    {
      "mergeCells": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 2,
          "endRowIndex": 6,
          "startColumnIndex": 0,
          "endColumnIndex": 2
        },
        "mergeType": "MERGE_COLUMNS"
      }
    },
  ]
}

किसी रेंज के लिए, तारीख और समय के लिए पसंद के मुताबिक फ़ॉर्मैट सेट करना

यहां दिए गए spreadsheets.batchUpdate कोड सैंपल में बताया गया है कि RepeatCellRequest सेल को इस्तेमाल करके, तारीख और संख्या को पसंद के मुताबिक फ़ॉर्मैट में कैसे अपडेट किया जाता है. पहला अनुरोध, A1:A10 रेंज में मौजूद सेल को तारीख और समय के कस्टम फ़ॉर्मैट hh:mm:ss am/pm, ddd mmm dd yyyy के हिसाब से देता है. इस फ़ॉर्मैट में तारीख और समय का एक उदाहरण यह है: "02:05:07 PM, रविवार 03 अप्रैल 2016".

दूसरा अनुरोध B1:B10 की सेल को संख्या का कस्टम फ़ॉर्मैट #,##0.0000 देता है. इससे पता चलता है कि संख्याओं को कॉमा सेपरेटर के साथ ग्रुप किया जाना चाहिए, दशमलव के बाद चार अंक होने चाहिए, और शुरुआत में एक शून्य को छोड़कर बाकी सभी को छोड़ देना चाहिए. उदाहरण के लिए, संख्या "3.14" को "3.1400", जबकि "12345.12345" को "12,345.1235" के तौर पर रेंडर किया गया है.

शीट में पसंद के मुताबिक तारीख और संख्या के फ़ॉर्मैट वाली तीन गुणा तीन टेबल.
चौथी इमेज. शीट में तारीख और संख्या के फ़ॉर्मैट को पसंद के मुताबिक बनाने के लिए, सेल अपडेट करें.

अनुरोध का प्रोटोकॉल नीचे दिखाया गया है.

POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
  "requests": [
    {
      "repeatCell": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 0,
          "endColumnIndex": 1
        },
        "cell": {
          "userEnteredFormat": {
            "numberFormat": {
              "type": "DATE",
              "pattern": "hh:mm:ss am/pm, ddd mmm dd yyyy"
            }
          }
        },
        "fields": "userEnteredFormat.numberFormat"
      }
    },
    {
      "repeatCell": {
        "range": {
          "sheetId": SHEET_ID,
          "startRowIndex": 0,
          "endRowIndex": 10,
          "startColumnIndex": 1,
          "endColumnIndex": 2
        },
        "cell": {
          "userEnteredFormat": {
            "numberFormat": {
              "type": "NUMBER",
              "pattern": "#,##0.0000"
            }
          }
        },
        "fields": "userEnteredFormat.numberFormat"
      }
    }
  ]
}