Method: presentations.batchUpdate

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

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

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

उदाहरण के लिए, मान लें कि आपने चार अपडेट के साथ batchUpdate को कॉल किया है और सिर्फ़ तीसरा अपडेट जानकारी दिखाता है. जवाब में दो खाली जवाब होंगे: तीसरा अनुरोध का जवाब और दूसरा खाली जवाब.

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

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

POST https://slides.googleapis.com/v1/presentations/{presentationId}:batchUpdate

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

पाथ पैरामीटर

पैरामीटर
presentationId

string

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

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

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

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

object (Request)

प्रज़ेंटेशन में लागू किए जाने वाले अपडेट की सूची.
writeControl

object (WriteControl)

इससे यह कंट्रोल किया जाता है कि लिखने के अनुरोध कैसे पूरे किए जाते हैं.

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

बैच अपडेट से मिला जवाब.

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

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

string

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

object (Response)

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

object (WriteControl)

अनुरोध लागू करने के बाद, अपडेट किया गया राइट कंट्रोल.
commentUpdateState

enum (CommentUpdateState)

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

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

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

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

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

WriteControl

इससे यह कंट्रोल किया जाता है कि लिखने के अनुरोध कैसे पूरे किए जाते हैं.

JSON के काेड में दिखाना 
{
  "requiredRevisionId": string
}
फ़ील्ड
requiredRevisionId

string

लिखने के अनुरोध के लिए ज़रूरी प्रज़ेंटेशन का revision ID. अगर अनुरोध में revisionId शामिल किया गया है और यह प्रज़ेंटेशन के मौजूदा revisionId से मेल नहीं खाता है, तो अनुरोध को प्रोसेस नहीं किया जाता है. साथ ही, गड़बड़ी का मैसेज'400 bad request' दिखता है.

जब किसी जवाब में ज़रूरी बदलाव का आईडी मिलता है, तो इसका मतलब है कि अनुरोध लागू होने के बाद, दस्तावेज़ के बदलाव का आईडी.

CommentUpdateState

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

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