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,
  "commentsViewMode": enum (CommentsViewMode)
}
फ़ील्ड
requests[]

object (Request)

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

boolean

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

string

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

boolean

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

enum (CommentsViewMode)

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

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

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

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

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "spreadsheetId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "updatedSpreadsheet": {
    object (Spreadsheet)
  },
  "commentUpdateState": enum (CommentUpdateState)
}
फ़ील्ड
spreadsheetId

string

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

object (Response)

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

object (Spreadsheet)

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

enum (CommentUpdateState)

क्या बैच अनुरोध में टिप्पणी के अपडेट लागू किए गए थे.

अनुमति पाने के लिंक

इसके लिए, इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

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

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

CommentUpdateState

बैच अनुरोध में टिप्पणी के अपडेट की स्थिति.

Enums
COMMENT_UPDATE_STATE_UNSPECIFIED टिप्पणी के अपडेट का स्टेटस नहीं दिया गया है.
NO_UPDATES_REQUESTED बैच अनुरोध में, टिप्पणी से जुड़े किसी भी अपडेट का अनुरोध नहीं किया गया था.
ALL_SAVED टिप्पणी से जुड़े अपडेट के सभी अनुरोध, बैच अनुरोध में लागू कर दिए गए हैं.
ALL_FAILED_UNKNOWN_REASON टिप्पणी में किए गए सभी बदलावों को अपडेट नहीं किया जा सका.