Method: presentations.batchUpdate

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

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

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

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

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

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

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

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

पाथ पैरामीटर

पैरामीटर में
presentationId

string

अपडेट लागू करने के लिए प्रज़ेंटेशन.

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

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

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

object (Request)

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

object (WriteControl)

यह नीति तय करती है कि अनुरोध कैसे लिखा जाएगा.

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

बैच में अपडेट करने के बाद मिला मैसेज.

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

जेएसओएन के काेड में दिखाना 
{
  "presentationId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
फ़ील्ड
presentationId

string

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

object (Response)

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

object (WriteControl)

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

अनुमति के दायरे

इनमें से किसी एक 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

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

राइट कंट्रोल

यह नीति तय करती है कि अनुरोध कैसे लिखा जाएगा.

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

string

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

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