सामान्य लेखन

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