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 टिप्पणी में किए गए सभी बदलावों को अपडेट नहीं किया जा सका.