Method: presentations.batchUpdate

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

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

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

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

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

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

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 खराब अनुरोध की गड़बड़ी दिखाता है.

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