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)
  }
}
फ़ील्ड
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

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

WriteControl

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

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

string

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

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