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

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 में कॉलम को मर्ज करता है.

तीसरी इमेज. शीट में कई सेल मर्ज करें.

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

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 बजे, रविवार अप्रैल 03 2016" पर दिखाया जाएगा.

दूसरा अनुरोध B1:B10 की सेल को कस्टम नंबर फ़ॉर्मैट देता है #,##0.0000, जिससे यह पता चलता है कि संख्याओं को कॉमा के साथ ग्रुप किया जाना चाहिए सेपरेटर, जिसमें दशमलव के बाद 4 अंक होने चाहिए और एक लीडिंग शून्य छोड़ देना चाहिए. उदाहरण के लिए, संख्या "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"
      }
    }
  ]
}