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

अगर ग्रिड डेटा दिया जाना चाहिए, तो सही है. इसका मतलब सिर्फ़ तब सही है, जब 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

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