Google Sheets API की मदद से, सेल, रेंज,
और पूरी शीट का इस्तेमाल किया जा सकता है. इस पेज पर दिए गए उदाहरणों से पता चलता है कि कैसे
लिखने की सामान्य कार्रवाइयों को
spreadsheets.values
Sheets API का संसाधन.
ध्यान दें कि इनका इस्तेमाल करके सेल की वैल्यू भी लिखी जा सकती हैं
spreadsheet.batchUpdate
तरीका, जो तब काम आ सकता है, जब आपको सेल फ़ॉर्मैटिंग को एक साथ अपडेट करना हो
या अन्य प्रॉपर्टी
spreadsheets.values
संसाधन प्रभावित नहीं होता. उदाहरण के लिए, अगर आपको
सेल फ़ॉर्मूला और सेल, दोनों को ओवरराइट करते हुए एक शीट से दूसरी शीट पर जाएं
फ़ॉर्मैटिंग की है, तो आप
UpdateCellsRequest
तरीका चुनने के लिए
spreadsheet.batchUpdate
.
हालांकि, अगर लिखा जा सके, तो आसान वैल्यू लिखने के लिए
spreadsheets.values.update
तरीका या
spreadsheets.values.batchUpdate
तरीका.
ये उदाहरण, भाषा के तौर पर एचटीटीपी अनुरोधों के तौर पर दिखाए गए हैं न्यूट्रल. अलग-अलग भाषाओं में लिखने की सुविधा को लागू करने का तरीका जानने के लिए को Google API क्लाइंट लाइब्रेरी में डाउनलोड करने के लिए, पढ़ें और सेल लिखें वैल्यू.
इन उदाहरणों में, प्लेसहोल्डर SPREADSHEET_ID
से पता चलता है कि
जहां आप स्प्रेडशीट उपलब्ध कराएंगे
ID का इस्तेमाल करें. इसे यहां से खोजा जा सकता है:
स्प्रेडशीट का यूआरएल डालें. जिन रेंज पर लिखना है उन्हें A1 का इस्तेमाल करके तय किया गया है
नोटेशन. उदाहरण के लिए, रेंज Sheet1!A1:D5 है.
कोई एकल श्रेणी लिखें
एक नई, खाली स्प्रेडशीट से शुरू करते हुए, ये काम करें
spreadsheets.values.update
कोड सैंपल, किसी रेंज में वैल्यू लिखने का तरीका बताता है. कॉन्टेंट बनाने
ValueInputOption
क्वेरी
पैरामीटर होना ज़रूरी है और तय करता है कि लिखे गए मान पार्स किए गए हैं या नहीं (इसके लिए
उदाहरण के लिए, स्ट्रिंग को तारीख में बदला जाए या नहीं).
अनुरोध का मुख्य हिस्सा
ValueRange
वह ऑब्जेक्ट जो लिखने के लिए रेंज वैल्यू के बारे में बताता है. कॉन्टेंट बनाने
majorDimension
फ़ील्ड
इससे पता चलता है कि अरे, पंक्तियों के हिसाब से व्यवस्थित की गई वैल्यू की सूचियां हैं. मौजूदा वैल्यू
को ओवरराइट कर दिया जाता है.
अनुरोध का प्रोटोकॉल नीचे दिखाया गया है.
PUT https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
/values/Sheet1!A1:D5?valueInputOption=VALUE_INPUT_OPTION
{ "range": "Sheet1!A1:D5", "majorDimension": "ROWS", "values": [ ["Item", "Cost", "Stocked", "Ship Date"], ["Wheel", "$20.50", "4", "3/1/2016"], ["Door", "$15", "2", "3/15/2016"], ["Engine", "$100", "1", "3/20/2016"], ["Totals", "=SUM(B2:B4)", "=SUM(C2:C4)", "=MAX(D2:D4)"] ], }
इसके जवाब में
UpdateValuesResponse
ऑब्जेक्ट, जैसे कि यह:
{
"spreadsheetId": SPREADSHEET_ID
,
"updatedRange": "Sheet1!A1:D5",
"updatedRows": 5,
"updatedColumns": 4,
"updatedCells": 20,
}
इससे बनने वाली शीट कुछ ऐसी दिखती है:
A | B | C | D | |
1 | आइटम | लागत | स्टॉक में है | भेजने की तारीख |
2 | पहिया | 20.50 डॉलर | 4 | 1/3/2016 |
3 | दरवाज़ा | $15 | 2 | 15/3/2016 |
4 | इंजन | 100 डॉलर | 1 | 20/3/2016 |
5 | कुल | 135.5 डॉलर | 7 | 20/3/2016 |
किसी श्रेणी पर चयनात्मक रूप से लिखें
किसी रेंज में वैल्यू लिखते समय, कुछ मौजूदा वैल्यू को बदलने से बचा जा सकता है
सेल से जुड़े अरे एलिमेंट को null
पर सेट करके. यह भी संभव है
का इस्तेमाल करें.""
सबसे पहले एक शीट से शुरुआत करें. इसमें वही डेटा मौजूद है जो ऊपर दिए गए चार्ट में मौजूद है
उदाहरण के लिए, नीचे दी गई
spreadsheets.values.update
कोड सैंपल, B1:D4 रेंज में वैल्यू को लिखने का तरीका बताता है
कुछ सेल में कोई बदलाव नहीं करेंगे और बाकी सेल को मिटा रहे हैं. कॉन्टेंट बनाने
ValueInputOption
क्वेरी
पैरामीटर होना ज़रूरी है और तय करता है कि लिखे गए मान पार्स किए गए हैं या नहीं (इसके लिए
उदाहरण के लिए, स्ट्रिंग को तारीख में बदला जाए या नहीं).
अनुरोध का मुख्य हिस्सा
ValueRange
वह ऑब्जेक्ट जो लिखने के लिए रेंज वैल्यू के बारे में बताता है. कॉन्टेंट बनाने
majorDimension
फ़ील्ड
इससे पता चलता है कि अरे, कॉलम के हिसाब से व्यवस्थित की गई वैल्यू की सूचियां हैं.
अनुरोध का प्रोटोकॉल नीचे दिखाया गया है.
PUT https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
/values/Sheet1!B1?valueInputOption=VALUE_INPUT_OPTION
{ "range": "Sheet1!B1", "majorDimension": "COLUMNS", "values": [ [null,"$1","$2", ""], [], [null,"4/1/2016", "4/15/2016", ""] ] }
values
फ़ील्ड में, रेंज के हर कॉलम में किए गए बदलावों की सूची दी गई है. कॉन्टेंट बनाने
पहली अरे से पता चलता है कि null
कलेक्शन की वजह से, B1 में कोई बदलाव नहीं किया गया
तत्व है), जबकि B4 को साफ़ करना है (खाली स्ट्रिंग). B2 और B3 की अपनी वैल्यू है
अपडेट किया गया. तीसरा अरे कॉलम D पर यही कार्रवाई करता है. हालांकि, कॉलम D पर
दूसरी खाली अरे से पता चलता है कि कॉलम C में कोई बदलाव नहीं किया जाएगा.
इसके जवाब में
UpdateValuesResponse
इस तरह का एक ऑब्जेक्ट:
{
"spreadsheetId": SPREADSHEET_ID
,
"updatedRange": "Sheet1!B1:D5",
"updatedRows": 3,
"updatedColumns": 2,
"updatedCells": 6,
}
इससे बनने वाली शीट कुछ ऐसी दिखती है:
A | B | C | D | |
1 | आइटम | लागत | स्टॉक में है | भेजने की तारीख |
2 | पहिया | 1.00 डॉलर | 4 | 1/4/2016 |
3 | दरवाज़ा | INR90 | 2 | 15/4/2016 |
4 | इंजन | 1 | ||
5 | कुल | 3.00 डॉलर | 7 | 15/4/2016 |
ध्यान दें कि "कुल" पंक्ति में किए गए बदलाव को सीधे इस अनुरोध से बदला नहीं जाता है, लेकिन बदलाव इसलिए होता है, क्योंकि इसके सेल में बदले गए सेल पर आधारित फ़ॉर्मूले होते हैं.
एक से ज़्यादा रेंज में लिखें
खाली शीट से शुरू करते हुए, ये काम किए जा सकते हैं
spreadsheets.values.batchUpdate
कोड सैंपल में बताया गया है कि Sheets1!A1:A4 और रेंज में वैल्यू कैसे लिखें
Sheet1!B1:D2. टारगेट रेंज में मौजूद वैल्यू को ओवरराइट कर दिया जाता है. अनुरोध
शरीर में
ValueInputOption
ऑब्जेक्ट जो
इनपुट डेटा और
ValueRange
लिखी गई हर रेंज से जुड़े ऑब्जेक्ट होते हैं. कॉन्टेंट बनाने
majorDimension
फ़ील्ड
तय करता है कि शामिल की गई सरणियों को कॉलम या पंक्तियों के सरणियों के रूप में समझा जाए या नहीं.
अनुरोध का प्रोटोकॉल नीचे दिखाया गया है.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
/values:batchUpdate
{ "valueInputOption": "VALUE_INPUT_OPTION", "data": [ { "range": "Sheet1!A1:A4", "majorDimension": "COLUMNS", "values": [ ["Item", "Wheel", "Door", "Engine"] ] }, { "range": "Sheet1!B1:D2", "majorDimension": "ROWS", "values": [ ["Cost", "Stocked", "Ship Date"], ["$20.50", "4", "3/1/2016"] ] } ] }
रिस्पॉन्स में एक ऑब्जेक्ट शामिल होता है, जो अपडेट किए गए सेल के आंकड़ों की सूची बनाता है
और कलेक्शन में
UpdateValuesResponse
ऑब्जेक्ट हैं, तो हर अपडेट की गई रेंज के लिए एक ऑब्जेक्ट. उदाहरण के लिए:
{ "spreadsheetId":SPREADSHEET_ID
, "totalUpdatedRows": 4, "totalUpdatedColumns": 4, "totalUpdatedCells": 10, "totalUpdatedSheets": 1, "responses": [ { "spreadsheetId":SPREADSHEET_ID
, "updatedRange": "Sheet1!A1:A4", "updatedRows": 4, "updatedColumns": 1, "updatedCells": 4, }, { "spreadsheetId":SPREADSHEET_ID
, "updatedRange": "Sheet1!B1:D2", "updatedRows": 2, "updatedColumns": 3, "updatedCells": 6, } ], }
इससे बनने वाली शीट कुछ ऐसी दिखती है:
A | B | C | D | |
1 | आइटम | लागत | स्टॉक में है | भेजने की तारीख |
2 | पहिया | 20.50 डॉलर | 4 | 1/3/2016 |
3 | दरवाज़ा | |||
4 | इंजन | |||
5 |
पार्स किए बिना वैल्यू लिखें
खाली शीट से शुरू करते हुए, ये काम किए जा सकते हैं
spreadsheets.values.update
कोड सैंपल, Sheets1!A1:E1 रेंज में वैल्यू लिखने का तरीका दिखाता है, लेकिन यह
RAW
ValueInputOption
लिखित स्ट्रिंग को फ़ॉर्मूला के तौर पर पार्स होने से रोकने के लिए क्वेरी पैरामीटर,
बूलियन्स, या संख्याओं का इस्तेमाल करते हैं. ये स्ट्रिंग के तौर पर दिखते हैं और इनका टेक्स्ट अलाइनमेंट भी सही होता है
जोड़ें.
अनुरोध का मुख्य हिस्सा
ValueRange
वह ऑब्जेक्ट जो लिखने के लिए रेंज वैल्यू के बारे में बताता है. कॉन्टेंट बनाने
majorDimension
फ़ील्ड
इससे पता चलता है कि अरे, पंक्तियों के हिसाब से व्यवस्थित की गई वैल्यू की सूचियां हैं. मौजूदा वैल्यू
को ओवरराइट कर दिया जाता है.
अनुरोध का प्रोटोकॉल नीचे दिखाया गया है.
PUT https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
/values/Sheet1!A1:E1?valueInputOption=RAW
{ "range": "Sheet1!A1:E1", "majorDimension": "ROWS", "values": [ ["Data", 123.45, true, "=MAX(D2:D4)", "10"] ], }
इसके जवाब में
UpdateValuesResponse
इस तरह का एक ऑब्जेक्ट:
{
"spreadsheetId": SPREADSHEET_ID
,
"updatedRange": "Sheet1!A1:E1",
"updatedRows": 1,
"updatedColumns": 5,
"updatedCells": 5,
}
इससे बनने वाली शीट कुछ ऐसी दिखती है:
A | B | C | D | E | |
1 | Data | 123.45 | TRUE | =MAX(D2:D4) | 10 |
2 |
ध्यान दें कि "TRUE" के बीच में है और इसकी बूलियन वैल्यू है, जबकि "123.45" सही है सही है, क्योंकि यह एक संख्या है और "10" है को उचित ठहराया जाता है, क्योंकि यह स्ट्रिंग. फ़ॉर्मूला पार्स नहीं किया गया है, यह स्ट्रिंग के तौर पर भी दिखता है.
वैल्यू जोड़ें
नीचे दी गई टेबल जैसी शीट से शुरू करें:
A | B | C | D | |
1 | आइटम | लागत | स्टॉक में है | भेजने की तारीख |
2 | पहिया | 20.50 डॉलर | 4 | 1/3/2016 |
3 |
नीचे दिए गए
spreadsheets.values.append
कोड सैंपल में, पंक्ति 3 से शुरू होने वाली वैल्यू की दो नई पंक्तियां जोड़ने का तरीका बताया गया है. कॉन्टेंट बनाने
ValueInputOption
क्वेरी
पैरामीटर होना ज़रूरी है और तय करता है कि लिखे गए मान पार्स किए गए हैं या नहीं (इसके लिए
उदाहरण के लिए, स्ट्रिंग को तारीख में बदला जाए या नहीं).
अनुरोध का मुख्य हिस्सा
ValueRange
वह ऑब्जेक्ट जो लिखने के लिए रेंज वैल्यू के बारे में बताता है. कॉन्टेंट बनाने
majorDimension
फ़ील्ड
इससे पता चलता है कि अरे, पंक्तियों के हिसाब से व्यवस्थित की गई वैल्यू की सूचियां हैं.
अनुरोध का प्रोटोकॉल नीचे दिखाया गया है.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID
/values/Sheet1!A1:E1:append?valueInputOption=VALUE_INPUT_OPTION
{ "range": "Sheet1!A1:E1", "majorDimension": "ROWS", "values": [ ["Door", "$15", "2", "3/15/2016"], ["Engine", "$100", "1", "3/20/2016"], ], }
इसके जवाब में
AppendValuesResponse
इस तरह का एक ऑब्जेक्ट:
{ "spreadsheetId":SPREADSHEET_ID
, "tableRange": "Sheet1!A1:D2", "updates": { "spreadsheetId":SPREADSHEET_ID
, "updatedRange": "Sheet1!A3:D4", "updatedRows": 2, "updatedColumns": 4, "updatedCells": 8, } }
इससे बनने वाली शीट कुछ ऐसी दिखती है:
A | B | C | D | |
1 | आइटम | लागत | स्टॉक में है | भेजने की तारीख |
2 | पहिया | 20.50 डॉलर | 4 | 1/3/2016 |
3 | दरवाज़ा | $15 | 2 | 15/3/2016 |
4 | इंजन | 100 डॉलर | 1 | 20/3/2016 |
5 |