प्रज़ेंटेशन की कार्रवाइयां

Google Slides API से प्रज़ेंटेशन की फ़ाइलें बनाई जा सकती हैं और मौजूदा फ़ाइलों को मैनेज किया जा सकता है. इस पेज पर दिए गए उदाहरणों में, presentations.batchUpdate तरीके का इस्तेमाल करके, पेज दिखाने से जुड़ी कुछ सामान्य कार्रवाइयां दिखाई गई हैं.

इन उदाहरणों को एचटीटीपी अनुरोधों के तौर पर दिखाया जाता है. ऐसा इसलिए किया जाता है, ताकि किसी एक भाषा का इस्तेमाल न किया जा सके. Google API क्लाइंट लाइब्रेरी का इस्तेमाल करके, अलग-अलग भाषाओं में बैच अपडेट लागू करने का तरीका जानने के लिए, ये गाइड पढ़ें:

प्रज़ेंटेशन बनाना

नीचे दिया गया presentations.create कोड सैंपल दिखाता है कि "मेरा नया प्रज़ेंटेशन" नाम से एक खाली प्रज़ेंटेशन फ़ाइल कैसे बनाई जाती है.

Google Drive API files.create तरीके का इस्तेमाल करके, खाली प्रज़ेंटेशन फ़ाइलें भी बनाई जा सकती हैं. इसके लिए, application/vnd.google-apps.presentation को MIME टाइप के तौर पर इस्तेमाल करें.

प्रज़ेंटेशन बनाने के लिए, अनुरोध का प्रोटोकॉल नीचे दिया गया है:

POST https://slides.googleapis.com/v1/presentations
{
  "title": "My New Presentation"
}

मौजूदा प्रज़ेंटेशन फ़ाइलों की सूची बनाएं

Slides API, प्रज़ेंटेशन की सूची वापस पाने का कोई तरीका नहीं देता, लेकिन Drive API ऐसा करता है. files.list तरीके (यहां बताया गया है) में, फ़ील्ड मास्क का इस्तेमाल किया जाता है. इससे Drive में मौजूद प्रज़ेंटेशन फ़ाइलों की सूची देखी जा सकती है. इस सूची में फ़ाइल आईडी, फ़ाइल का नाम, और फ़ाइल खोलने का लिंक शामिल होता है. अनुरोध में, application/vnd.google-apps.presentation को MIME टाइप के तौर पर बताया गया है.

मौजूदा प्रज़ेंटेशन फ़ाइलों की सूची बनाने के लिए, अनुरोध प्रोटोकॉल नीचे दिया गया है:

GET https://www.googleapis.com/drive/v3/files?q="mimeType=application/vnd.google-apps.presentation"&fields=files(id,name,webViewLink)

इस अनुरोध के रिस्पॉन्स का स्ट्रक्चर यहां बताया गया है:

{
 "files": [
    {
     "id": "abcdefghijklmnopqrstuvwxyz0123456789",
     "name": "Project Vision",
     "webViewLink": "https://docs.google.com/a/google.com/presentation/d/abcdefghijklmnopqrstuvwxyz0123456789/edit?usp=drivesdk"
    },
    {
     "id": "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789",
     "name": "Untitled Presentation",
     "webViewLink": "https://docs.google.com/a/google.com/presentation/d/ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789/edit?usp=drivesdk"
    },
    ...
  ]
}

पूरे प्रज़ेंटेशन में टेक्स्ट बदलना

यहां दिया गया presentations.batchUpdate कोड सैंपल में बताया गया है कि PRESENTATION_ID के बताए गए, पूरे प्रज़ेंटेशन के दौरान टेक्स्ट बदलने के लिए, ReplaceAllTextRequest तरीके का इस्तेमाल कैसे किया जाता है. प्रज़ेंटेशन यूआरएल से प्रज़ेंटेशन आईडी की वैल्यू देखी जा सकती है.

स्ट्रिंग "Gizmo Corp." के हर इंस्टेंस को "गैजेट Inc" टेक्स्ट से बदल दिया जाता है. इसमें टेक्स्ट बॉक्स और दूसरे आकारों, स्लाइड पर और मास्टर में मौजूद टेक्स्ट शामिल हैं. इस मामले में, टेक्स्ट बदलने की स्थिति केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होती है. इसके लिए, matchCase को true पर सेट करें.

पूरे प्रज़ेंटेशन में टेक्स्ट को बदलने के लिए, अनुरोध प्रोटोकॉल यहां दिया गया है:

POST https://slides.googleapis.com/v1/presentations/PRESENTATION_ID:batchUpdate
{
  "requests": [
    {
      "replaceAllText": {
          "containsText": {
            "text": "Gizmo Corp.",
            "matchCase": true
          },
          "replaceText": "Gadget Inc."
      }
    }
  ]
}