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

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

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

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

यहां दिया गया presentations.create कोड का नमूना, "My New Presentation" नाम की खाली प्रज़ेंटेशन फ़ाइल बनाने का तरीका दिखाता है.

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

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

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 तरीके का इस्तेमाल करने का तरीका दिखाता है PRESENTATION_ID. प्रज़ेंटेशन आईडी की वैल्यू, प्रज़ेंटेशन के यूआरएल से देखी जा सकती है.

"Gizmo Corp." स्ट्रिंग के हर इंस्टेंस को "Gadget Inc." टेक्स्ट से बदल दिया जाता है. इसमें टेक्स्ट बॉक्स और अन्य शेप में मौजूद टेक्स्ट, स्लाइड पर मौजूद टेक्स्ट, और मास्टर में मौजूद टेक्स्ट शामिल है. इस उदाहरण में, टेक्स्ट को केस-सेंसिटिव तरीके से बदला जाता है matchCase को true पर सेट करके.

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

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