Method: spreadsheets.batchUpdate

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

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

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

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

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

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

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

पाथ पैरामीटर

पैरामीटर
spreadsheetId

string

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

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

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

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

object (Request)

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

includeSpreadsheetInResponse

boolean

इससे यह तय होता है कि अपडेट के जवाब में स्प्रेडशीट रिसॉर्स शामिल करना चाहिए या नहीं.

responseRanges[]

string

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

responseIncludeGridData

boolean

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

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

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

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

JSON के काेड में दिखाना
{
  "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

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