Google Sheets API की मदद से, स्प्रेडशीट में सेल और रेंज का फ़ॉर्मैट अपडेट किया जा सकता है. इस पेज पर दिए गए उदाहरण बताते हैं कि Sheets API की मदद से, फ़ॉर्मैटिंग से जुड़ी कुछ कार्रवाइयां कैसे की जा सकती हैं. कंडिशनल फ़ॉर्मैटिंग के रेसिपी पेज पर, आपको शर्त के हिसाब से फ़ॉर्मैट करने के और उदाहरण मिल सकते हैं.
स्प्रेडशीट अपडेट करते समय, कुछ तरह के अनुरोधों के जवाब मिल सकते हैं.
ये एक कलेक्शन में दिखाए जाते हैं. साथ ही, हर रिस्पॉन्स उसी इंडेक्स में दिखता है जिसमें उसका अनुरोध दिखता है. कुछ अनुरोधों के जवाब नहीं मिलते और उनके लिए कोई जवाब नहीं दिया जाता. इन उदाहरणों के लिए रिस्पॉन्स का स्ट्रक्चर, spreadsheets.batchUpdate में देखा जा सकता है.
ये उदाहरण भाषा न्यूट्रल होने के लिए एचटीटीपी अनुरोधों के तौर पर दिखाए गए हैं. Google API क्लाइंट लाइब्रेरी का इस्तेमाल करके, बैच अपडेट को अलग-अलग भाषाओं में लागू करने का तरीका जानने के लिए, स्प्रेडशीट अपडेट करें देखें.
इन उदाहरणों में, प्लेसहोल्डर SPREADSHEET_ID और SHEET_ID से पता चलता है कि आपको ये आईडी कहां देने हैं. स्प्रेडशीट के यूआरएल में, स्प्रेडशीट का आईडी देखा जा सकता है. spreadsheets.get तरीके का इस्तेमाल करके, शीट आईडी पाया जा सकता है. रेंज की जानकारी, A1 नोटेशन का इस्तेमाल करके दी जाती है. रेंज का उदाहरण, Sheet1!A1:D5 है.
ऊपर दिए गए वीडियो में, स्प्रेडशीट सेल को फ़ॉर्मैट करने के अलग-अलग तरीके बताए गए हैं. जैसे: फ़्रीज़ की गई पंक्तियां बनाना, सेल को बोल्ड करना, मुद्रा फ़ॉर्मैट करना, सेल की पुष्टि करना, और सेल की वैल्यू सीमित करना.
सेल के बॉर्डर में बदलाव करें
यहां दिए गए spreadsheets.batchUpdate कोड सैंपल में, A1:F10 रेंज की हर सेल के ऊपर और नीचे, डैश वाला नीला बॉर्डर देने के लिए, UpdateBordersRequest का इस्तेमाल करने का तरीका बताया गया है. 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 PM, Sun Apr
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" } } ] }