- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- अनुरोध करें
- UpdateSpreadsheetPropertiesRequest
- UpdateSheetPropertiesRequest
- UpdateDimensionPropertiesRequest
- DataSourceSheetDimensionRange
- UpdateNamedRangeRequest
- RepeatCellRequest
- AddNamedRangeRequest
- DeleteNamedRangeRequest
- AddSheetRequest
- DeleteSheetRequest
- AutoFillRequest
- SourceAndDestination
- CutPasteRequest
- PasteType
- CopyPasteRequest
- PasteOrientation
- MergeCellsRequest
- MergeType
- UnmergeCellsRequest
- UpdateBordersRequest
- UpdateCellsRequest
- AddFilterViewRequest
- AppendCellsRequest
- ClearBasicFilterRequest
- DeleteDimensionRequest
- DeleteEmbeddedObjectRequest
- DeleteFilterViewRequest
- DuplicateFilterViewRequest
- DuplicateSheetRequest
- FindReplaceRequest
- InsertDimensionRequest
- InsertRangeRequest
- MoveDimensionRequest
- UpdateEmbeddedObjectPositionRequest
- PasteDataRequest
- TextToColumnsRequest
- DelimiterType
- UpdateFilterViewRequest
- DeleteRangeRequest
- AppendDimensionRequest
- AddConditionalFormatRuleRequest
- UpdateConditionalFormatRuleRequest
- DeleteConditionalFormatRuleRequest
- SortRangeRequest
- SetDataValidationRequest
- SetBasicFilterRequest
- AddProtectedRangeRequest
- UpdateProtectedRangeRequest
- DeleteProtectedRangeRequest
- AutoResizeDimensionsRequest
- AddChartRequest
- UpdateChartSpecRequest
- UpdateBandingRequest
- AddBandingRequest
- DeleteBandingRequest
- CreateDeveloperMetadataRequest
- UpdateDeveloperMetadataRequest
- DeleteDeveloperMetadataRequest
- RandomizeRangeRequest
- AddDimensionGroupRequest
- DeleteDimensionGroupRequest
- UpdateDimensionGroupRequest
- TrimWhitespaceRequest
- DeleteDuplicatesRequest
- UpdateEmbeddedObjectBorderRequest
- AddSlicerRequest
- UpdateSlicerSpecRequest
- AddDataSourceRequest
- UpdateDataSourceRequest
- DeleteDataSourceRequest
- RefreshDataSourceRequest
- DataSourceObjectReferences
- DataSourceObjectReference
- CancelDataSourceRefreshRequest
- जवाब
- AddNamedRangeResponse
- AddSheetResponse
- AddFilterViewResponse
- DuplicateFilterViewResponse
- DuplicateSheetResponse
- FindReplaceResponse
- UpdateEmbeddedObjectPositionResponse
- UpdateConditionalFormatRuleResponse
- DeleteConditionalFormatRuleResponse
- AddProtectedRangeResponse
- AddChartResponse
- AddBandingResponse
- CreateDeveloperMetadataResponse
- UpdateDeveloperMetadataResponse
- DeleteDeveloperMetadataResponse
- AddDimensionGroupResponse
- DeleteDimensionGroupResponse
- TrimWhitespaceResponse
- DeleteDuplicatesResponse
- AddSlicerResponse
- AddDataSourceResponse
- UpdateDataSourceResponse
- RefreshDataSourceResponse
- RefreshDataSourceObjectExecutionStatus
- CancelDataSourceRefreshResponse
- CancelDataSourceRefreshStatus
- RefreshCancellationStatus
- RefreshCancellationState
- RefreshCancellationErrorCode
- इसे आज़माएं!
स्प्रेडशीट में एक या उससे ज़्यादा अपडेट लागू होते हैं.
हर request
को लागू करने से पहले उसकी पुष्टि की जाती है. अगर कोई अनुरोध मान्य नहीं है, तो पूरा अनुरोध स्वीकार नहीं किया जाएगा और कुछ भी लागू नहीं किया जाएगा.
कुछ अनुरोधों में replies
होते हैं, ताकि वे आपको लागू किए जाने वाले तरीकों के बारे में कुछ जानकारी दे सकें. जवाब, अनुरोधों की डुप्लीकेट कॉपी बन जाएंगे. उदाहरण के लिए, अगर आपने चार अपडेट लागू किए और तीसरे अपडेट में जवाब दिया गया है, तो इस जवाब में दो खाली जवाब, असली जवाब और एक और खाली जवाब होगा.
स्प्रेडशीट के साथ मिलकर काम करने की वजह से, इसकी कोई गारंटी नहीं है कि इसके पूरा होने के बाद स्प्रेडशीट में आपके बदलाव पूरी तरह से दिखेंगे. हालांकि, इस बात की गारंटी है कि अनुरोध में किए गए अपडेट एक साथ लागू हो जाएंगे. आपके बदलावों को सहयोगी के बदलावों के हिसाब से बदला जा सकता है. अगर कोई सहयोगी मौजूद नहीं है, तो स्प्रेडशीट में किए गए बदलाव दिखने चाहिए.
एचटीटीपी अनुरोध
POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
spreadsheetId |
वह स्प्रेडशीट जिस पर अपडेट लागू करने हैं. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:
JSON के काेड में दिखाना |
---|
{
"requests": [
{
object ( |
फ़ील्ड | |
---|---|
requests[] |
स्प्रेडशीट पर लागू करने के लिए अपडेट की सूची. अनुरोध उनके बताए गए क्रम में लागू किए जाएंगे. अगर कोई अनुरोध मान्य नहीं है, तो कोई अनुरोध लागू नहीं किया जाएगा. |
includeSpreadsheetInResponse |
इससे तय होता है कि अपडेट के रिस्पॉन्स में स्प्रेडशीट संसाधन शामिल होना चाहिए या नहीं. |
responseRanges[] |
जवाब वाली स्प्रेडशीट में शामिल रेंज को सीमित करता है. इसका मतलब सिर्फ़ तब सही है, जब |
responseIncludeGridData |
अगर ग्रिड डेटा दिया जाना चाहिए, तो सही है. इसका मतलब सिर्फ़ तब सही है, जब |
जवाब का मुख्य भाग
स्प्रेडशीट को एक साथ अपडेट करने के लिए भेजा गया जवाब.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
JSON के काेड में दिखाना |
---|
{ "spreadsheetId": string, "replies": [ { object ( |
फ़ील्ड | |
---|---|
spreadsheetId |
वह स्प्रेडशीट जिस पर अपडेट लागू किए गए थे. |
replies[] |
अपडेट का जवाब. यह अपडेट के साथ 1:1 मैप करता है, हालांकि कुछ अनुरोधों के जवाब खाली हो सकते हैं. |
updatedSpreadsheet |
अपडेट लागू होने के बाद की स्प्रेडशीट. यह सिर्फ़ तब सेट होता है, जब |
अनुमति के दायरे
इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/spreadsheets
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.