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" } } ] }