Method: spreadsheets.batchUpdate

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

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

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

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

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

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

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