Method: spreadsheets.batchUpdate

स्प्रेडशीट पर एक या एक से ज़्यादा अपडेट लागू करता है.

लागू होने से पहले, हर request की पुष्टि हो जाती है. अगर कोई अनुरोध मान्य नहीं है, तो पूरा अनुरोध स्वीकार नहीं किया जाएगा और कुछ भी लागू नहीं होगा.

कुछ अनुरोधों में, replies को लागू करने के तरीके के बारे में कुछ जानकारी दी जाती है. जवाब, अनुरोधों को शेयर करेंगे. उदाहरण के लिए, अगर आपने चार अपडेट लागू किए हैं और तीसरे अपडेट के साथ एक जवाब आया है, तो जवाब में दो खाली जवाब होंगे, असल जवाब होगा, और दूसरा खाली जवाब उसी क्रम में होगा.

स्प्रेडशीट में साथ मिलकर काम करने की वजह से, यह गारंटी नहीं है कि स्प्रेडशीट पूरी होने के बाद आपके बदलाव पूरी तरह दिखाएगी. हालांकि, यह गारंटी है कि अनुरोध में किए गए अपडेट अपने-आप लागू हो जाएंगे. सहयोगी बदलावों के संबंध में आपके परिवर्तन बदले जा सकते हैं. अगर कोई सहयोगी मौजूद नहीं है, तो स्प्रेडशीट में आपके बदलाव दिखने चाहिए.

एचटीटीपी अनुरोध

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate

यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
spreadsheetId

string

वह स्प्रेडशीट जिस पर अपडेट लागू करने हैं.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, नीचे दिए गए स्ट्रक्चर का डेटा शामिल है:

जेएसओएन के काेड में दिखाना 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "includeSpreadsheetInResponse": boolean,
  "responseRanges": [
    string
  ],
  "responseIncludeGridData": boolean
}
फ़ील्ड
requests[]

object (Request)

स्प्रेडशीट पर लागू होने वाले अपडेट की सूची. अनुरोध उसी क्रम में लागू किए जाएंगे जिस क्रम में उन्हें बताया गया है. अगर कोई अनुरोध मान्य नहीं है, तो कोई अनुरोध लागू नहीं किया जाएगा.
includeSpreadsheetInResponse

boolean

इससे तय होता है कि अपडेट के रिस्पॉन्स में स्प्रेडशीट संसाधन शामिल होना चाहिए या नहीं.
responseRanges[]

string

जवाब वाली स्प्रेडशीट में शामिल रेंज सीमित हैं. इसका मतलब सिर्फ़ तब है, जब includeSpreadsheetInResponse 'सही' हो.
responseIncludeGridData

boolean

अगर ग्रिड डेटा दिया जाना चाहिए, तो सही है. इसका मतलब सिर्फ़ तब है, जब includeSpreadsheetInResponse 'सही' हो. अगर अनुरोध में फ़ील्ड मास्क सेट किया गया था, तो इस पैरामीटर को अनदेखा कर दिया जाता है.

जवाब का मुख्य भाग

एक स्प्रेडशीट को अपडेट करने वाले बैच का जवाब.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना 
{
  "spreadsheetId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "updatedSpreadsheet": {
    object (Spreadsheet)
  }
}
फ़ील्ड
spreadsheetId

string

वह स्प्रेडशीट जिस पर अपडेट लागू किए गए थे.
replies[]

object (Response)

अपडेट का जवाब. यह अपडेट के साथ 1:1 मैप करता है, हालांकि कुछ अनुरोधों के जवाब खाली हो सकते हैं.
updatedSpreadsheet

object (Spreadsheet)

अपडेट लागू होने के बाद स्प्रेडशीट. यह सिर्फ़ तब सेट होता है, जब BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response की वैल्यू true हो.

अनुमति के दायरे

इनमें से किसी एक OAuth दायरे की ज़रूरत होती है:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets

ज़्यादा जानकारी के लिए, अनुमति देने के लिए गाइड देखें.